ディープリンクのテスト

マーケティングチームがキャンペーンでディープリンクを実際に使用する前に、テストを行なっていただくことが重要です。テストでは、以下のことを確認してください：

  • ディープリンクが正しく設定されていること。
  • 意図したコンテンツにユーザーを誘導すること。
  • Adjustがディープリンクキャンペーンを計測していること。

事前準備

はじめに、以下の設定を行なってください。

  • Adjust SDK環境をsandboxに設定し、ログレベルをverboseに設定します。
  • Xcodeでアプリをビルドして実行します。
  • サンプルのディープリンクをマーケティングチームから入手します。
    • 例：https://example.com/summer-clothes?promo=beach

テストリンクの作成

ディープリンクの実装をテストするには、テストリンクを作成する必要があります。これを行うには、以下の手順に従ってください。

  1. Adjustにログインします。

  2. Campaign Lab​ で、 カスタムリンク（Custom Links）​ を選択します。

  3. 新規リンク（New link）​ を選択します。

  4. アプリの選択（App selection）​ 画面で、リンクを作成したいアプリを選択します。

  5. リンク構造（Link structure）​ 画面で、トップレベルのチャネルリンクの名前を追加します。 必要に応じて、キャンペーン、アドグループ、クリエイティブのサブレベルを追加してリンク構造を設定します。

  6. ユーザーの 遷移先（User destinations）​ 画面で、以下の情報を入力すると、ディープリンクがリンクに追加されます。

    • iOSアプリスキーム (iOS App Schema)
    • iOSのアプリ画面

  7. アトリビューション設定​ 画面で、 新規ユーザー：アトリビューション（attribution） > クリック（Clicks）​ の下にある 確率的モデリング（probabilistic modeling）​ を ON​ にします。

  8. リンクの確認（Link review）​ 画面で内容を確認し、必要に応じて変更します。

  9. リンクの作成（Create link）​ を選択し、クリックURL、QRコード、リンクトークンを選択します。

例：https://example.go.link/summer-clothes?promo=beach&adj_t=abc123

ダイレクトディープリンクのテスト

次のユニバーサルリンク設定をテストしてください。

  • Adjustユニバーサルリンク
  • メールリダイレクトおよびURL短縮ユニバーサルリンク

ユニバーサルリンクドメインの設定を確認する

重要:
iOSでは、ユニバーサルリンクをブラウザーに直接入力しても、ディープリンクとして開かれません。ユニバーサルリンクはハイパーリンクとしてクリックされる必要があります。

ユニバーサルリンクドメインの設定を確認するには、次の手順に従ってください。

  1. iOSテストデバイスで、ユニバーサルリンクをAppleメモ（Notes ）にペーストします。
  2. Appleメモで、ユニバーサルリンクを長押しし、iOSメニューを開きます。 アプリで開く（Open in your app ）​ オプションが表示されている場合、iOSはアプリとドメインの間で正常に接続を確立できています。

このオプションが表示されない場合は、次の問題を確認してください。

Adjustユニバーサルリンク

メールリダイレクトおよびURL短縮ユニバーサルリンク

アプリでダイレクトディープリンクをテストする

テストデバイスでアプリが閉じている時と、バックグラウンドで動作している時の両方で、ダイレクトディープリンクをテストしてください。

アプリが閉じている時

  1. ユニバーサルリンクをAppleメモ（Notes ）にコピペします。
  2. ホームボタンを2度タップします。アプリが開いている時は、アプリを上にスワイプして閉じます。
  3. Appleメモ​ を開きます。
  4. ユニバーサルリンクをクリックします。

アプリが開き、ディープリンクのコンテンツが表示されるはずです。アプリに正しいページが表示されない場合は、以下を確認してください：

  • ディープリンクのパスまたはパラメーターが正しいことを確認します。 &記号ではなく、 ?記号を2回使用していないかどうかを確認してください。

  • アプリで次のメソッドを介してディープリンクを適切に処理しているかどうかを確認します。

    • アプリでシーンを使用しない - application(_:continue:restorationHandler:)メソッド
    • アプリでシーンを使用する - scene(_:continue:)メソッド

  • コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。

  • ユニバーサルリンクへのリダイレクトを設定している場合、リダイレクトを正しく設定していることを確認します。

  • リンク解析メソッドを正しく設定しているかどうかを確認します。メールリダイレクトドメインまたはURL短縮ドメインをresolveUrlSuffixArrayに追加していることを確認します。

ディープリンクを選択した後、アプリでAdjust SDKのappWillOpenメソッドが呼び出されます。Xcodeのログに次のようなエントリがあることを確認してください。

2022-09-28 09:19:30.873598+0900example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900example[1619:241845]  [Adjust]v: source   deeplink

Xcodeのログにこれらのエントリが見つからない場合は、次のことを確認してください。

  • Adjust SDKで環境をsandboxに、ログをverboseに設定している。

    • Xcodeのログでは、詳細ログは[Adjust]vで判別できます。

  • ディープリンクを受け取るメソッドで、アプリがappWillOpenメソッドを呼び出している。

アプリがバックグラウンドで動作している時

  1. ユニバーサルリンクをAppleメモ（Notes ）にコピペします。
  2. ホームボタンをタップします。
  3. アプリアイコンでアプリを開きます。
  4. ホームボタンを2度タップし、 Appleメモ​ を開きます。
  5. ユニバーサルリンクをクリックします。

アプリでディープリンクのコンテンツが表示されることを確認します。アプリに正しいページが表示されない場合は、以下を確認してください：

  • アプリで次のメソッドを介してディープリンクを適切に処理しているかどうかを確認します。
    • アプリでシーンを使用しない - application(_:continue:restorationHandler:)メソッド
    • アプリでシーンを使用する - scene(_:continue:)メソッド

