言語 ▼
さらに見る ▼

ユニバーサルリンク

ユニバーサルリンクは、iOSバージョン9以降で利用できるディープリンクのための仕組みです。

ここでは、ユニバーサルリンクを使用してキャンペーンを設定し、テストし、計測する方法について説明します。

事前準備

事前準備として、以下の内容をご確認ください。

要件​

参考​

  • ユニバーサルリンクは、以前のiOSバージョンや他のモバイルプラットフォームで使用されるカスタムURLスキームとは異なる方法で作成されます。
  • Rawユニバーサルリンクとは、パラメーター、アプリ内パス、キーと値のペアのどれも追加されていないユニバーサルリンクのことです。Adjust管理画面で生成されます。
  • Rawユニバーサルリンクを検索または作成するには、管理画面の その他の設定 (All Settings) > プラットフォーム (Platforms) > iOS > ユニバーサルリンク (Universal Linking)​ から以下の手順に従ってください。

ユニバーサルリンクの設定手順

Adjust管理画面でユニバーサルリンクを有効にする

  1. アプリに移動して、アプリオプションの(▲) ボタンをクリックします。
  2. その他の設定（All Settings）​ >（設定（SETTINGS）） プラットフォーム（Platforms）​ を選択します。
  3. （AppleのApp Storeによって指定された）アプリの iOS BUNDLE ID​ を入力します。
  4. ユニバーサルリンク（Universal Linking）​ を選択します。
  5. Apple Developer Account Summaryに記載された APP PREFIX​ と、アプリ開発者が決定した APP SCHEME​ を入力します。
  6. 全てのフィールドに入力すると、Rawユニバーサルリンクが表示されます。例：http://z9pm.adj.st
  7. 保存(SAVE)​ を選択します。

このRawユニバーサルリンクをアプリ開発者に渡し、実装プロセスを続行してください。

アプリに移動して、アプリオプションの(▲) ボタンをクリックします。

1/7

アプリにユニバーサルリンクのサポートを追加する

アプリ内でアプリ固有のサブドメインをホワイトリストに指定するには、Rawユニバーサルリンクをアプリ開発者に送信します。アプリ開発者は、AdjustのGitHubにある開発者ガイド、またはAppleの開発者向けドキュメントで詳細を確認してください。

iOSのディープリンクを使用してキャンペーンを計測する

以下を使用して、ユーザーをiOSアプリにディープリンクできます。

  • ユニバーサルリンク
  • Javascriptユニバーサルリンク
  • AdjustトラッカーURLとdeep_linkパラメーター

トラッカーURLとdeep_linkパラメーターを使用したディープリンクをiOS 9以降のキャンペーンで使用するには、Adjust管理画面とXcodeプロジェクトでユニバーサルリンクが設定されていることを確認してください。設定されていれば、Adjustでトラッカーをユニバーサルリンクに変換し、デバイスに送信してアプリを開くことができます。

最も優れた連携方法は、ユーザーに広告が表示される、ご利用の広告環境をサポートすることです。

展開するキャンペーンに最も適した設定については、次の表を参照してください。

広告環境推奨する設定

Chromeブラウザー

ユニバーサルリンク トラッカー + deep_linkパラメーター

Safariブラウザーユニバーサルリンク トラッカー + deep_linkパラメーター
Facebookニュースフィードユニバーサルリンク Javascriptユニバーサルリンク トラッカー + deep_linkパラメーター

注：パスの追加が必要
Facebookブラウザーユニバーサルリンク
Javascriptユニバーサルリンク トラッカー + deep_linkパラメーター

Facebook Messenger

ユニバーサルリンク Javascriptユニバーサルリンク トラッカー + deep_linkパラメーター

注：パスの追加が必要

Facebook Messengerブラウザーユニバーサルリンク
Javascriptユニバーサルリンク（パスを追加）
トラッカー + deep_linkパラメーター（パスを追加）
Instagramトラッカー + deep_linkパラメーター

注：アプリでユニバーサルリンクの実装が必要

Gmail

Universal Link

Apple Mail

ユニバーサルリンク トラッカー + deep_linkパラメーター

Slack

Universal Link

WhatsApp

ユニバーサルリンク トラッカー + deep_linkパラメーター

Snapchatメッセージ

ユニバーサルリンク Javascriptユニバーサルリンク トラッカー + deep_linkパラメーター

注：jsフラグの追加が必要

SFSafariViewControllerとのディープリンク

