ユニバーサルリンク
ユニバーサルリンクは、iOSバージョン9以降で利用できるディープリンクのための仕組みです。
ここでは、ユニバーサルリンクを使用してキャンペーンを設定し、テストし、計測する方法について説明します。
事前準備
事前準備として、以下の内容をご確認ください。
要件
参考
- ユニバーサルリンクは、以前のiOSバージョンや他のモバイルプラットフォームで使用されるカスタムURLスキームとは異なる方法で作成されます。
Rawユニバーサルリンク
とは、パラメーター、アプリ内パス、キーと値のペアのどれも追加されていないユニバーサルリンクのことです。Adjust管理画面で生成されます。- Rawユニバーサルリンクを検索または作成するには、管理画面の その他の設定 (All Settings) > プラットフォーム (Platforms) > iOS > ユニバーサルリンク (Universal Linking) から以下の手順に従ってください。
ユニバーサルリンクの設定手順
Adjust管理画面でユニバーサルリンクを有効にする
- アプリに移動して、アプリオプションの(▲) ボタンをクリックします。
- その他の設定(All Settings) >(設定(SETTINGS)) プラットフォーム(Platforms) を選択します。
- (AppleのApp Storeによって指定された)アプリの iOS BUNDLE ID を入力します。
- ユニバーサルリンク(Universal Linking) を選択します。
- Apple Developer Account Summaryに記載された APP PREFIX と、アプリ開発者が決定した APP SCHEME を入力します。
- 全てのフィールドに入力すると、Rawユニバーサルリンクが表示されます。例:
http://z9pm.adj.st
- 保存(SAVE) を選択します。
このRawユニバーサルリンクをアプリ開発者に渡し、実装プロセスを続行してください。
アプリにユニバーサルリンクのサポートを追加する
アプリ内でアプリ固有のサブドメインをホワイトリストに指定するには、Rawユニバーサルリンクをアプリ開発者に送信します。アプリ開発者は、AdjustのGitHubにある開発者ガイド、またはAppleの開発者向けドキュメントで詳細を確認してください。
iOSのディープリンクを使用してキャンペーンを計測する
以下を使用して、ユーザーをiOSアプリにディープリンクできます。
- ユニバーサルリンク
- Javascriptユニバーサルリンク
- AdjustトラッカーURLと
deep_link
パラメーター
トラッカーURLとdeep_link
パラメーターを使用したディープリンクをiOS 9以降のキャンペーンで使用するには、Adjust管理画面とXcodeプロジェクトでユニバーサルリンクが設定されていることを確認してください。設定されていれば、Adjustでトラッカーをユニバーサルリンクに変換し、デバイスに送信してアプリを開くことができます。
最も優れた連携方法は、ユーザーに広告が表示される、ご利用の広告環境をサポートすることです。
展開するキャンペーンに最も適した設定については、次の表を参照してください。
広告環境 | 推奨する設定 |
---|---|
Chromeブラウザー | ユニバーサルリンク
トラッカー + |
Safariブラウザー | ユニバーサルリンク
トラッカー + deep_link パラメーター |
Facebookニュースフィード | ユニバーサルリンク
Javascriptユニバーサルリンク
トラッカー + deep_link パラメーター注:パスの追加が必要 |
Facebookブラウザー | ユニバーサルリンク Javascriptユニバーサルリンク トラッカー + deep_link パラメーター |
Facebook Messenger | ユニバーサルリンク
Javascriptユニバーサルリンク
トラッカー + |
Facebook Messengerブラウザー | ユニバーサルリンク Javascriptユニバーサルリンク(パスを追加) トラッカー + deep_link パラメーター(パスを追加) |
トラッカー + deep_link パラメーター注:アプリでユニバーサルリンクの実装が必要 | |
Gmail | Universal Link |
Apple Mail | ユニバーサルリンク
トラッカー + |
Slack | Universal Link |
| ユニバーサルリンク
トラッカー + |
Snapchatメッセージ | ユニバーサルリンク
Javascriptユニバーサルリンク
トラッカー + |
SFSafariViewControllerとのディープリンク | ユニバーサルリンク
Javascriptユニバーサルリンク |
ユニバーサルリンクを作成する
Adjustトラッカーが追加されたRawユニバーサルリンクは、ここで扱うユニバーサルリンクの標準形式です。リンクは短縮URLで、Webキャンペーンで機能します。
トラッカーが追加されていないRawユニバーサルリンクは、アプリを既にインストールしているiOS 9以降のユーザーにしか機能しません。
ディープリンクジェネレーター
ユニバーサルリンクを設定するには、ディープリンクジェネレーターをご使用ください。設定時間が短縮され、エラーを回避できます。
Adjust管理画面から メニュー (Menu) >ディープリンクジェネレーター (Deeplink Generator) を選択すると、ディープリンクジェネレーターにアクセスできます。
手動設定
ユニバーサルリンクをマニュアル設定するには、以下の手順に従ってください。
Adjust管理画面にて
- 該当アプリの下部に表示されている(▲)ボタンを選択します。
- その他の設定(All Settings) >(設定) プラットフォーム(Platforms) > ユニバーサルリンク(Universal Linking) を選択します。
- Rawユニバーサルリンク(Raw Universal Link) をコピーします。
- 使用するトラッカーURLを見つけるか、作成します。
- トラッカートークンをコピーします。
任意のテキストエディターにて
Rawユニバーサルリンクに
https://
を追加します。https://z9pm.adj.st/
?
を追加し、adjust_t
パラメーターを使用してURLにトラッカートークンを追加します。https://z9pm.adj.st/?adjust_t=abc123
https://z9pm.adj.st/my/path?adjust_t=abc123
その他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://
管理画面で
- Androidアプリに移動して、アプリオプションの(▲)ボタンを選択します。
- その他の設定(All Settings) >(設定(Settings))プラットフォーム(Platforms) を選択します。
- アプリスキーム(App Scheme) を入力します。
- 保存 (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ユニバーサルリンクのパラメーターをトラッカーに追加するには、以下の手順に従ってください。
- 使用するユニバーサルリンクを見つけます。例:
https://ab12.adj.st/?adjust_t=abc123
- ユニバーサルリンクをエンコードします。
- エンコードしたユニバーサルリンクを続けて追加します。例:
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環境でリンクをホストします。テスト中に問題が発生した場合は、トラブルシューティングガイドで詳細を確認してください。
既存ユーザーの場合
既存ユーザーとしてユニバーサルリンクをテストするには、以下の手順に従ってください。
- テスト用デバイスから簡単にアクセスできるテスト用Webページを作成します。
- Rawユニバーサルリンクをテスト用Webページに追加します。
- ユニバーサルリンク全体をテスト用Webページに追加します。
- TestFlightを使用してアプリの新しいビルドをデバイスに読み込むか、xCodeを使用してアプリのデバッグバージョンをインストールします。次に、テスト用Webページをブラウザーで開きます。
- ユニバーサルリンクをクリックします。新しいアプリのビルドがインストールされたら、新しいアプリに自動的にディープリンクされるはずです。
アプリがインストールされて正しいページで自動的に開く場合は、そのアプリでキャンペーンを計測する準備ができています。
アプリが開かない場合はRawユニバーサルリンク(例:https://z9pm.adj.st)をクリックして、連携が正しくされていることを確認します。リンクが失敗してHTTP 404エラー(URLが見つからない)が返される場合は、連携に関する手順を再確認してください。
注:JSRリンクをテストするには、キャンペーンが実施される特定の環境を常に使用するのが最も良い方法です。
新しいユーザーの場合(ディファードディープリンク)
新しいユーザーとしてユニバーサルリンクをテストするには、以下の手順に従ってください。
- アプリをデバイスから完全にアンインストールします(可能な場合、アプリのゴミ箱を空にします)。
- Adjust管理画面のテストコンソールからデバイスデータを削除します。
- テスト用デバイスから簡単にアクセスできるテスト用Webページを作成します。
- ユニバーサルリンクをテスト用Webページに追加します。
- ユニバーサル リンク トークンをテスト用Webページに追加します。
- ディープリンクトラッカーURLをクリックし、アプリストアにリダイレクトされるのを待ちます。
- アプリをダウンロードして開きます。Adjustでインストールがトリガーされます。
- アプリが開くと、カスタムURIスキームで指定された特定の場所にディープリンクされます。
アプリを開いた後にディープリンクされた場合、Adjustの設定は完了しています。
アンインストールされたアプリでユニバーサルリンクが機能せず、インストールされたアプリには機能する場合、Adjust管理画面で入力したアプリスキーム(App Scheme)が正しいことを確認してください。これは、 その他の設定(All Settings) > プラットフォーム(Platforms) > ユニバーサルリンク(Universal Linking) を選択することで確認できます。