概要:AppsFlyer Partner Integrationsアプリでポストバックを発生させ、AppsFlyerとのAndroid連携をテストします。
Android連携テスト
テストでは、以下を行います。
- Android版のAppsFlyer Partner Integrationsアプリを使い、テスト用にアプリをインストールし、購入のアプリ内イベントを発生させます。これにより、指定したエンドポイントにポストバックが送信されます。ログインと登録のアプリ内イベントもテストできます。
- ポストバックを受信したら、自社システムに取り込み、処理できることを確認します。
テストの範囲
以下の表に、設定の組み合わせに応じたテストシナリオを示します。
各シナリオで、インストールとアプリ内イベントをテストできます。アプリ内イベントについては、アプリ内イベントのマッピングを使い、広告主のイベントを自社のイベントに対応付けることができます。
テストの実施
事前準備を済ませてから、以下の各セクションの手順に沿ってテストを実施してください。各テストのセクションには、結果の記録に使用できる表があります。
事前準備
テストを始める前に、以下の準備を済ませてください。
| 事前準備 |
|---|
| Androidテストアプリと自社アカウントの連携を設定します。 |
| テストアプリが自社アカウントに連携されていることを確認します。 |
アプリ内イベントを自社のイベント名にマッピングします。マッピングするイベント名:purchase、login、registration
|
| アトリビューションリンクを準備します。 |
| Androidデバイスでインストールのアトリビューションをテストします。 |
| Androidデバイスでアプリ内イベントのアトリビューションをテストします。 |
| Androidデバイスでリターゲティングのアトリビューションをテストします。 |
インストールのアトリビューションのテスト
ポストバックを発生させるには、次の手順を実行します。
- 事前に準備したアトリビューションリンクをテストデバイスに送信します。
- リンクをクリックし、アプリをインストールして起動します。
[Install Data(インストールデータ)]画面が表示されます。 -
以下のパラメータで、アトリビューションが正しく行われたことを確認します。正しくアトリビューションされていない場合は、トラブルシューティングを参照してください。
-
install_time:現在の時刻に近い値になっていること。時刻はUTCです。 -
af_status: Non-organic:この値になっていない場合、インストールはアトリビューションされていません。 -
media_source:自社のアドネットワークになっていること。
-
- [In-App Event Tests(アプリ内イベントのテスト)]をタップします。
-
[Purchase Event(購入イベント)]をタップします。
購入イベントの確認メッセージが表示されます。 - 以下を確認します。
- インストールと購入のポストバックを受信していること。
- イベント名が正しくマッピングされていること(アプリ内イベントをマッピングした場合)。
- ポストバックを自社システムに取り込み、処理できること。
補足情報と手順
Partner Integrationsテストアプリについて
Partner Integrationsアプリは、Google Playで入手できます。このアプリは、インストールとアプリ内イベントをAppsFlyerに送信します。
アプリを初めて起動すると、[Install Data(インストールデータ)]画面に、AppsFlyerに記録されたコンバージョンデータが表示されます。アプリの画面を操作して、テスト用のアプリ内イベントを発生させます。
以下の機能を利用できます。
-
[In-App Event Tests(アプリ内イベントのテスト)]
purchase、login、registrationのアプリ内イベントを送信します。テストアプリのイベント名を自社のイベント名にマッピングすると、ポストバックに自社のイベント名が設定されます。
アトリビューションリンク
以下のいずれかの方法で、AppsFlyer管理画面からアトリビューションリンクを準備します。
- AppsFlyer管理画面でリンクを生成します。
- 以下のサンプルリンクを編集します。
管理画面でリンクを生成するには、次の手順を実行します。
- AppsFlyerの上部メニューから、[My Apps(マイアプリ)]を選択します。
- adNetworkTestを選択します。
- AppsFlyerのサイドメニューで[Collaborate(連携)] > [Active Integrations(有効な連携)]を選択し、自社のアドネットワークを選んで[Attribution link(アトリビューションリンク)]タブを開きます。
- [Attribution link(アトリビューションリンク)]タブで、表に記載されたパラメータを設定します。必要に応じて、ほかのパラメータも追加できます。アトリビューションリンクへのリンク
パラメータ 設定値の例 補足 キャンペーン c-test-2020-12-20 ポストバックで識別しやすい値を設定します。 PID pitestap - 生成したリンクを、後で使用できるようにコピーします。
アトリビューションリンクの例:
https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=pitestap_int&c=c-test-2020-12-20
テストアプリと自社アカウントの連携の確認
自社アカウントでテストアプリを利用できることを確認するには、次の手順を実行します。
- AppsFlyerの上部メニューから、[My Apps(マイアプリ)]に移動します。
- [Available Apps(利用可能なアプリ)]に、Partner Integrations adNetworkTestアプリが表示されていることを確認します。表示されていない場合は、担当のPartner Development Managerにお問い合わせください。
トラブルシューティング
| 症状 | 原因 / 対処方法 |
|---|---|
| インストール日時が現在の時刻と一致しない |
インストール前にアプリが削除されていませんでした。 アプリを削除し、手順をやり直してください。 |
| メディアソースが自社のアドネットワークになっていない | アトリビューションリンクのpidに、正しい値が設定されていることを確認してください。正しいアトリビューションリンクを使用していることを確認してください。 |
| af_statusがOrganicになっている |
アトリビューションリンクの形式、特にpidの値を確認してください。 |
リターゲティングのアトリビューションのテスト
リターゲティングのアトリビューションもテストできます。手順はほぼ同じですが、アトリビューションリンクにパラメータを1つ追加します。
新しいアトリビューションリンクを生成し、is_retargeting=trueパラメータを追加します。
https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=YOUR_PID&c=YOUR_CAMPAIGN&af_click_lookback=7d
&clickid={clickid}&is_retargeting=true
リターゲティングリンクを使ってアプリをインストールします。手順は、インストールのアトリビューションのテストと同じです。
管理画面でのリターゲティング経由のインストールの確認
AppsFlyer管理画面を開き、左側のメニューで[Re-targeting(リターゲティング)]をクリックします。リターゲティング経由のインストールが管理画面に表示されるまで、最大30分かかります。
ビュースルーアトリビューションのテスト
- AppsFlyerで、[My Apps(マイアプリ)]に移動します。
- adNetworkTestを選択します。
- AppsFlyerのサイドメニューで[Collaborate(連携)] > [Active Integrations(有効な連携)]を選択し、自社のアドネットワークを選んで[Integration(連携)]タブを開きます。
- [Enable view-through attribution(ビュースルーアトリビューションを有効にする)]がオンになっていることを確認します。
- インプレッション用のアトリビューションリンクをコピーします。
https://impression.appsflyer.com/com.appsflyer.adNetworkTest?pid=YOUR_PID&c=YOUR_CAMPAIGN&af_viewthrough_lookback=24h&advertising_id=YOUR_GAID&af_siteid=YOUR_SITEIDパラメータを以下の値に置き換えます。
- YOUR_PID:AppsFlyerから提供されたパートナーID(末尾が_intのID)
- YOUR_CAMPAIGN:任意のキャンペーン名
- YOUR_GAID:Google広告ID
- YOUR_SITEID:任意のサイトID
注意:ここでは、テストに必要な基本的なパラメータをリンクに指定しています。必要に応じて、ビュースルーアトリビューションリンクにほかのパラメータを追加できます。
- ビュースルーアトリビューションリンクをテストデバイスに送信します。
- ブラウザーでリンクを開き、ストアからアプリをインストールします。
- アプリを起動します。
以下の画面が表示されます。このメッセージが表示されない場合は、ビュースルーアトリビューションリンクの形式が正しいことを確認してください。アプリをアンインストールし、新しいテストデバイスでビュースルーアトリビューションリンクを使って再インストールします。
ヒント
より詳しく結果を確認するには、新しいテストデバイスでビュースルーアトリビューションリンクを使い、インストール手順を繰り返してください。アプリをアンインストールし、リンク内のパラメータ(キャンペーン名、af_siteid、advertising_id)を変更してから、URLをクリックして再度インストールします。
管理画面でのインストールの確認
アプリをインストールして起動すると、AppsFlyer管理画面で結果を確認できます。
インストールがアプリの管理画面に表示されるまで、最大30分かかります。
ローデータのエクスポート
インストールが自社のアドネットワークにアトリビューションされたアプリに関するデータを、CSV形式でエクスポートできます。
エクスポートできるデータは、以下のとおりです。
- インストール
- アプリ内イベント
- リターゲティング経由のインストール
- リターゲティングキャンペーン経由でインストールされたアプリのアプリ内イベント
ローデータをエクスポートするには、次の手順を実行します。
- AppsFlyerで、[Report(レポート)] > [Raw data export(ローデータのエクスポート)]に移動します。
- 日付範囲を選択します。
- レポートを選択します。
数分以内にレポートがダウンロードされます。
ポストバックデータの検証
インストールが発生するたびに、ポストバックが自社のサーバーに送信されます。ポストバックURL、その構造、付加されるパラメータを確認するには、[Installation postbacks(インストールポストバック)]レポートをエクスポートします。
[Installation postbacks(インストールポストバック)]レポートには、[Postback URL(ポストバックURL)]列があります。この列には、インストールごとに生成されたポストバックURLが表示されます。
この列のデータを参照し、以下を確認します。
- 送信先のURLが正しいこと。
- URLに付加されたパラメータが、AppsFlyerのアトリビューションリンクに付加したパラメータに対応していること。
- [Postback Error Message(ポストバックのエラーメッセージ)]列が空欄であること。