ユニバーサルリンク Javascriptユニバーサルリンク

注：js flagの追加が必要

警告:
ユニバーサルリンクは、Pinterest、Telegram、Twitter、およびWeChatのアプリ環境ではサポートされていません。

ユニバーサルリンクを作成する

Adjustトラッカーが追加されたRawユニバーサルリンクは、ここで扱うユニバーサルリンクの標準形式です。リンクは短縮URLで、Webキャンペーンで機能します。

トラッカーが追加されていないRawユニバーサルリンクは、アプリを既にインストールしているiOS 9以降のユーザーにしか機能しません。

重要:
iOSで、Safariの外部ではユニバーサルリンクへのリダイレクトが許可されていません。つまり、ユニバーサルリンクを別のURLにラップしても機能しません。ユニバーサルリンクをラップする場合は、JSRソリューションを使用してください。

ディープリンクジェネレーター

ユニバーサルリンクを設定するには、ディープリンクジェネレーターをご使用ください。設定時間が短縮され、エラーを回避できます。

Adjust管理画面から メニュー (Menu) >ディープリンクジェネレーター (Deeplink Generator)​ を選択すると、ディープリンクジェネレーターにアクセスできます。

手動設定

ユニバーサルリンクをマニュアル設定するには、以下の手順に従ってください。

アプリに移動して、アプリのオプションボタン（▲）をクリックします。

1/12

Adjust管理画面にて

  1. 該当アプリの下部に表示されている（▲）ボタンを選択します。
  2. その他の設定（All Settings）​ >（設定） プラットフォーム（Platforms）​ > ユニバーサルリンク（Universal Linking）​ を選択します。
  3. Rawユニバーサルリンク（Raw Universal Link）​ をコピーします。
  4. 使用するトラッカーURLを見つけるか、作成します。
  5. トラッカートークンをコピーします。

任意のテキストエディターにて

  1. Rawユニバーサルリンクにhttps://を追加します。

    https://z9pm.adj.st/

  2. ?を追加し、adjust_tパラメーターを使用してURLにトラッカートークンを追加します。

    https://z9pm.adj.st/?adjust_t=abc123

  3. アプリ内のパスが必要な場合は追加します。

    https://z9pm.adj.st/my/path?adjust_t=abc123

  4. その他Adjustパラメーターが必要な場合は追加します。

    https://z9pm.adj.st/my/path?adjust_t=abc123&adjust_campaign=Getaway_Vacation_Campaign_2-0&adjust_adgroup=35-42&adjust_creative=island_sunset

これで、ユニバーサルリンクを使用する準備が整いました。

アプリ内のパスの追加

ユニバーサルリンクのパスにクエリパラメーターが既に含まれている場合は、?を使用してAdjustパラメーターを追加しないでください。2つの?文字をURLで使用すると、2つ目の文字よりも後の情報はブラウザによって破棄されます。その結果、アプリがインストールされていない場合にHTTP 404エラーが発生する場合があります。次の例を使用して設定を確認できます。ディープリンクのよくある質問で、詳細を確認することもできます。

正：​ https://z9pm.adj.st/my?path=location&client=name&adjust_t=abc123

誤：​ https://z9pm.adj.st/my?path=location&client=name?adjust_t=abc123

ダイナミックコールバックパラメーターを使用する

ダイナミックコールバックパラメーターをユニバーサルリンクでパスしたい場合は、adj_のプレフィックスをパラメーターに追加 しない でください。プレフィックスを追加すると、パラメーターはAdjustバックエンドで記録されず、コールバックで送信されなくなります。代わりに以下の設定手順に従ってください。

DCP設定：​ adj_のプレフィックスをユニバーサルリンクのパラメーターに追加 しない でください。

例：​

以下は、DCPパラメーターが追加されたユニバーサルリンクの例です。パラメーターは {dcp_example_parameter} のプレースホルダーを使用しています。

https://abcd.adj.st/?adjust_t=abc123&example_parameter=such_value

マルチプラットフォームのユニバーサルリンクを作成する

マルチプラットフォームのユニバーサルリンクは、全てのアプリユーザーを1つのAdjust URLでディープリンクします。Adjustのディープリンクジェネレーターを使用すると、簡単にすばやく作業を開始できます。

独自のマルチプラットフォームのユニバーサルリンクを作成するには、まず、iOSアプリとAndroidアプリが同じパスとクエリパラメーターを共有しているかどうかを特定します。その結果によって、使用する形式が決まります。

