マーケティング担当者向けのSDK実装テスト

iOS 14.5以降、IDFAは、AppTransparency Tracking (ATT)のポップアップでユーザーが同意した場合にのみ利用できます。ATTポップアップがアプリに実装されている場合、同意ユーザーおよび非同意ユーザーとしてテストを実施することが可能です。詳細は、IDFAまたはIDFVでテストデバイスを登録するためのガイドラインをご覧ください。

まずは、オーガニックインストールでテストすることをお勧めします。

オーガニックインストールのテスト方法：

1. テスト用に登録した端末上で、アプリをインストールしてください。
2. アプリを起動します。

新規オーガニックインストールが、アプリのオーバービュー画面上に表示されます。インストールが表示されるまで、最大で30分ほどかかります。

SDK実装テストページを使用して、非オーガニックインストール、アプリ内イベント、ディープリンク（リターゲティング）をテストし、プロジェクトでの連携に関する問題点を確認します。

はじめに：

1. まず、アプリがインストールされていない端末 (iOS / Android) を準備してください。必要に応じて、事前にアプリは端末からアンインストールしておいてください。
2. 端末をテスト端末として登録してください。

ステップ1：非オーガニックインストールのテスト

1. 管理画面で、アプリを選択します。
2. インテグレーション > SDK実装テストへ移動します。
   SDK実装テストのページが表示されます。
   
3. 非オーガニックインストールテストを実行してください。
4. テストデバイスを選択してください。
5. アプリをインストールするストアを選択してください。
   • Androidの場合：
     • Google Play
     • その他（例：外部ストア、Android Studio、APKファイル）
   • iOSの場合：
     • App Store
     • その他（例：Xcode、TestFlight）
6. テスト端末に登録した端末でQRコードをスキャンし、表示された指示に従ってください。
7. その他を選択した場合、開発環境からアプリをインストールしてください。
8. テストが成功したことを示す、SDK 実装テストページに非オーガニックインストールが記録されるまで待ちます。これには最大2分程度かかります。

   

   非オーガニックインストールが記録されない場合は、以下の理由が考えられます。
   • IDFAが登録されていないiOS 14以降のデバイスでテストを実行した。
   • オーガニックインストールが記録された。
   • テストがSDKを含まないバージョンのアプリで実施された。

実装エラーに関しては、ディベロッパーにお問合せください。

ステップ2：アプリ内イベントのテスト

はじめに：

• 非オーガニックインストールを記録したときと同じテスト端末を使用してください。

1. アプリ内イベントテストを実行してください。
2. テストデバイスを選択して、次へをクリックしてください。
3. アプリを起動し、実装したアプリ内イベントを発火させてください。
4. これらのイベントがリアルタイムで登録されると、ログが表示されます。

   

ステップ3：ディープリンク（リターゲティング）のテスト

はじめに：

• 非オーガニックインストールを記録したときと同じテスト端末を使用してください。
• テストアプリを最低3回起動してください。
• ディープリンク（リターゲティング）をテストするには、OneLinkがアプリで設定されている必要があります。詳細については、OneLink設定ガイドを参照してください。
• リターゲティング計測が有効になっていることを確認してください。

1. ディープリンクテストを実行してください。
2. テストデバイスを選択してください。
3. テストタイプを選択してください。
   • OneLink：OneLinkを選択してください。
   • URIスキーム：URIスキームを入力してください（例：greatapps://cars）。
4. [次へ] をクリックします。
5. テスト端末に登録した端末でQRコードをスキャンし、表示された指示に従ってください。テストが終了すると、「Deep Linking Test」が成功したテストとして管理画面上に登録されます。

   

インストールのテストでは、AppsFlyerのSDKがインストールを各メディアソースに正しく紐づけることができるかどうかを検証できます。

インストール計測のテスト方法：

1. 次のリンク（AndroidとiOS）をコピーし、以下の変更を行ってください。
   1. app_id の値：AppsFlyerに登録しているアプリIDを追加してください。
   2. pid パラメーター：インストールを計測するメディアソース名を指定してください。
   3. c パラメーター：キャンペーン名を指定してください。
   4. サードパーティの Androidアプリストアで利用可能なアプリをテストする場合は、計測リンクに af_r のパラメーターを追加してください。 
   5. GAID、IDFA、IDFVをご使用のデバイスの識別子に置き換えてください。
   Android iOS

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   具体的な値を持つ計測リンクの例を以下に示します。

   Android iOS

   
   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   
   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

