ディープリンクのテスト

キャンペーンで使用する前にディープリンクをテストして、リンクが正しく設定され、意図したアプリ内コンテンツが開き、Adjustが計測できることを確認します。テストプロセスはリンクのタイプとユーザーシナリオ、例えばユーザーがすでにアプリをインストールしているか、初めてのインストールなのか、リアトリビュートする必要があるかによって異なります。

このガイドでは、以下のテストについて説明します。

  • Adjustのディープリンク
  • ユニバーサルリンク
  • ダイレクトディープリンク
  • ディファードディープリンク
  • リアトリビューション

テスト中に問題が発生した場合は、ディープリンクのよくあるご質問で詳細を確認してください。

事前準備

ディープリンクをテストする前に、このチェックリストを確認してください。

全てのプラットフォームで確認​

  • テストする環境向けの正しいリンクを作成します。
  • 専用のテストリンクを作成して、インストールまたはセッションが期待通りにアトリビュートされたかどうかを明確にします。
  • キャンペーンを実行する環境と同じ環境でテストします。特にJavascriptのユニバーサルリンク（JSR）の場合は、同一環境でテストしてください。

iOSとユニバーサルリンクの場合​

  • リンクが実装されたアプリバージョンをテストします。

    • 例えば、ユニバーサルリンクがデバッグビルドにのみ実装されている場合は、そのビルドでテストします。

  • デバッグ版のiOSアプリをテスト中にAdjustのサポートが必要な場合は、TestFlight版をリリースしてAdjustのサポートチームを招待することを検討してください。

注意:

アプリでAdjustのSDKシグネチャーを使用している場合は、実際のデバイスでテストしてください。SDKシグネチャーを使用しない場合は、エミュレーターを使用してテストできます。

テストページを構築

テスト用のWeb環境でリンクをホストします。簡単なHTMLページにリンクを追加し、テスト用デバイスでそのページを開くことをお勧めします。

これは、ブラウザーのアドレスバーにリンクを直接貼り付けてもユニバーサルリンクが期待通りに機能しないため、SafariまたはChromeで開く必要があるからです。

HTMLの例：

<html lang="en">
   <head>
      <style>
         a {
         font-size: 100px
         }
      </style>
   </head>
   <body>
      <a href="https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion">Deep Link</a>
   </body>
</html>

次のうち、適切なリンクフォーマットを使用してください。

Adjustディープリンクの例：​

<a href="https://app.adjust.com/abc123?deep_link=myamazingapp%3A%2F%2Fsuper%2Fexclusive%2Fpromotion">Deep Link</a>

ユニバーサルリンクの例：​

<a href="https://example.go.link/category/product/67890?adj_t=abc123">Deep Link</a>

テスト方法

テストプロセスは、リンクのタイプとそれが使用されるシナリオによって決まります。例えば、リンクの動作はすでにアプリをインストールしているユーザーの場合と、そうでないユーザーの場合で異なります。

既存ユーザーとしてテストする

このテストを使用して、すでにアプリをインストールしているユーザーの ダイレクトディープリンク​ を確認できます。

  1. テストページを作成します。
  2. ディープリンクまたはユニバーサルリンクをページに追加します。
  3. テスト用デバイスにアプリをインストールします。
  4. アプリを少なくとも1回開きます。アプリにウェルカム画面がある場合はクリアし、必要な場合はログインします。
  5. テスト用デバイスでブラウザーを開き、テストページに移動します。
  6. リンクをクリックします。

期待される結果：​ アプリが自動的に開き、アプリ内の正しい位置に遷移します。これが正しく実行されると、このリンクでキャンペーンを計測できます。

トラブルシューティング

  • アプリは開くものの正しい場所で開かない場合は、アプリがディープリンクパスを正しく処理できるかを確認します。
  • ユニバーサルリンクでアプリが開かない場合、Rawユニバーサルリンクをテストします。404 URL not foundエラーを返した場合は、ユニバーサルリンクの実装構成を再確認してください。

新規ユーザーとしてテストする

このテストを使用して、アプリをインストールしていないユーザーの ディファードディープリンク​ を確認します。ユーザーがアプリをインストールする前にディープリンクをクリックすると、ディファードディープリンクが機能します。ユーザーがアプリをインストールして起動すると、Adjustはディープリンク情報を渡し、アプリが目的のアプリ内画面にユーザーを遷移できるようにします。

  1. アプリがテスト用デバイスにインストールされていないことを確認します。インストールされている場合、アンインストールしてください。
  2. Adjustのテストコンソールからデバイスの情報を消去します。
  3. テスト用デバイスでブラウザーを開き、テストページに移動します。
  4. リンクをクリックします。
  5. アプリストアからアプリをダウンロードし、インストールします。
  6. アプリを開きます。

期待される結果：​ アプリが開くと、ディープリンクで定義されたアプリ内の特定の位置にユーザーが遷移します。

ユニバーサルリンクの場合、関連する広告IDパラメーターを使用してリンクを作成してからテストを実施します。

https://example.go.link/category/product/67890?adj_t=abc123&adj_idfa=8C6CBCOD-5F43-4765-A6E6-84DFF3D24707

最適化されたディファードディープリンクをテストする

最適化されたディファードディープリンクを有効にしている場合は、関連ページの手順に従ってください。

トラブルシューティング

ディファードディープリンクで正しいページが開かない場合は、まず既存ユーザーとして同じリンクをテストします。既存ユーザーでのテストに成功した場合は、ユニバーサルリンクがAppViewのアプリスキームがで正しく機能しているか、また、Adjustのディープリンクのディープリンクパラメーターが途中で切れていないか、正しくエンコードされているかどうかを確認します。

新規ユーザーのテスト後にデバイスをリセットする

ディファードディープリンクのテストを複数回行う場合、テストが終わるたびにデバイスをリセットして、前回テストのクリックやインストール結果が次のテストに影響を与えないようにします。

  1. テスト用デバイスからアプリをアンインストールします。
  2. Adjustから広告IDを消去します。
  3. どのリンクもクリックせずにアプリをインストールします。
  4. Adjustのテストコンソールで、インストールがオーガニックとして表示されていることを確認します。
  5. インストールがオーガニックとして表示されていない場合、手順1〜3を繰り返します。
  6. アプリを再度アンインストールします。
  7. 広告IDをもう一度消去します。

リアトリビューションのテストを実施する

このテストを使用して、特定のディープリンクを通じて既存のユーザーをリアトリビュートできるかどうかを確認します。

  1. テストリンクでリアトリビューションの非アクティブ期間を0日に設定します。
  2. 広告IDパラメーターなしでディープリンクを作成します。
  3. Adjustからテスト用デバイスの広告IDを消去します。
  4. どのリンクもクリックせずにアプリをインストールします。
  5. テスト用デバイスでブラウザーを開き、テストページに移動します。
  6. ディープリンクをクリックします。
  7. Adjustのテストコンソールを使用して、デバイスがテストリンクにアトリビュートまたはリアトリビュートされていることを確認します。
重要:

アプリレベルで非アクティブ期間を変更した場合、テスト終了後に必要な設定に戻してください。