次に、AndroidアプリスキームがAdjustに保存されていることを確認します。これは、アプリを開くURLプレフィックスを指定するものです。アプリで設定され、モバイルプラットフォーム（iOSおよびAndroid）ごとに固有です。例： my_android_app://

管理画面で

  1. Androidアプリに移動して、アプリオプションの（▲）ボタンを選択します。
  2. その他の設定（All Settings） >（設定（Settings））プラットフォーム（Platforms）​ を選択します。
  3. アプリスキーム（App Scheme）​ を入力します。
  4. 保存 (SAVE)​ を選択します。

注： ユーザーがユニバーサルリンクをクリックすると、Adjustでは常に、ストアに移動する前にまずディープリンクしようとします。アプリの管理画面の設定にAndroidアプリスキームが保存されている場合、同様に動作します。Androidユーザーを直ちにストアに移動させる場合は、Androidスキームを管理画面の設定に含めないでください。

iOSとAndroidで同じパスとクエリパラメーターを共有している

ディープリンクの遷移先で、同じパスとクエリパラメーターをAndroidアプリとiOSアプリの両方で共有している場合は、次のユニバーサルリンク形式を使用します。

Adjust管理画面でプラットフォーム別に分かれているアプリの場合​

https://[RAW UNIVERSAL LINK]/[PATH]?adjust_t=[IOS_TRACKER]_[ANDROID TRACKER]&[ADJUST PARAMETERS]

例:
https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz

Adjustでマルチプラットフォームとして設定されているアプリの場合​

https://[RAW UNIVERSAL LINK]/[PATH]?adjust_t=[TRACKER]&[ADJUST PARAMETERS]

例:
https://z9pm.adj.st/my/path?adjust_t=abc123

iOSアプリとAndroidアプリでパスとクエリパラメーターが異なっている

ディープリンクの遷移先で、同じパスとクエリパラメーターをAndroidアプリとiOSアプリの両方で共有していない場合は、次のユニバーサルリンク形式を使用します。

注： この形式を使用すると、Androidアプリスキームが管理画面に保存されている場合でも、指定の遷移先にユーザーがディープリンクされます。

Adjust管理画面でプラットフォーム別に分かれているアプリの場合​

https://[RAW UNIVERSAL LINK]/[IOS UNIVERSAL LINK PATH]?adjust_t=[IOS_TRACKER]_[ANDROID TRACKER]&adjust_deeplink=[ENCODED ANDROID APP SCHEME + PATH]&[ADJUST PARAMETERS]

例： https://z9pm.adj.st/my/path&adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

Adjustでマルチプラットフォームとして設定されているアプリの場合​

https://[RAW UNIVERSAL LINK]/[IOS UNIVERSAL LINK PATH]?adjust_t=[TRACKER]&adjust_deeplink=[ENCODED ANDROID APP SCHEME + PATH]&[ADJUST PARAMETERS]

例： https://z9pm.adj.st/my/path&adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

Javascriptユニバーサルリンクを作成する

Javascriptユニバーサルリンク（JSR）は、Eメールキャンペーンのように、サポートされている環境の外でクリックとHTTPリダイレクトが発生する場合に使用します。通常、ユニバーサルリンクはこの場合には機能せず、ユーザーがアプリをインストール済みである場合も含め、全てのユーザーをストアに送ります。

JSRを機能させるためには、対象のアプリと管理画面で、ユニバーサルリンクを設定する必要があります。

iOS 11以降の場合

JSRユニバーサルリンクのパラメーターをトラッカーに追加するには、以下の手順に従ってください。

  1. 使用するユニバーサルリンクを見つけます。例： https://ab12.adj.st/?adjust_t=abc123
  2. ユニバーサルリンクをエンコードします。
  3. エンコードしたユニバーサルリンクを続けて追加します。例： https://app.adjust.com/jsr?url=

例：​

https://app.adjust.com/jsr?url=https%3A%2F%2Fab12\.adj.st%2F%3Fadjust\_t%3Dabc123

iOS 10.3以前の場合

Safari webviewまたは11より前のバージョンのiOSのユーザーを対象にするには、adjust_deeplink_js=1フラグをJSRユニバーサルリンクに追加します。このフラグはフォールバックとして機能し、スキーム経由でリンクが開くようにし、ユーザーをストアに転送する（ユーザーがアプリをインストールしていない場合）か、アプリ内のページを開くことをユーザーに求めるポップアップを表示します。