2. 変更したリンクをコピーし、テストデバイスに送信し、リンクをクリックしてください。

    注意

   iOSでは、iMessengerまたはEメールを使用して、デバイスにリンクを送信してください。なお、iOS Noteアプリにリンクを貼り付けてクリックするのは避けてください。この方法では、リンクが機能しません。

3. 次のいずれかを実行してください：
   • アプリが公開されている場合は、インストールに進んでください。
   • アプリが承認待ちの場合は、次のメッセージが表示されます：「The app you are looking for is not available in the market yet」。これは期待どおりの結果です。アプリはまだリリースされていないため、計測リンクはどのアプリストアにも遷移しません。ただし、計測リンクは計測目的では機能していますので、次のようにアプリをインストールしてください。
     • Androidの場合：Android StudioまたはAPKファイルから
     • iOSの場合：TestFlightから

   メディアソース名Test のテストキャンペーンにインストールが計測されていることを確認できるはずです。インストールがアプリの管理画面に表示されるまで最大30分ほどかかることがあります。

ヒント！インストールローデータレポートをダウンロードし、正しくインストールが紐づいていることを確認してください。このレポートはダウンロードするのに数分かかる場合があります。

レポートをダウンロードする方法：

1. 管理画面にて、レポート > データエクスポートへ進んでください。
2. ローデータレポートセクションにて、インストールローデータレポートをダウンロードしてください。

アプリ内イベントをテストすることで、イベントに関連した収益が表示されていることや、アプリ内イベントがインストール成果のあるメディアソースに紐づいていることを確認することができます。

アプリ内イベント計測をテストする方法：

1. アプリを起動し、いくつかのアプリ内イベントを実行してください。
2. アプリの管理画面で、イベントページを開いてください。

   アプリ内イベント、収益（収益が関連付けられている場合）、および関連付けられているメディアソースが表示されます。管理画面にイベントが表示されるまでには最大60-70分かかる場合があります。

   

ヒント！アプリ内イベントローデータレポートをダウンロードし、正しくイベントが紐づいていることを確認してください。このレポートはダウンロードするのに数分かかる場合があります。

レポートをダウンロードする方法：

1. 管理画面にて、レポート > データエクスポートへ進んでください。
2. ローデータレポートセクションにて、アプリ内イベントのローデータレポートをダウンロードください。

OneLinkを使用すると、iOSとAndroidの両方に単一の計測リンクを設定できます。OneLinkがユーザーの端末を認識し、該当するアプリストアにユーザーをリダイレクトします。

OneLinkはディープリンクも可能にします。ディープリンクを使用すると、カスタマイズコンテンツを配信するために、特定のアプリアクティビティをアプリで開くことができます。

詳細については、OneLink URLのテストに関するガイドを参照してください。

リターゲティング計測は、ユーザーがリターゲティング計測リンクをクリックして、リターゲティングキャペーンとエンゲージした際に発生します。その結果、リアトリビューションやリエンゲージメントイベントが発生します。詳細については、リターゲティング計測ガイドをご覧ください。

リターゲティングテストには次のようなものがあります。

• リアトリビューションの場合：アプリをアンインストールし再度インストールします。その後、管理画面上でインストールが記録されているのを確認します。
• リエンゲージメントの場合：リターゲティングの計測リンクまたはディープリンクをクリックし、その後正しいメディアソースにリエンゲージメントが計測されていることを確認します。

リターゲティングテストを実行する前に、以下の設定が必要です。

• テストするアプリでリターゲティングが有効になっている必要があります。
• アプリ固有のリンクを作成するか、OneLinkのカスタムリンクを取得してください。これらのリンクにはリターゲティングパラメーターが含まれている必要があります。

リターゲティングテストの設定方法：

1. アプリ設定で、リターゲティングを有効にしてください。

   アプリの管理画面から、アプリ設定をクリックし、リターゲティング計測を有効にするをオンにしてください。

   

