ディープリンクをテストする

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

ディープリンクが正しく設定されていること。
意図したコンテンツにユーザーを誘導すること。
Adjustで記録されていること。

事前準備

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

アプリ環境をADJEnvironmentSandboxに設定し、ログレベルをADJLogLevelVerboseに設定します。
Xcodeでアプリをビルドして実行します。
サンプルのディープリンクをマーケティングチームから入手します。

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

テストリンクを作成する

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

Adjustにログインします。
Campaign Lab で、 カスタムリンク（Custom Links） を選択します。
新規リンク（New link） を選択します。
アプリの選択（App selection） 画面で、リンクを作成したいアプリを選択します。
リンク構造（Link structure） 画面で、トップレベルのチャネルリンクの名前を追加します。必要に応じて、キャンペーン、アドグループ、クリエイティブのサブレベルを追加してリンク構造を設定します。
ユーザーの 遷移先（User destinations） 画面で、以下の情報を入力すると、ディープリンクがリンクに追加されます。
- iOSアプリスキーム (iOS App Schema)
- iOSのアプリ画面
アトリビューション設定（Attribution settings） 画面で、 新規ユーザー：アトリビューション（attribution）—> クリック（Clicks） の下にある 確率的モデリング（probabilistic modeling） を ON にします。
リンクの確認（Link review） 画面で内容を確認し、必要に応じて変更します。
リンクの作成（Create link） を選択し、クリックURL、QRコード、リンクトークンを選択します。

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

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

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

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

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

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

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

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

Adjustユニバーサルリンク

マーケティングチームがAdjustダッシュボードでAdjustユニバーサルリンクを有効にしていることを確認します。
Xcodeで Associated Domains の設定を確認します。
- applinks: prefixが存在している必要があります。
- Xcodeでのドメインが、AdjustダッシュボードのAdjust ユニバーサルリンクドメイン または ブランドリンク と一致している必要があります。異なるビルドをテストしている場合（例：デバッグとリリース比較）、全てのビルドでAdjustユニバーサルリンクのドメインまたはブランドリンクを追加することが可能です。
アプリでの次の値がAdjustダッシュボードでの値と一致しているかどうかを確認します。
- App ID prefix
- バンドルID ：デバッグビルドまたはリリースビルドのバンドルIDを使用しているかどうかを確認します。

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

XcodeでAssociated Domainsの設定を確認します。
- applinks: prefixが存在している必要があります。
- Xcodeでのドメインが、パートナーのシステムで設定されているメールリダイレクトドメインまたはURL短縮ドメインと一致している必要があります。
アプリでの次の値が、パートナーのシステムのメールリダイレクトドメインまたはURL短縮ドメインのAASA（Apple-App-Site-Association）ファイルでの値と一致しているかどうかを確認します。
- App ID prefix
- バンドルID ：デバッグビルドまたはリリースビルドのバンドルIDを使用しているかどうかを確認します。
- メールリダイレクトドメイン/URL短縮ドメイン - メールパートナーのシステムでドメインをカスタムドメインとして設定しているかどうかを確認します。

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

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

アプリが閉じている時

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

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

ディープリンクのパスまたはパラメーターが正しいことを確認します。&記号の代わりに?記号を2回使用しているかどうかを確認します。
アプリで次のメソッドを介してディープリンクを処理しているかどうかを確認します。
- アプリでシーンを使用しない場合 ：application(_:continue:restorationHandler:)メソッド
- アプリでシーンを使用する場合 ：scene(_:continue:)メソッド
コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。
ユニバーサルリンクへのリダイレクトを設定している場合、リダイレクトを正しく設定していることを確認します。
リンク解析メソッドを正しく設定しているかどうかを確認します。メールリダイレクトドメインまたはURL短縮ドメインをresolveUrlSuffixArrayに追加していることを確認します。

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

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

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

Adjust SDKで環境をsandboxに、ログをverboseに設定している。
- Xcodeのログで、詳細ログは[Adjust]vで判別できます。
ディープリンクを受け取るメソッドで、アプリがappWillOpenUrlメソッドを呼び出している。

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

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

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

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

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

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

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

Adjust SDKで環境をADJEnvironmentSandboxに、ログをADJLogLevelVerboseに設定している。
- Xcodeのログで、詳細ログは[Adjust]vで判別できます。
ディープリンクを受け取るメソッドで、アプリがappWillOpenUrlメソッドを呼び出している。

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

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

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

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

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

アプリに正しいページが表示されない場合は、以下を確認してください：

ディープリンクのパスまたはパラメーターが正しいことを確認します。&記号の代わりに?記号を2回使用しているかどうかを確認します。
アプリで次のメソッドを介してディープリンクを処理しているかどうかを確認します。
- アプリでシーンを使用しない場合 ：application(_:continue:restorationHandler:)メソッド
- アプリでシーンを使用する場合 ：scene(_:continue:)メソッド
コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。

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

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

Adjust SDKで環境をADJEnvironmentSandboxに、ログをADJLogLevelVerboseに設定している。
- Xcodeのログで、詳細ログは[Adjust]vで判別できます。
ディープリンクを受け取るメソッドで、アプリがappWillOpenUrlメソッドを呼び出している。

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

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

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

XcodeのログからADID（AdjustデバイスID）を取得します。例：

2022-09-28 09:19:35.609913+0900 example[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"}}

アプリをアンインストールします。
テストコンソールを開き、Adjust ADIDを入力して、 デバイスデータの表示（View Device Data） を選択します。TrackerNameがOrganicと表示されることを確認してください。
テストコンソールを使用して、デバイス情報を削除します。
ユニバーサルリンクまたはカスタムURLスキームのディープリンクをAppleメモにペーストします。
ディープリンクを選択します。App Storeにリダイレクトされることを確認します。
ローカルビルドからアプリをインストールします。ストアからアプリをインストールしないでください。
アプリを開きます。このアプリが開いてディープリンクコンテンツが表示されることを確認します。

アプリに正しいページが表示されない場合は、以下を確認してください：

コード内の他のコンテンツがディープリンクに干渉していないかどうかを確認する。例：アプリにオンボーディング画面があったり、ユーザーログインが必要な場合でも、ディープリンクを開く前にアプリがこれを処理していない。ディープリンクを処理する前にオンボーディング画面またはユーザーログインを処理するためのadjustDeeplinkResponseメソッドを実装することが必要な場合があります。
アプリのコードが、 adjustDeeplinkResponseメソッドで受信するディープリンクを処理していない。
Adjustでインストールがクリックにアトリビュートされていなかったかどうか。テストコンソールで、 デバイスデータの表示（View Device Data） を選択します。TrackerNameフィールドにテストリンクが表示されることを確認します。テストを開始する前に、次のことを確認してください。
- テストリンクで確率的マッチングが有効化されている。
- テストコンソールで、 TrackerNameがOrganicに設定されている。