例：​

https://app.adjust.com/jsr?url=https%3A%2F%2F6s45.adj.st%2F%3Fadjust_t%3D1uhwo6%26adjust_deeplink_js%3D1

Safari Smart App Bannerからユーザーをアトリビューションする

Safari Smart App Bannerは、アプリがユーザーのデバイスでサポートされているかどうかを自動的に判定し、サポートされていない場合は表示しません。バナーをタップした後、アプリがユーザーのデバイスに既にインストールされているかどうかが検出されます。インストールされている場合、ユーザーは指定されたアプリ内のページにディープリンクされます。インストールされていない場合、ユーザーはディープリンクされる前に、アプリをダウンロードしてインストールするようApp Store経由でルーティングされます。

Smart App Bannerのクリックアトリビューションを設定するには、バナーのHTMLタグのapp-argumentパラメーターにディープリンクを追加します。

完了したバナーは次のようになります。

<meta name="apple-itunes-app" content="app-id=myAppStoreID, affiliate-data=myAffiliateData, app-argument=myapp://landing_page" id="sl-md34a5">

Smart App Bannerの設定方法の詳細については、Appleの開発者向けガイドをご覧ください。

注：​ Adjustは、ユーザーが既にアプリをインストールしている場合にのみ、ユーザーをSafari Smart App Bannerにリアトリビュートします。App Storeにリダイレクトされた後にアプリをインストールするユーザーは、オーガニック（または他の有効なアトリビューションソース）としてアトリビュートされます。

ユニバーサルリンクをテストする

ユニバーサルリンクが正しく設定されていることを確認するには、さまざまなシナリオでテストを実施いただく必要があります。ユニバーサルリンクは、SafariまたはChromeで開く必要があるため、テスト用のWeb環境でリンクをホストします。テスト中に問題が発生した場合は、トラブルシューティングガイドで詳細を確認してください。

既存ユーザーの場合

既存ユーザーとしてユニバーサルリンクをテストするには、以下の手順に従ってください。

  1. テスト用デバイスから簡単にアクセスできるテスト用Webページを作成します。
  2. Rawユニバーサルリンクをテスト用Webページに追加します。
  3. ユニバーサルリンク全体をテスト用Webページに追加します。
  4. TestFlightを使用してアプリの新しいビルドをデバイスに読み込むか、xCodeを使用してアプリのデバッグバージョンをインストールします。次に、テスト用Webページをブラウザーで開きます。
  5. ユニバーサルリンクをクリックします。新しいアプリのビルドがインストールされたら、新しいアプリに自動的にディープリンクされるはずです。

アプリがインストールされて正しいページで自動的に開く場合は、そのアプリでキャンペーンを計測する準備ができています。

アプリが開かない場合はRawユニバーサルリンク（例：https://z9pm.adj.st）をクリックして、連携が正しくされていることを確認します。リンクが失敗してHTTP 404エラー（URLが見つからない）が返される場合は、連携に関する手順を再確認してください。

注：JSRリンクをテストするには、キャンペーンが実施される特定の環境を常に使用するのが最も良い方法です。

新しいユーザーの場合（ディファードディープリンク）

新しいユーザーとしてユニバーサルリンクをテストするには、以下の手順に従ってください。

  1. アプリをデバイスから完全にアンインストールします（可能な場合、アプリのゴミ箱を空にします）。
  2. Adjust管理画面のテストコンソールからデバイスデータを削除します。
  3. テスト用デバイスから簡単にアクセスできるテスト用Webページを作成します。
  4. ユニバーサルリンクをテスト用Webページに追加します。
  5. ユニバーサル リンク トークンをテスト用Webページに追加します。
  6. ディープリンクトラッカーURLをクリックし、アプリストアにリダイレクトされるのを待ちます。
  7. アプリをダウンロードして開きます。Adjustでインストールがトリガーされます。
  8. アプリが開くと、カスタムURIスキームで指定された特定の場所にディープリンクされます。

アプリを開いた後にディープリンクされた場合、Adjustの設定は完了しています。

アンインストールされたアプリでユニバーサルリンクが機能せず、インストールされたアプリには機能する場合、Adjust管理画面で入力したアプリスキーム（App Scheme）が正しいことを確認してください。これは、 その他の設定（All Settings） > プラットフォーム（Platforms） > ユニバーサルリンク（Universal Linking）​ を選択することで確認できます。