ディープリンクを選択した後、アプリでAdjust SDKのappWillOpenメソッドが呼び出されます。Xcodeのログに次のようなエントリがあることを確認してください。

2022-09-28 09:19:30.873598+0900example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900example[1619:241845]  [Adjust]v: source   deeplink

Xcodeのログにこれらのエントリが見つからない場合は、次のことを確認してください。

  • Adjust SDKで環境をsandboxに、ログをverboseに設定している。

    • Xcodeのログでは、詳細ログは[Adjust]vで判別できます。

  • ディープリンクを受け取るメソッドで、アプリがappWillOpenメソッドを呼び出している。

カスタムURLスキームを使用したダイレクトディープリンクのテスト

テストデバイスでアプリが閉じているか、またはバックグラウンドで動作しているときに、カスタムURLスキームを使用したダイレクトディープリンクをテストできます。

Appleメモで、ユニバーサルリンクを選択します。アプリが開いてディープリンクコンテンツが表示されることを確認します。

アプリが開かない場合は、次のことを確認してください。

  • XcodeでURLスキームを正しく設定している。
  • アプリのデバッグビルドをテストしている場合は、デバッグまたはリリースのカスタムURLスキームを使用しているかどうかを確認。

アプリで正しいページが表示されない場合は、次のことを確認してください。

  • ディープリンクのパスまたはパラメーターが正しいことを確認します。 &記号ではなく、 ?記号を2回使用していないかどうかを確認してください。

  • アプリで次のメソッドを介してディープリンクを適切に処理しているかどうかを確認します。

    • アプリでシーンを使用しない - application(_:continue:restorationHandler:)メソッド
    • アプリでシーンを使用する - scene(_:continue:)メソッド

  • コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。

ディープリンクを選択した後、アプリでAdjust SDKのappWillOpenメソッドが呼び出されます。Xcodeのログに次のようなエントリがあることを確認してください。

2022-09-28 09:19:30.873598+0900example[1619:241845]  [Adjust]d: Added sdk_click 1
2022-09-28 09:19:30.873782+0900example[1619:241845]  [Adjust]v: Path:      /sdk_click
2022-09-28 09:19:30.873806+0900example[1619:241845]  [Adjust]v: ClientSdk: ios4.32.1
2022-09-28 09:19:30.873824+0900example[1619:241845]  [Adjust]v: Parameters:
[...]
2022-03-15 09:19:30.873956+0900example[1619:241845]  [Adjust]v: source   deeplink

Xcodeのログにこれらのエントリが見つからない場合は、次のことを確認してください。

  • Adjust SDKで環境をsandboxに、ログをverboseに設定している。

    • Xcodeのログでは、詳細ログは[Adjust]vで判別できます。

  • ディープリンクを受け取るメソッドで、アプリがappWillOpenメソッドを呼び出している。

ディファードディープリンクのテスト

テストデバイスでディファードディープリンクをテストするには、以下の手順に従ってください。

  1. アプリをインストールします。
  2. XcodeのログからAdjustデバイスID（ADID）を取得します。例：
2022-09-28 09:19:35.609913+0900example[1619:241847] [Adjust]v: Response: {"app_token":"2eb2na2w54c3","adid":"4446ab34861b99b78ee374c3bd38a350","timestamp":"2022-09-28T00:19:35.841Z+0000","message":"Attribution found","attribution":{"tracker_token":"abc123","tracker_name":"Organic","network":"Organic"}}

  1. テストコンソールを開き、Adjust ADIDを入力して、 デバイスデータの表示（View Device Data）​ を選択します。 TrackerNameがOrganicと表示されることを確認してください。

    • 表示されない場合は、次のステップを繰り返してください：
    1. アプリをアンインストールします。
    2. テストコンソールにて、デバイスデータの削除（FORGET DEVICE）をクリックします。
    3. アプリをインストールします。

  2. アプリをアンインストールします。

  3. テストコンソールにて、デバイスデータを削除します。

  4. ユニバーサルリンクまたはカスタムURLスキームのディープリンクをAppleメモにペーストします。

  5. ディープリンクをクリックします。App Storeにリダイレクトされることを確認します。

  6. ローカルビルドからアプリをインストールします。ストアからアプリをインストールしないでください。

  7. アプリを開きます。このアプリが開いてディープリンクコンテンツが表示されることを確認します。

アプリで正しいページが表示されない場合は、次のことを確認してください。

  • コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。 例：アプリにオンボーディング画面があったり、ユーザーログインが必要な場合でも、ディープリンクを開く前にアプリがこれを処理していない。 ディープリンクを処理する前にオンボーディング画面またはユーザーログインを処理するためのadjustDeeplinkResponseメソッドを実装することが必要な場合があります。

  • アプリのコードが、 adjustDeeplinkResponseメソッドで受信するディープリンクを適切に処理していない。

  • Adjustでインストールがクリックにアトリビュートされていなかったかどうか。 テストコンソールで、 デバイスデータの表示（View Device Data）​ を選択します。 TrackerNameフィールドにテストリンクが表示されることを確認します。 テストを開始する前に、次のことを確認してください。

    • テストリンクで確率的モデリングが有効化されている。
    • テストコンソールで、 TrackerNameがOrganicに設定されている。

  • リンクのフォーマットを確認してください。ユニバーサルリンクには、次のようなリンクを使用できます。 https://example.go.link/summer-clothes?promo=beach&adj_t=abc123

    • カスタムURLスキームのディープリンクには、AdjustリンクURLを作成する必要があります。 ディープリンクの設定方法に従ってください。