概要:アドネットワークは、AppsFlyerとの連携において、自社が受け取るポストバックの内容と送信先のエンドポイントを設定できます。ポストバックには、インストール、アプリ内イベント、リエンゲージメントなど、ユーザーのアプリ利用に関する情報が含まれます。
連携済みパートナー向けの関連ポストバックガイド:
アドネットワーク向けポストバック
- ポストバックの設定:設定の変更を希望する場合は、Partner Assistantウィジェットを利用するか、AppsFlyerの担当者(PDM)にお問い合わせください。
- ポストバックの種類:インストール、アプリ内イベント、およびブロックされたインストール・アプリ内イベントのポストバックを利用できます。ブロックの対象は、Protect360で不正と判定されたものや、ターゲティングの検証ルールに違反したものです。
ポストバックのデータソース
| データソース | 説明 |
|---|---|
| アトリビューションリンクのパラメータ |
パートナーがクリックURLやインプレッションURLに指定するパラメータ。 例:アトリビューションリンクのクリックIDパラメータ「&click_id=CLICK_ID」 |
| AppsFlyerに設定されたパートナーID |
パートナーが広告主に提供する一意のID。 例:アプリID、アカウントID、ユーザーID、ネットワークID |
| SDKから取得する情報 |
AppsFlyer SDKがデバイスから取得する情報。 例:ポストバックに「&IDFA=(idfa)」を含めると、iOSのデバイスIDを取得できます。 |
| AppsFlyerプラットフォームで生成される情報 | AppsFlyerプラットフォームで生成される情報。 |
| Protect360と検証ルール | 不正と判定されたインストールや、キャンペーンのターゲティングルールに違反したインストール、およびそれらに紐づくアプリ内イベントに関する情報。 |
ポストバックマクロ
ポストバックに含めたマクロは、対象ユーザーのデータに置き換えられます。たとえば、アプリをインストールしたユーザーのIPアドレスを取得するには、ポストバックの構成にcountry_code=(ip)を含めます。対応するマクロは、以下の表のとおりです。
以下の表の各列は、次の内容を表します。
-
データソース:データの取得元。
- Link:アトリビューションリンク
- SDK:アプリに実装されたAppsFlyer SDK、またはサーバー間通信(S2S)API
- AF:AppsFlyerで処理した後のデータ
- すべて送信:「はい」の場合、ほかのアドネットワークがアトリビューション先となるインストールやイベント、オーガニックのデータも受信できます。つまり、自社がアトリビューション先ではないデータも含まれます。
- [基本]すべてのポストバックに使用するマクロ:インストール、アプリ内イベント、拒否されたイベントのポストバックに使用するマクロです。
- [任意]:列内の記載(拒否されたイベント、アプリ内イベント)に応じて、それぞれのポストバックで使用するマクロです。
インストール・アプリ内イベント・拒否されたイベントのマクロ
| ポストバックマクロ(名前) | データソース | すべて送信 | 説明 | [基本]すべてのポストバックに使用するマクロ | [任意]アプリ内イベント・拒否されたイベント |
|---|---|---|---|---|---|
| advertising_id | SDK | はい | ユーザーがリセットできるデバイスID。GAIDとも呼ばれます。 (sha1-advertiserId)としても取得できます。 | はい | |
| af_ad | LINK | いいえ | 広告主またはパブリッシャーが指定した広告名(詳細はこちら)。 | はい | はい |
| af_ad_id | LINK | いいえ | 広告主またはパブリッシャーが指定します。 | はい | はい |
| af_ad_type | Link | いいえ |
以下の値を使用します。
|
はい | はい |
| af_adset | Link | いいえ |
|
はい | はい |
| af_adset_id | Link | いいえ | 広告主またはパブリッシャーが指定します。 | はい | はい |
| af_c_id | Link | いいえ | 広告主またはパブリッシャーが指定します。 | はい | はい |
| af_siteid | Link | いいえ |
|
はい | はい |
| af_subsite_id | Link | いいえ |
|
はい | はい |
| af_validated | AF | はい | 購入の検証に成功したかどうかを示します。設定される値:trueまたはfalse。 | はい | |
| af_validation_type | AF | はい | 実施された検証の種類を示します。設定される値:roi360_purchase、roi360_subscription、receipt_validation。 | はい | |
| app_id | SDK | はい | アプリから送信されたアプリID。 | はい | |
| app_name | SDK | はい | 広告主が設定したアプリ名。 | はい | |
| app_version | SDK | はい | 開発者がアプリのコード内に設定した、アプリのバージョン名。 | はい | |
| appsflyer_id | SDK | はい | コンバージョン時に記録されるAppsFlyerの一意の識別子。 | はい | |
| att-0-1 | SDK | はい |
設定される値:
|
はい | |
| att-status | SDK | はい |
iOSから報告されるATTステータス。例:authorized、not_determined。 値がなく、空文字列「""」が返される場合もあります。 |
はい | |
| attributed_touch_type | SDK | いいえ | 設定される値:click、impression、TV、pre-install。 | はい | |
| blocked_reason | AF | いいえ | 不正または検証ルールによるブロックの理由。 | いいえ | 拒否されたイベント |
| blocked_reason_value | AF | いいえ | 不正または検証ルールによるブロックの理由を示す値(サイトIDなど)。 | いいえ | 拒否されたイベント |
| blocked_sub_reason | AF | いいえ | 不正または検証ルールによるブロックの詳細理由。 | いいえ | 拒否されたイベント |
| bundle_id | SDK | はい | iOS:単一のアプリ、またはアプリのグループを識別するID(Apple DeveloperのバンドルIDを参照)。Android:アプリ名。 | はい | |
| c | Link | いいえ | 広告主またはパブリッシャーが指定します。 100文字を超えるキャンペーン名は、管理画面で「c_name_exceeded_max_length」と表示されます。 | はい | はい |
| country_code | AF | はい | ISO 3166(alpha-2)に準拠した国コード。例:US、CN。 | はい | |
| event_name | SDK | はい | イベントに付けられた名前。 | いいえ | アプリ内イベント |
| event_revenue | SDK | はい | SDKから報告されたイベント収益。通貨はevent_revenue_currency、またはパートナーが選択した通貨です。 | いいえ | アプリ内イベント |
| event_revenue _currency |
SDK | はい | イベントで報告された収益の通貨コード、またはパートナーが選択した通貨。 | いいえ | アプリ内イベント |
| event_revenue_USD | AF | はい | 米ドルでのイベント収益。 | いいえ | アプリ内イベント |
| event_time | SDK | はい | イベントの発生日時。 | いいえ | アプリ内イベント |
| event_value | SDK | はい | アプリ内イベントには、値を持つ属性が含まれます。これらはまとめてJSON形式でポストバックに含められます。 (encode)マクロを使用してURLエンコードされます。 | いいえ | アプリ内イベント |
| idfa | SDK | はい | iOSデバイスの、ユーザーがリセットできる広告ID。(sha1-idfa)としても取得できます。 | はい | |
| idfv | SDK | はい | iOSデバイスにおける、ベンダーごとの一意のユーザー識別子。 | はい | |
| imei | SDK | はい | 携帯電話を識別するための一意の番号。 | はい | |
| install_time | SDK | はい | インストールのタイムスタンプ。 | はい | |
| install_unix_ts | SDK | はい | UNIX形式のインストールのタイムスタンプ。 | はい | |
| is_attributed | AF | はい | インストールやイベントのアトリビューション先が当該媒体であるかどうかを示すフラグ。 | はい | |
| is_contrib | AF | はい |
そのアドネットワークが、インストールに貢献した上位3媒体に含まれるかどうかを示します。
|
はい | |
| is_lat | SDK | はい | 広告トラッキングの制限(LAT):iOSでは、AppleがiOS 14以降でLATを廃止しています。ユーザーのプライバシーに関する同意状況は、ATTで判定してください。この場合、is_latは使用しないでください。 iOS 14より前のバージョンでは、値がtrueの場合、IDFAは取得できず、0に設定されます。 Androidでは、値がtrueの場合、ユーザーがインタレストベース広告をオプトアウトしていることを示します。ただし、GAIDの取得ができなくなるわけではありません。 | はい | |
| is_organic | AF | はい |
オーガニックを含むすべての媒体についてインストールポストバックを送信する設定の場合、アドネットワークは、そのインストールがオーガニックか非オーガニックかを確認できます。
|
インストールのみ | |
| is_primary_attribution | AF | はい | falseの場合は、is_retargetingを参照してください。 | いいえ | アプリ内イベント |
| is_reinstall | AF | はい | trueの場合、イベントは再インストールとして報告されます。 | ||
| is_retargeting | Link | いいえ |
is_primary_attributionと組み合わせて使用します。リターゲティングイベントのダブルアトリビューションの詳細を参照してください。 true(1)の場合、そのイベントはリターゲティングキャンペーンのデータとして報告され、媒体はリターゲティング媒体を示します。 false(0)で、かつis_primary_attributionもfalseの場合、そのイベントはリターゲティングキャンペーンのデータですが、記載される媒体はユーザーのアトリビューション先の媒体です。
|
いいえ | |
| language | SDK | はい | デバイスOSで設定され、デバイスから報告される言語(ロケール)。 | はい | |
| oaid | SDK | はい | 一部のAndroidデバイスで、通常GAIDの代わりに使用される、ユーザーがリセットできるID。 | はい | |
| partner_event_id | AF | はい | パートナー側のイベント名/ID。 | いいえ | アプリ内イベント |
| platform | SDK | はい | デバイスのプラットフォーム:iOS、Android、Windows Mobile。 | はい | |
| retargeting_conversion_type | AF | いいえ | リアトリビューションかリエンゲージメントかを示すフラグ。 | リターゲティングのみ |
アプリ内イベント専用のマクロ
以下は、パートナーが利用できるアプリ内イベントポストバックの例です。
例
特定のaf_purchaseイベントについて、イベントポストバックのテンプレート「&event=(event)&json=(encode)」は、次のポストバックに置き換わります。
&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
このポストバックのJSONをデコードすると、以下のようになります。
{"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=(advertiser_id)&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)¤cy=(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)¤cy=(currency)&json=(event_value)
アプリ内イベントポストバックの例
イベントのパラメータ:
- イベント名:af_revenue
- イベント収益:120.00
- イベントの通貨:USD
- イベントの値:{"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