アドネットワーク向けのポストバックマクロ

概要：アドネットワークは、AppsFlyerとの連携の一環として、AppsFlyerから送信されるポストバックの内容とエンドポイントの情報を定義する必要があります。ポストバックは、インストール、アプリ内イベント、リエンゲージメントなど、アプリユーザーのエンゲージメント全般に関連します。

関連する連携済みパートナー向けのポストバックガイド：

• 高プライバシー
  モード
• SKAdNetwork 
• ブロックされたデータのポストバック

アドネットワークへのポストバック

• ポストバックの設定： ポストバック設定の変更をしたい場合には、担当PDMまでご連絡ください。
• ポストバックの種類： ポストバックは、インストールとアプリ内イベント、ブロックされたインストールとアプリ内イベント(Protect360による不正検知、もしくは検証ルールの違反によるもの)において利用可能です。

ポストバックのマクロ

マクロをポストバックに含めることで、ポストバック時に関連するユーザーデータに自動的に置き換えられます。たとえば、インストール時のユーザーのIPアドレスを取得するには、ポストバックURLに"&ip_address=(ip)"を追加します。サポートしているマクロは以下の表を参照してください：

以下の表の各列は、それぞれ以下のような内容で構成されています。

• データソース： データの取得元がどこかを示しています。
  • リンク＝計測リンク
  • SDK＝アプリに実装されているAppsFlyerSDK、もしくはServer-to-ServerのAPI
  • AF＝AppsFlyer側で処理した情報
• Send All："はい"の場合、そのアドネットワークに紐付けられていないインストールとイベントに関するデータ（オーガニックを含む）も受信できるかどうかを示しています。 
• [基本] すべてのポストバック向け：インストール、アプリ内イベント、ブロックされたイベントのポストバックに関連するマクロです。
• [オプション] アプリ内イベントとブロックされたイベント向け：列に記入されているイベント向けのマクロです。(ブロック / アプリ内イベント)

アプリ内イベント専用マクロ

以下の例では、パートナーが利用可能なアプリ内イベントのポストバックについて紹介しています。

&event=af_purchase&json=%7B%22af_quantity%22%3A1%2C%22
af_revenue%22%3A%2212000%22%2C%22af_currency%22%3A%
22USD%22%2C%22af_content_id%22%3A%221107%22%2C%22
af_content_type%22%3A%22default_type%22%7D%0A

{"af_quantity":1,"af_revenue":"12000","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

エンコードされた値

ポストバックに、 英数字以外の特殊文字が含まれる場合があります。ポストバック時にこれらの値を正しく送信するために、AppsFlyerではポストバック内の英数字以外の値をURLエンコードします。

ポストバックをデコード、もしくはエンコードする場合には、各種エンコードのWebサービスを利用してください。

ポストバックの例

一般的なインストールポストバックの例

http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

http://YourCompanyDomain.com?&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install-unix-ts)

一般的なアプリ内イベントのポストバックの例

http://YourCompanyDomain.com?site_id=(publisher_id)&
device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&
install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&
json=(event-value)

http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)
&event_name=(event-name)&currency=(currency)&json=(event-value)

アプリ内イベントのポストバック例

イベントパラメータ：

• イベント名：af_revenue
• イベント収益：120.00
• イベントの通貨設定：USD
• イベントの値(event_value)： {"af_quantity":1,"af_revenue":"120","af_currency":"USD","af_content_id":"1107","af_content_type":"default_type"}

ポストバック：

http://YourCompanyDomain.com?clickid=8594845&site_id=click123&device_ip=
38.166.144.142&advertising_id=121sxxxx-xxxx-xxxx-xxxx-52454bd7500b&
android_id=9aaeecc4455xxxxx&;install_time=1451923560&event_name=af_purchase&
currency=USD&revenue=120.00&json=%7B%22af_quantity%22%3A1%2C%22 />af_revenue
%22%3A%22120.10%22%2C%22af_currency%22%3A%22USD%22%2C%22af_content_id
%22%3A%221107%22%2C%22af_content_type%22%3A%22default_type%22%7D%0A