ユニバーサルリンク

ユニバーサルリンクは、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ユニバーサルリンクをアプリ開発者に渡し、実装プロセスを続行してください。
 

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

その他の設定(All Settings)を選択します。

プラットフォーム(Platforms)を選択します。

ユニバーサルリンク(Universal Linking)を選択します。

Apple App Storeから指定されたアプリのiOS BUNDLE IDを入力します。

Apple Developer Account Summaryに記載されたAPP PREFIXを入力します。 

アプリ開発者が決定したAPP SCHEMEを入力します。

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

アプリ内でアプリ固有のサブドメインをホワイトリストに指定するには、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ではユニバーサルリンクへのリダイレクトが許可されていません。つまり、ユニバーサルリンクを別のURLにラップしても機能しません。ユニバーサルリンクをラップする場合は、JSRソリューションを使用してください。

      ユニバーサルリンクを設定するには、ディープリンクジェネレーターをご使用ください。設定時間が短縮され、エラーを回避できます。Adjust管理画面からメニュー (Menu) >ディープリンクジェネレーター (Deeplink Generator)を選択すると、ディープリンクジェネレーターにアクセスできます。

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

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

      その他の設定(All Settings)を選択します。

      プラットフォーム(Platforms)を選択します。

      ユニバーサルリンク(Universal Linking)を選択します。

      この例では、Rawユニバーサルリンクをu7f3.adj.stとします。

      キャンペーンの計測に使用するAdjustトラッカートークンを識別するか、新しいキャンペーン用のAdjustトラッカーURLを作成します。(このトークンは、Adjustキャンペーン構造パラメーターで定義された、最下位のセグメンテーションとなります)。既存のトークンを見つけるには、アプリに移動して、アプリのオプションボタン(▲)をクリックします。

      次に、トラッカーURL(Tracker URLs)を選択します。

      この例では、トラッカートークンはbkrn68です。

      プレーンテキストファイルでこのトークンにhttps://を追加します。

      adjust_tパラメータを使用して、URLにAdjustトラッカートークンを追加します。クエリ文字列は?で始めてください。

      アプリ内のパスを追加します(該当する場合)。

      必要に応じて、その他のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください。


      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=klm012
      3. アプリ内のパスを追加します(該当する場合)。 
      https://z9pm.adj.st/my/path?adjust_t=klm012
      4. その他のAdjustパラメーターを追加します(該当する場合)。 
      ​https://z9pm.adj.st/my/path?adjust_t=klm012&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=klm012

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

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

      マルチプラットフォームのユニバーサルリンクは、単一のAdjust URLを使用してアプリの全てのユーザーをディープリンクします。設定は、Adjust管理画面内でアプリをどのように設定したかによって異なります。

      Adjustでプラットフォームによって区別されるアプリの場合

      Adjust管理画面にて

      1. 対象のiOSアプリを見つけて、アプリのオプションボタン(▲)をクリックします。
      2. その他の設定(All Settings) > (設定) > プラットフォーム(Platforms) > ユニバーサルリンク(Universal Link)を選択します。
      3. Rawユニバーサルリンク (Raw Universal Link)をコピーします。
      4. トラッカーURLに含めるカスタムURIを見つけます。これは、ユーザーのディープリンク先となるAndroidアプリ内の特定の場所またはランディングページです。例: ​myamazingapp://super/exclusive/promotion​ 
      5. カスタムURLをエンコードします。
      6. キャンペーンの計測に使用するトラッカートークンを見つけるか、作成します。多くの場合、これはAndroid用とiOS用でそれぞれ1つずつのトラッカートークンです。例: abc123および987xyz
      任意のテキストエディターにて

      1. Rawユニバーサルリンクにhttps://を追加します。   
      https://z9pm.adj.st/
      2. URLに?を追加し、adjust_tパラメーターを使用して、またアンダーバーで区切ってトラッカートークンを追加します。 
      https://z9pm.adj.st?adjust_t=abc123_987xyz
      3. アプリ内のパスを追加します(該当する場合)。
      https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz
      4. adjust_deeplinkパラメーターとエンコード済みのカスタムURIを追加します。
      https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 追加のAdjustパラメーターを追加します(該当する場合)。

      トラッカーURLによってアプリの全てのユーザーがディープリンクされるようになりました。

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

      その他の設定(All Settings)を選択します。

      プラットフォームを選択(Select Platforms)を選択します。

      ユニバーサルリンク(Universal Linking)を選択します。

      対象のiOSアプリのRawユニバーサルリンクを見つけます。この例ではu7f3.adj.stとします。

      トラッカーURLに追加するカスタムURIを確認します。これはAndroidアプリ内の特定の場所またはランディングページになります。この例では、カスタムURIをmyamazingapp://super/exclusive/promotionとします。

      データが失われないよう、すべてのカスタムURIをエンコードする必要があります。エンコードされたURLは次のように表示されます。myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

      キャンペーンの計測に使用するAdjustトラッカートークンを識別するか、新しいキャンペーン用のAdjustトラッカーURLを作成します。通常、Android用とiOS用でそれぞれ1つずつトラッカートークンを作成してください。AdjustトラッカーURLの文字数を減らすには、Adjust管理画面で生成された最下位のサブレベル(クリエイティブレベル)のトラッカーURLを使用することをお勧めします。

      プレーンテキストファイルでRawユニバーサルリンクにhttps://を追加します。 

      adjust_tパラメーターを使用してURLにAdjustトラッカートークンを追加し、各トークンをアンダーバーで区切ります。クエリ文字列は?で始めてください。

      アプリ内のパスを追加します(該当する場合)。

      adjust_deeplinkパラメーターとエンコード済みのカスタムURIを追加します。(必要に応じて、追加のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください)。

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

      管理画面で

      1. 対象のアプリを見つけて、アプリのオプションボタン(▲)をクリックします。
      2. その他の設定(All Settings) > (設定) プラットフォーム(Platforms) > ユニバーサルリンク(Universal Link)を選択します。
      3. Rawユニバーサルリンクをコピーします。 
      4. トラッカーURLに含めるカスタムURIを見つけます。
      5. カスタムURLをエンコードします。
      6. キャンペーンの計測に使用するトラッカートークンを見つけるか、作成します。

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

      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_deeplinkパラメーターとエンコード済みのカスタムURIを追加します。

        https://z9pm.adj.st/my/path?adjust_t=abc123&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 追加のAdjustパラメーターを追加します(該当する場合)

      これで、設定したURLによって、マルチプラットフォームアプリの全てのユーザーがディープリンクされるようになりました。
       

      ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像 ユーザーが追加した画像

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

      その他の設定(All Settings)を選択します。

      プラットフォームを選択(Select Platforms)を選択します。

      ユニバーサルリンク(Universal Linking)を選択します。

      対象のiOSアプリのRawユニバーサルリンクを見つけます。この例では、Rawユニバーサルリンクのトークンをu7f3.adj.stとします。

      トラッカーURLに追加するカスタムURIを確認します。これはAndroidアプリ内の特定の場所またはランディングページになります。この例では、カスタムURIをmyamazingapp://super/exclusive/promotionとします。

      データが失われないよう、すべてのカスタムURIをエンコードする必要があります。エンコードされたURLは次のように表示されます。myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

      キャンペーンの計測に使用するAdjustトラッカートークンを識別するか、新しいキャンペーン用のAdjustトラッカーURLを作成します。AdjustトラッカーURLの文字数を減らすには、Adjust管理画面で生成された最下位のサブレベル(クリエイティブレベル)のトラッカーURLを使用することをお勧めします。

      プレーンテキストファイルでこのトークンにhttps://を追加します。

      adjust_tパラメーターを使用してURLにAdjustトラッカートークンを追加し、各トークンをアンダーバーで区切ります。クエリ文字列は?で始めてください。

      アプリ内のパスを追加します(該当する場合)。

      adjust_deeplinkパラメーターとエンコード済みのカスタムURIを追加します(必要に応じて、追加のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください)。

      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">
      

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

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

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

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

      既存ユーザーとして

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

      1. テスト用デバイスから簡単にアクセスできるテスト用Webページを作成します。
      2. raw universal linkをテスト用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)を選択することで確認できます。

      このトピックについて