どのようにお手伝いできますか?

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

  • 更新

概要:アドネットワークは、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 いいえ

以下の値を使用します。

  • text:検索結果など、テキストのみを含む広告ユニット。
  • banner:デバイスの画面の上部または下部に表示される基本的な広告フォーマット。
  • interstitial:コンテンツの切り替わりなどに表示される全画面広告。
  • video:リワード型ではない通常の動画広告。
  • rewarded_video:動画の視聴と引き換えにアプリ内報酬を提供する広告ユニット。
  • playable:アプリの操作を試せるインタラクティブなプレビューを含む広告ユニット。
  • sponsored_content:タイアップ記事などのスポンサーコンテンツ内に含まれるリンク。
  • audio:音声広告。
はい はい
af_adset Link いいえ
  • 広告主またはパブリッシャーが指定します。
  • 広告セットは、キャンペーンと広告の間に位置する階層です。詳細はこちら
はい はい
af_adset_id Link いいえ 広告主またはパブリッシャーが指定します。 はい はい
af_c_id Link いいえ 広告主またはパブリッシャーが指定します。 はい はい
af_siteid Link いいえ
  • 広告を表示したパブリッシャーを識別する一意のID。詳細はこちら
はい はい
af_subsite_id Link いいえ
  • アドネットワークの下位ネットワーク/パブリッシャーのID。
  • メインのパブリッシャー(サイトID)に加えてサブパブリッシャーが存在する場合や、バナー、インタースティシャル、動画など、アプリ内の広告の種類や掲載位置に関する追加情報を含める場合は、af_sub_siteidを使用します。例:af_sub_siteid =ABCD_4567
はい はい
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 はい

設定される値:

  • 1:ATTステータスがauthorizedまたはaf_authorizedの場合。
  • 0:それ以外のATTステータスの場合。 
はい  
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媒体に含まれるかどうかを示します。

  • アトリビューション先には選ばれなかったものの、貢献した上位3媒体に含まれる場合は、is_contrib=1です。
  • アトリビューション先に選ばれた場合は、is_contrib=0です。
  • 貢献した上位3媒体に含まれない場合は、is_contrib=0です。
はい  
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サービスを使用してください。 

ポストバックの例

インストールポストバックの基本的な例

Android iOS
http://YourCompanyDomain.com?site_id=(publisher_id)
&advertising_id=(advertiser_id)&android_id=(android_id)
&install_time=(install_unix_ts)

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

Android iOS
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)

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

イベントのパラメータ:

  • イベント名: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