Android連携テスト：アドネットワーク向け

テストを開始する前に、前提条件の準備を全て完了してください。

ポストバックを発火させるには：

1. 準備したテスト端末に計測リンクを送信してください。
2. リンクをクリックして、アプリをインストールして起動してください。
   その後、以下のようなインストールデータのページが表示されます。

3. 以下のパラメータを使用して、アトリビューション内容を検証してください。検証がうまく行かない場合には、トラブルシューティングを確認してください。

   1. install_time(インストール時間): 現在の時刻に近い時刻が入ります。タイムゾーンはUTCで記録されます。 
   2. af_status: Non-organic  Non-organicと表示されていない場合、インストールはあなたのメディアソースに紐付けられていません。 
   3. media_source : あなたのアドネットワーク名 
4. In-App Event Testsをタップしてください。
5. Purchase Eventをタップしてください。
   そうすると、購入イベントの確認が表示されます。
6. 最後に以下を確認してください。
   1. インストールと購入イベントのポストバックを受け取ったこと。
   2. イベント名が正しくマッピングされていること。(イベント名をマッピングした場合)
   3. 受け取ったポストバックを正しく取り込めたこと。

パートナー連携テストアプリはGooglePlay上で入手可能で、AppsFlyerのプラットフォームに対してインストールとアプリ内イベントを送信する機能を提供しています。

アプリを初めて開くと、［インストールデータ］のページにAppsFlyer上に記録されたコンバージョンデータが表示されます。また、アプリ内イベントのテストもアプリの画面内で発火可能です。

以下のような機能が利用可能です：

• アプリ内イベントのテスト
  purchase(購入) / login(ログイン) / registration(登録完了)のアプリ内イベントを送信します。各アプリ内イベントをアドネットワーク側のイベント名にマッピングすることで、そのイベント名を使用したポストバックを生成することも可能です。 

以下のいずれかの方法を使って、AppsFlyerの管理画面上で計測リンクを作成してください。

• AppsFlyerの管理画面上で計測リンクを作成する。
• 以下のサンプルリンクを編集する。

管理画面上で計測リンクを作成するには：

1. AppsFlyerにて、トップメニューから マイアプリを選択します。
2. adNetworkTestのアプリを選択してください。
3. AppsFlyerのサイドメニューから 連携 > 連携済みパートナー > アドネットワークを選択 > 計測リンク タブへ移動します。
4. 計測リンクタブ内で、以下に記載されているパラメータを設定してください。必要であれば、任意のパラメータをさらに追加することも可能です。

   パラメーター	値の例	備考
   キャンペーン	c-test-2020-12-20	ポストバック内でテストのデータであることを識別可能な値を設定してください。
   pid	pitestap

5. 後で使用するので、作成した計測リンクをコピーしてください。 

計測リンクのサンプル：

https://app.appsflyer.com/com.appsflyer.adNetworkTest?pid=pitestap_int&c=c-test-2020-12-20
    

あなたのパートナーアカウントで、テストアプリが利用可能かどうかの確認方法： 

1. AppsFlyerのトップメニューから マイアプリへ進んでください。
2. adNetworkTest のAppIDを持つテストアプリが、パートナーアカウント内の利用可能なアプリに表示されているかどうかを確認してください。もし見当たらない場合には、担当PDMまでご連絡ください。 

リターゲティング計測のテストも可能です。計測リンクにパラメータを一つ追加する以外のプロセスはほぼ同じです。

新しい計測リンクを作成して、&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
          

このリターゲティング用のURLを使用して、アプリをインストールしてください。フローは、インストール計測のテストで説明したものと同様です。

管理画面でのリターゲティングコンバージョンの確認

AppsFlyerの管理画面を開いて、左メニューにあるリターゲティングをクリックしてください。リターゲティングCVが管理画面に表示されるまで、最大30分程度お待ちください。

1. AppsFlyerの管理画面で、My Appsのタブに移動してください。
2. adNetworkTestのアプリを選択してください。
3. AppsFlyerのサイドメニューから 連携 > 連携済みパートナー > アドネットワークを選択 > 連携タブへ移動します。
4. ビュースルーアトリビューションがONになっていることを確認してください。
5. インプレッションの計測リンクをコピーしてください。

   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

   パラメータに渡す値を以下のように置き換えてください。

   • pid(YOUR_PID) - AppsFlyerから指定された、あなたのpidを入力してください。(末尾は_intです）
   • c (YOUR_CAMPAIGN) - 任意のキャンペーン名を入力してください。
   • advertising_id（YOUR_GAID）- テスト端末のGAIDを入力してください。
   • af_siteid（YOUR_SITEID）- 任意のサイトIDを入力してください。

   注意：リンク内のパラメータは、テストの目的で使用されている基本的なパラメータです。必要に応じて、計測リンクには他のパラメータも追加することが可能です。

6. テスト端末にビュースルーの計測リンクを送信してください。
7. ブラウザ上でリンクを開いて、アプリをストアからインストールしてください。
8. アプリを起動すると、以下の画面が表示されます。

   

   このメッセージが表示されない場合は、ビュースルーの計測リンクが正しく設定されていることを確認し、アプリを一度アンインストールしてから計測リンクを使用し、テスト端末を用意してアプリを再インストールしてください。

ヒント

より詳細な結果を得るには、計測リンクを使用してインストールのプロセスを繰り返してください。その際、アプリをアンインストールし、リンク内のパラメータ（キャンペーン名やsiteID、advertising_IDなど）を変更し、そのURLをクリックして再度アプリをインストールしてください。

管理画面上でのインストールの確認

アプリをダウンロードして初回起動すると、AppsFlyerの管理画面にその結果が表示されます。

インストールがアプリの管理画面に表示されるまで最大30分ほどかかることがあります。

あなたのアドネットワークにインストールが紐付いているアプリに関するデータがCSVフォーマットで取得可能です。

以下のデータが含まれます：

• インストール
• アプリ内イベント
• リターゲティングコンバージョン
• リターゲティングキャンペーンに紐づくアプリ内イベント

ローデータをエクスポートするには：

1. AppsFlyer管理画面 左メニュー エクスポート > ローデータ出力に移動します。
2. 日付範囲を選択してください。
3. レポートを選択してください。レポートは数分以内にダウンロードされます。

インストールが発生する毎に、サーバーへ送信するポストバックが生成されます。ポストバックURL、その内容とパラメータを確認するには、インストールポストバックのレポートを取得してください。

インストールポストバックのレポートには、Postback Urlという名称のカラム(列)があります。この列に、インストール毎に生成されたポストバックURLが一覧表示されます。

このデータを見て、以下のことを確認してください。

• URLのエンドポイントが正しいものであること
• Postback URLに追加されたパラメータが、AppsFlyerの計測URLに追加されているパラメータと対応していること
• Postback Error Messageの列が空欄であること