iOSのためのダイレクトリンク
ユニバーサルリンクは、iOSバージョン9以降でご利用いただけるディープリンクのためのプロトコルです。ユニバーサルリンクは、iOSの旧バージョンや他のモバイルプラットフォームで使用される、カスタムスキームURLとは設定方法が異なります。Adjustは、ダイレクトリンクによるユニバーサルリンク機能に必要なロジックの大部分に対応していますが、この機能を実装する場合は、アプリ内での設定が必要となります。

アプリがAdjustによるユニバーサルリンクの計測をサポートするよう設定したら、キャンペーンに最適な設定を決定し、それに応じてURLを作成します。

設定とテストの手順

ユニバーサルリンクの実装

Adjust管理画面 

  1. アプリに移動して、アプリオプションの (▲) ボタンをクリックします。
  2. ユニバーサルリンクを有効化するには、アプリのその他の設定(All Settings)> プラットフォーム(Platforms)> ユニバーサルリンク(Universal Link)を選択します。
  3. Apple App Storeから指定されたアプリのiOS BUNDLE IDを入力します。
  4. Apple Developer Account Summaryに記載されたAPP PREFIXを入力します。 
  5. アプリ開発チームが決定したAPP SCHEMEを入力します。
両方のフィールドに入力すると、短いユニバーサルリンク(例:http://z9pm.adj.st)が表示されます。

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

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

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

2b. プラットフォームを選択

2c. イベント連携 (Event Linkin)を選択します。

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

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

5. アプリ開発チームが決定したAPP SCHEMEを入力します。

 

開発者向けの手順

  1. アプリに、applinksをつけた短いユニバーサルリンク(例:applinks.z9pm.adj.st)を挿入します。(com.apple.developer.associated-domains entitlementのprefix)
  2. アプリにcontinueUserActivityメソッドを実装します。
    • このメソッドでは、ユニバーサルリンクを簡単に取得できます。詳細とコードの例については、Adjust iOS SDK READMEをご確認ください。
上記の手順が完了したら、ユニバーサルリンクの統合をテストすることができます。

ユニバーサルリンクの実装をテスト

以下の手順で、実装が完了したかどうかを確認してください。

設定手順

  1. モバイルデバイスからアクセスと編集が簡単に行えるテスト用Webページを作成します。これは、ローカルWebサーバー上またはCMSを使用して実行できます。
  2. ダイレクトリンク、またはディープリンクパラメータが追加されたAdjustトラッカーURLをテスト用Webページに埋め込みます。
  3. Adjust管理画面で生成されたベースとなるダイレクトリンクを、テスト用Webページに追加します。
  4. 新しいビルドの読み込みにTestFlightを使うこともできますし、xCodeからアプリのデバッグバージョンをインストールすることもできます。どちらの場合でも、WebページはSafariブラウザで開いてください。
  5. ダイレクトリンク、または(もしくは)ディープリンクパラメータが追加されたトラッカーURLをSafari上でクリックします。新しいアプリのビルドがインストールされると、いずれのリンクも自動的にアプリにディープリンクします。
アプリが開かない場合は、ベースとなるダイレクトリンク(この例ではhttps://z9pm.adj.st)をクリックして、アプリの実装が正しく行われているかどうかを確認します。いずれのリンクでも成功しない場合は、Adjustの実装手順を再度ご確認ください。

適切に実装されたことが確認できたら、Adjustパラメータまたはダイレクトリンクを使用してキャンペーンを計測することができます。各メソッドの設定手順については、以下をご覧ください。

ユニバーサルリンクによるキャンペーンの計測

ユニバーサルリンクがAdjust管理画面で有効化されアプリに実装されたら、Adjustによる計測を開始することができます。Adjust URLは、ユニバーサルリンクを自動的に使用してディープリンクを実行し、App Storeにフォールバックして、新しいアプリユーザーを保留します。Adjust deep_linkパラメーターを使用してAdjustトラッカーURLを作成するか、またはダイレクトリンクを作成してユーザーをアプリにディープリンクさせることができます。 

ダイレクトリンクは、使用中のiOSモバイルデバイスにアプリがインストールされた際に、Adjustサーバーを迂回させることができます。この設定ではさまざまなアプリ環境がサポートされていますが、クリック時に収集されるアトリビューションデータの量も削減されます。

以下の表で、Adjustが計測するキャンペーンに最適な設定をご確認ください。*  
    用途推奨する設定

    SFSafariViewControllerを除くWebビューとのディープリンク

    deep_linkパラメータ

    SFSafariViewControllerとのディープリンク

    ダイレクトリンク

    Chrome

    deep_linkパラメータ

    Facebook

    deep_linkパラメータ

    Gmail

    deep_linkパラメータ

    Inbox

    deep_linkパラメータ

    メール

    ダイレクトリンク

    メッセージ

    ダイレクトリンク

    Push通知

    ダイレクトディープリンク

    QR 2アプリのリンク

    ダイレクトリンク

    Safari

    deep_linkパラメータ

    Slack

    deep_linkパラメータ

    Viber

    ダイレクトリンク

    WhatsApp

    ダイレクトリンク

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

      設定手順

      ダイレクトリンクを作成

      ダイレクトリンクを使用するには、まず最初にアプリにユニバーサルリンクを実装する必要があります。

      Adjust管理画面
      1. アプリの短いユニバーサルリンクトークンを確認するには、該当アプリに移動し、アプリ画面下の▲アイコンをクリックし、その他の設定(All Settings)> プラットフォーム(Platforms)> ユニバーサルリンク(Universal Linking)を選択します。
        この例では、短いユニバーサルリンクトークンは、z9pm.adj.stになります。
      2. キャンペーンの計測に使用するAdjustトラッカートークンを確認(該当アプリに移動し、アプリ画面下の▲アイコンをクリックし、トラッカーURL(Tracker URLs)を選択)するか、キャンペーン用に新しくAdjustトラッカーURLを作成します。(このトークンは、Adjustキャンペーン構造パラメータで定義された、最下位のセグメンテーションとなります)。
        この例では、トラッカートークンはklm012です。
      任意のテキストエディターにて
      1. 短いユニバーサルリンクのトークンに、プレーンテキストファイルでhttps://を追加します。 
        https://z9pm.adj.st/
      2. adjust_tパラメータを使用して、URLにAdjustトラッカートークンを追加します。クエリ文字列は?で始めてください。 
        https://z9pm.adj.st/?adjust_t=klm012
      3. アプリ内のパスを追加します(該当する場合)。 
        https://z9pm.adj.st/my/path?adjust_t=klm012
      4. 必要に応じて、その他のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください。 
        ​https://z9pm.adj.st/my/path?adjust_t=klm012&adjust_campaign=Getaway_Vacation_Campaign_2-0&adjust_adgroup=35-42&adjust_creative=island_sunset

      ヒント:URLの長さを短縮するには、Adjustキャンペーン構造パラメータの短縮バージョンを使用してください。Adjustは、アトリビューションデータに対する以下のパラメータを認識します。 

      パラメーター名データタイプ
      adjust_campaignキャンペーンレベル(サブレベル1)
      adj_adgroupアドグループレベル(サブレベル2)
      adj_creativeクリエイティブレベル(サブレベル3)

       

      上記が完了すると、トラッカーURLを使用することができます。
       

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

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

      1c. プラットフォームを選択する

      1d. ユニバーサルリンクを選択する。

      1e.この例では、短いユニバーサルリンクのトークンは次の通りです。 u7f3.adj.st

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

      2b. ...次にトラッカーURLを選択します。

      .

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

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

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

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

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

       

      クロスプラットフォームのダイレクトリンク

      クロスプラットフォームのダイレクトリンクは、単一のAdjust URLを通じてすべてのアプリユーザーをディープリンクさせる安全なアプローチです。クロスプラットフォームのダイレクトリンクを作成する方法は以下のとおりです。

      設定手順は、Adjust管理画面でアプリをどのように設定しているかによって異なります。

      • アプリがOSプラットフォーム別に分けられている場合は、こちらの手順を実行してください。
      • アプリがマルチプラットフォームとして設定されている場合(すなわち、OSを問わずすべてのアプリデータがまとめてレポートされている場合)は、こちらの手順を実行してください。

      Adjustで単一のプラットフォームとして設定されているアプリに、クロスプラットフォームのダイレクトリンクを作成

      注:以下の手順では、例として最小長のトラッカートークンを使用しています。Adjustキャンペーンウィザードに表示されたトラッカートークン全体を必ず使用してください。

      Adjust管理画面にて

      1. iOSアプリの短いユニバーサルリンクトークンを取得するには、該当アプリに移動して、その他の設定(All Settings)プラットフォーム(Platforms)ユニバーサルリンク(Universal Linking)を選択します。

        この例では、短いユニバーサルリンクトークンは次のとおりです。 
        z9pm.adj.st
        
      2. トラッカーURLに含めたいカスタムURLを確認します。これはAndroidアプリ内の特定の場所またはランディングページになります。

        この例では、カスタムURLは次のとおりです。 
        ​ myamazingapp://super/exclusive/promotion
        データが失われないよう、すべてのカスタムURLをエンコードする必要があります。エンコードされたURLは、次のように表示されます。 
        myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
        
      3. キャンペーン計測に使用するAdjustのトラッカートークンを確認するか、新しいキャンペーン用のAdjustトラッカーURLを作成します。通常、Android用とiOS用でそれぞれ1つづつトラッカートークンを作成します。AdjustトラッカーURLの文字数を減らすには、Adjust管理画面で生成された最下位のサブレベル(クリエイティブレベル)のトラッカーURLを使用することをお勧めします。
      4. この例では、トラッカートークンはabc123987xyzです。
      任意のテキストエディターにて
      1. 短いユニバーサルリンクトークンに、プレーンテキストファイルでhttps://を追加します。  
        https://z9pm.adj.st/
      2. adjust_tパラメータを使用してURLにAdjustトラッカートークンを追加し、各トークンをアンダーバーで区切ります。クエリ文字列は?で始めてください。 
        https://z9pm.adj.st?adjust_t=abc123_987xyz
      3. アプリ内のパスを追加します(該当する場合)。
        https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz
      4. adjust_deeplinkパラメータとエンコード済みのカスタムURLを追加します。
        https://z9pm.adj.st/my/path?adjust_t=abc123_987xyz&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 必要に応じて、その他のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください。

      上記手順が完了すると、URLですべてのアプリユーザーをディープリンクさせることができます。 

       

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

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

      1c. プラットフォーム選択を選択する

      1d. ユニバーサルリンクを選択する。

      1e. iOSアプリの短いユニバーサルリンクトークンを選択します。この例では、短いユニバーサルリンクトークンをu7f3.adj.stとします。

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

      2b.データが失われないよう、すべてのカスタムURLをエンコードしなければなりません。エンコードされたURLは次のように表されます。myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

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

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

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

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

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

       

      Adjustでマルチプラットフォームとして設定されているアプリにクロスプラットフォームのダイレクトリンクを作成

      注:以下の手順では、最も短いトラッカートークンを使用しています。Adjustキャンペーンウィザードに表示されたトラッカートークンを必ず使用してください。

      Adjust管理画面
      1. iOSアプリの短いユニバーサルリンクトークンを取得するには、該当アプリに移動して、その他の設定(All Settings)プラットフォーム(Platforms)ユニバーサルリンク(Universal Linking)を選択します。

        この例では、短いユニバーサルリンクトークンは次のとおりです。 
        z9pm.adj.st
      2. トラッカーURLに含めたいカスタムURLを確認します。これはAndroidアプリ内の特定の場所またはランディングページになります。

        この例では、カスタムURLは次のとおりです。 
        myamazingapp://super/exclusive/promotion
        データが失われないよう、すべてのカスタムURLをエンコードする必要があります。エンコードされたURLは、次のように表示されます。
        myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      3. キャンペーン計測に使用するAdjustトラッカートークンを特定するか、または新しいキャンペーンのAdjustトラッカーURLを作成します。AdjustトラッカーURLの文字数を減らすには、Adjust管理画面で生成された最下位のサブレベル(クリエイティブレベル)のトラッカーURLを使用することをお勧めします。

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

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

      1. 短いユニバーサルリンクトークンに、プレーンテキストファイルでhttps://を追加します。
        https://z9pm.adj.st/
      2. adjust_tパラメータを使用して、URLにAdjustトラッカートークンを追加します。クエリ文字列は?で始めてください。
        https://z9pm.adj.st?adjust_t=abc123
      3. アプリ内のパスを追加します(該当する場合)。
        https://z9pm.adj.st/my/path?adjust_t=abc123
      4. adjust_deeplinkパラメータとエンコード済みのカスタムURLを追加します。
        https://z9pm.adj.st/my/path?adjust_t=abc123&adjust_deeplink=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion
      5. 必要に応じて、その他のキーと値のペアを追加します。これらのペアは、アプリとキャンペーンに合わせてカスタマイズしてください。

      上記の手順が完了すると、URLですべてのアプリユーザーをディープリンクさせることができます。
       

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

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

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

      1c. プラットフォーム選択を選択する

      1d. ユニバーサルリンクを選択する。

      1e. iOSアプリの短いユニバーサルリンクトークンを選択します。この例では、短いユニバーサルリンクトークンをu7f3.adj.stとします。

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

      2b.データが失われないよう、すべてのカスタムURLをエンコードしなければなりません。エンコードされたURLは次のように表されます。myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion

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

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

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

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

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

       

      Javascriptユニバーサルリンク

      Javascript Universal Link(JSRユニバーサルリンク)で、ユニバーサルリンクがもつ概知の制約を解決することができます。

      Safari以外の環境では、ユニバーサルリンクにリダイレクトされるリンクをクリックしても機能しません。

      この制約を受ける最も一般的な例の1つは、Eメールキャンペーンでの使用です。ユーザーがメールアプリでEメールを開き、端末内のアプリ、またはアプリがない場合はアプリストアにリダイレクトされるリンクをクリックすると、どちらのパスも正常に動作します。しかし、短縮もしくはラッピングされたURLリンクが使用され、それらのリンクからユニバーサルリンクにリダイレクトされる場合、ユニバーサルリンクが機能しません(ユーザーの端末内にアプリがある場合も、ストアに遷移されてしまいます)。

      Adjustでは、一連のリンクがすべて設定通りに動作するよう、Javascriptによるリダイレクトを実装します。アプリ間(アプリからアプリ)のキャンペーンでこのような問題に遭遇した場合は、以下のようにJSRのユニバーサルリンクのパラメータをトラッカーリンクに追加してください。

      https://app.adjust.com/jsr?url=sulink


      例(エンコード後):

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

      上記のソリューションはiOSバージョン11以降に限られます。iOSバージョンが11未満のユーザーで、Safari Webviewを使用するユーザーを対象にする場合、アプリがイントール済であってもストアに遷移されます。 この問題を解決するには、JSRのユニバーサルリンクに以下のフラグを追加してください。adjust_deeplink_js=1

      例:

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

      アプリがインストールされていない場合、ユーザーにエラーメッセージのポップアップが表示され、その後アプリストアにリダイレクトされます(正常に機能しますが、ユーザーはアプリページを開くかどうか質問されます)。

      このトピックについて