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

ライブイベントビューアは、インストールイベントやその他のアプリ内イベントなど、SDKからAppsFlyerに送信されるデータをリアルタイムで表示するテストツールです。キャプチャされた各イベントについて、イベントログと詳細を見ることができます。

ライブイベントビューアでイベントを確認するには：

1. AppsFlyer管理画面 左メニュー 設定 > SDK実装テストへ移動します。

   

2. ライブイベントをクリックします。

   

3. アプリリストで、テストしたいアプリを選択します。
4. テスト端末リストで、アプリのテストに使用するデバイスを選択します。テスト端末がテスト端末として登録されていない場合は、テスト端末を登録・追加から登録することができます。
5. 続行をクリックして、アプリイベントの記録を開始します。

6. アプリを起動し、セッションやアプリ内イベントを生成するためにアプリと通信します。

   

7. イベント項目をクリックすると、右側のパネルにイベントの詳細が表示されます。
8. イベントの記録を停止したい場合は、停止をクリックします。続行する場合は、もう一度開始をクリックします。

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

1. AppsFlyer管理画面 左メニュー 設定 > SDK実装テストへ移動します。 

   

2. 非オーガニックインストールテストをクリックします。

   

3. アプリリストで、テストしたいアプリを選択します。
4. テスト端末リストで、アプリのテストに使用するデバイスを選択します。テスト端末がテスト端末として登録されていない場合は、テスト端末を登録・追加から登録することができます。
5. テストアプリがテスト端末にインストールされている場合は、削除（アンインストール）してください。
6. テスト端末からアプリを削除しましたチェックボックスを選択します。
7. 続行をクリックし、ウィザードの手順に従います。

非オーガニックインストールが記録されない場合は、以下の理由が考えられます：

• IDFAは利用可能な状態だが、テスト端末はテスト端末画面にてこの識別子で登録されていません。
• テスト端末に、テストアプリ以外に1つ以上のアプリがありますが、テスト端末はテスト端末画面でIDFVを使用して登録されていません。
• オーガニックインストールが記録された。
• テストがSDKを含まないバージョンのアプリで実施された。

実装エラーに関しては、デベロッパーと連携してください。

はじめに：

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

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

1. AppsFlyer管理画面 左メニュー 設定 > SDK実装テストへ移動します。

   

2. リターゲティングをクリックします。

   

3. アプリリストで、テストしたいアプリを選択します。
4. テスト端末リストで、アプリのテストに使用するデバイスを選択します。テスト端末がテスト端末として登録されていない場合は、テスト端末を登録・追加から登録することができます。
5. 続行をクリックし、ウィザードの手順に従います。

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

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

1. 次のリンク（AndroidとiOS）をコピーし、以下の変更を行ってください。

   1. app_id の値：AppsFlyerにアプリIDを追加します。 
   2. PIDパラメータ（必須）：インストール先のメディアソース名を指定します。
   3. パラメータ名キャンペーン名を指定します。
   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

   注記：

   テストデバイスを登録 せずにiOSアプリをテストしている場合、テストクリックはFraud 360によって不正としてフラグが立てられる可能性があります。

   このイベントが不正として検出されないようにするには、リンクに以下のクエリーパラメーターを追加してください： pid=”ios_testing”

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

   注記：

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

3. 次のいずれかを実行してください：

   • アプリが公開されている場合は、インストールに進んでください。
   • アプリが保留中の場合、以下のメッセージが表示されます：「お探しのアプリはまだマーケットにありません。」アプリはまだリリースされていないため、計測リンクはどのアプリストアにも遷移しません。ただし、計測リンクはアトリビューション目的では有効なので、以下のようにアプリをインストールしてください：
     • Androidの場合：APKファイル（または開発者向けAndroid Studio）から
     • iOSの場合：TestFlight（または開発者向けXcode）から

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

   

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

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

1. アプリを起動し、いくつかのアプリ内イベントを実行してください。

2. アプリの管理画面で、イベントページを開いてください。

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

   

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

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

1. AppsFlyer管理画面 左メニューのレポート > ローデータ出力へ移動します。
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の例です：

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

はじめに：

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

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

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

   注記：

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

3. 次のいずれかを実行してください：
   • アプリが公開されている場合は、インストールに進んでください。
   • アプリが承認待ちの場合は、次のようにインストールしてください：
     • Androidの場合：Android StudioまたはAPKファイルからインストールします。
     • iOSの場合：TestFlightからインストールします。
4. アプリのダッシュボードを開き、表示タイプボックスでリターゲティングを選択します。

5. アトリビューションタイプボックスで、リアトリビューションを選択します。

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

   

はじめに：

• リターゲティングテストの設定の手順に従ってください。 
• テスト目的では、セッション間の最小時間を「None」に設定してください。これにより、テスト中にすべてのリエンゲージメントコンバージョンを記録し、成果計測することができます。
• アプリがテストデバイスにインストールされ、数回起動されていることを確認してください。アプリをインストールしたばかりの場合、数分待ってから実行してください。

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

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

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

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

3. アプリを開くには、次のいずれかを実行してください。

   • アプリストアにて、Openをクリックしてください。
   • デバイスからアプリを起動してください。

   ダッシュボードに、メディアソースとキャンペーンに紐づくリエンゲージメントが表示されます。リエンゲージメントが表示されるまで、最大で30分ほどかかります。

   

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

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

1. AppsFlyer管理画面 左メニューのレポート > ローデータ出力へ移動します。
2. リターゲティング のセクションで、 コンバージョン（リエンゲージメント& リアトリビューション） のレポートをダウンロードします。