2. 以下を実行してください。
   • アプリ固有の計測リンクを作成してください。リターゲティングパラメーターである is_retargeting=true と広告IDを必ず入れてください。GAID、IDFA、IDFVを表示するには、テストデバイスの登録の手順に従ってください。
     以下は、端末の識別子（GAID）としてAndroid固有のパラメータを含む計測リンクの例を示しています。IDFAやIDFVなどその他のデバイス識別子パラメーターを追加する詳細に関しては、計測リンクの構成とパラメーターを参照してください。

     
     https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

   • OneLinkテンプレートからカスタムリンクのロングURLを取得してください。リターゲティングキャンペーンをアクティベートしていることを確認してください。次の画像は、カスタムロングURLの例です。

     

これで、リアトリビューションとリエンゲージメントのテストに進むことができます。

はじめに：

• リターゲティングテストの設定の手順に従ってください。
• テストデバイスが登録されていないことを確認してください。

リアトリビューションのテスト方法：

1. デバイスからアプリをアンインストールします。アプリをインストールしたばかりの場合、数分待ってから実行してください。
2. OneLink テンプレートのアプリ固有の計測リンクまたはカスタムロングリンクのいずれかの先に作成した計測リンクをコピーし、テストデバイスに送信し、リンクをクリックします。

    注意

   iOSでは、iMessengerまたはEメールを使用して、デバイスにリンクを送信してください。なお、iOS Noteアプリにリンクを貼り付けてクリックするのは避けてください。この方法では、リンクが機能しません。

3. 次のいずれかを実行してください：
   • アプリが公開されている場合は、インストールに進んでください。
   • アプリが承認待ちの場合は、次のようにインストールしてください。
     • Androidの場合：Android Studio または APKファイルからインストールしてください。
     • iOSの場合：TestFlightからインストールしてください。
4. アプリの管理画面を開き、左側メニューのリターゲティングをクリックしてください。

   メディアソースTestキャンペーン名Testの下にインストールが表示されます。リターゲティングされたインストールが管理画面に表示されるまで最大30分程度お待ちください。

   

ヒント！ インストールが正しいメディアソースに帰属していることを確認するために、コンバージョンに関するローデータレポートをダウンロードしてください。このレポートはダウンロードするのに数分かかる場合があります。

レポートをダウンロードする方法：

1. 管理画面にて、レポート > データエクスポートへ進んでください。
2. リターゲティング のセクションで、 コンバージョン（リエンゲージメント& リアトリビューション） のレポートをダウンロードします。

はじめに：

• リターゲティングテストの設定の手順に従ってください。
• テスト目的では、セッション間の最小時間を「None」に設定してください。これにより、テスト中にすべてのリエンゲージメントコンバージョンを記録し、成果計測することができます。

  

• アプリがテストデバイスにインストールされ、数回起動されていることを確認してください。アプリをインストールしたばかりの場合、数分待ってから実行してください。

リエンゲージメント（直接ディープリンク）のテスト方法：

アプリがディープリンク用に設定されていることを確認してから、この手順 を実行してテストしてください。

リエンゲージメント（直接ディープリンク）のテスト方法：

1. アプリ固有の計測リンクまたはOneLink テンプレートのカスタムロングリンクのいずれかの、先に作成した計測リンクをコピーしてください。
2. リンクをテストデバイスに送信し、リンクをクリックしてください。
3. アプリを開くには、次のいずれかを実行してください。
   • アプリストアにて、Openをクリックしてください。
   • デバイスからアプリを起動してください。

   管理画面にて、メディアソースTestのキャンペーン名Testの下に計測されたリエンゲージメントが表示されます。リエンゲージメントが表示されるまで、最大で30分ほどかかります。

ヒント！ リエンゲージメントが正しいメディアソースに帰属していることを確認するために、コンバージョンに関するローデータレポートをダウンロードしてください。このレポートはダウンロードするのに数分かかる場合があります。

レポートをダウンロードする方法：

1. 管理画面にて、レポート > データエクスポートへ進んでください。
2. リターゲティング のセクションで、 コンバージョン（リエンゲージメント& リアトリビューション） のレポートをダウンロードします。