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

検索

分析パートナー向けポストバックマクロ

  • 更新

分析パートナーに送信されるポストバックにマクロを含めることで、必要なアトリビューションデータを取得できます。

分析パートナー向けポストバック

分析パートナーは、AppsFlyerとの連携において、自社が受け取るポストバックの内容と送信先のエンドポイントを設定できます。ポストバックには、インストール、アプリ内イベント、リエンゲージメントなど、ユーザーのアプリ利用に関する情報が含まれます。

  • ポストバックの設定：設定の変更を希望する場合は、Partner Assistantウィジェットでチケットを作成するか、AppsFlyerの担当者（PDM）にお問い合わせください。
  • ポストバックの種類：インストールとアプリ内イベントのポストバックを利用できます。

ポストバックマクロ

ポストバックに含めたマクロは、対象ユーザーのデータに置き換えられます。たとえば、アプリをインストールしたユーザーのIPアドレスを取得するには、ポストバックの構成にcountry_code=(ip)を含めます。対応するマクロは、以下の表のとおりです。

  • データソース：データの取得元。
    • SDK：アプリに実装されたAppsFlyer SDK、またはサーバー間通信（S2S）API
    • AF：AppsFlyerで処理した後のデータ
  • ［基本］すべてのポストバックに使用するマクロ：インストールとアプリ内イベントのポストバックに使用するマクロです。
  • ［任意］：列内の記載に応じて、アプリ内イベントのポストバックに使用するマクロです。

インストール・アプリ内イベントのマクロ

ポストバックマクロ（名前） データソース 説明 ［基本］すべてのポストバックに使用するマクロ ［任意］アプリ内イベント
advertising_id SDK ユーザーがリセットできるデバイスID。GAIDとも呼ばれます。 (sha1-advertiserId)としても取得できます。 はい
event_name SDK イベントに付けられた名前。 はい
event_revenue_USD AF 米ドルでのイベント収益。 はい
event_revenue SDK SDKから報告されたイベント収益。通貨はevent_revenue_currency、またはパートナーが選択した通貨です。 はい
event_revenue_currency SDK イベントで報告された収益の通貨コード、またはパートナーが選択した通貨。 はい
event_time SDK イベントの発生日時。 はい
event_value SDK アプリ内イベントには、値を持つ属性が含まれます。これらはまとめてJSON形式でポストバックに含められます。 (encode)マクロを使用してURLエンコードされます。 はい
partner_event_id AF パートナー側のイベント名／ID。 はい
app_name SDK 広告主が設定したアプリ名。 はい
appsflyer_id SDK コンバージョン時に記録されるAppsFlyerの一意の識別子。 はい
attributed_touch_type AF ビュースルーによるアトリビューションかどうかを示すフラグ（1＝インプレッション、0＝クリック）。 はい
country_code AF ISO 3166（alpha-2）に準拠した国コード。例：US、CN。 はい
idfa SDK iOSデバイスの、ユーザーがリセットできる広告ID。(sha1-idfa)としても取得できます。 はい
idfv SDK iOSデバイスにおける、ベンダーごとの一意のユーザー識別子。 はい
install_time SDK インストールのタイムスタンプ。 はい
install_unix_ts SDK UNIX形式のインストールのタイムスタンプ。 はい
is_lat SDK 広告トラッキングの制限（LAT）：iOSでは、AppleがiOS 14以降でLATを廃止しています。ユーザーのプライバシーに関する同意状況は、ATTで判定してください。この場合、is_latは使用しないでください。 iOS 14より前のバージョンでは、値がtrueの場合、IDFAは取得できず、0に設定されます。 Androidでは、値がtrueの場合、ユーザーがインタレストベース広告をオプトアウトしていることを示します。ただし、GAIDの取得ができなくなるわけではありません。 はい
language SDK デバイスOSで設定され、デバイスから報告される言語（ロケール）。 はい
app_id SDK AppsFlyer内でアプリを識別する一意のID。 はい
app-version-name SDK 開発者がアプリのコード内に設定した、アプリのバージョン。 はい
attributed_touch time AF AppsFlyerがアトリビューション先と判定した接触の時刻。 はい
device_type SDK デバイスの市販モデル名。例：SM-GM284、iPhone7 はい
ip AF イベントを報告したユーザーデバイスのIPアドレス。 はい
match_type AF アトリビューション手法の種類。例：srn、id_matching、probabilistic。 はい
os_version SDK デバイスのOSバージョン。 はい
user_agent SDK URLのユーザーエージェント。 はい
wifi SDK trueの場合、コンバージョン時にWi-Fi接続が使用されていたことを示します。 はい
oaid SDK 一部のAndroidデバイスで、通常GAIDの代わりに使用される、ユーザーがリセットできるID。 はい
platform SDK デバイスのプラットフォーム：iOS、Android、Windows Mobile。 はい
retargeting_conversion_type SDK リアトリビューションかリエンゲージメントかを示すフラグ。 はい
pid AF インストールまたはアプリ内イベントのアトリビューション先となるアドネットワーク。 はい
af_ad Link 広告主またはパブリッシャーが指定した広告名（詳細はこちら）。 はい はい
af_ad_id Link 広告主またはパブリッシャーが指定します。 はい はい
af_adset Link
  • 広告主またはパブリッシャーが指定します。
  • 広告セットは、キャンペーンと広告の間に位置する階層です。詳細はこちら
はい はい
af_adset_id Link 広告主またはパブリッシャーが指定します。 はい はい
c Link 広告主またはパブリッシャーが指定します。 100文字を超えるキャンペーン名は、管理画面で「c_name_exceeded_max_length」と表示されます。 はい はい
af_c_id Link 広告主またはパブリッシャーが指定します。 はい はい
af_siteid Link
  • 広告を表示したパブリッシャーを識別する一意のID。詳細はこちら
はい はい
af_subsite_id Link
  • アドネットワークの下位ネットワーク／パブリッシャーのID。
  • メインのパブリッシャー（サイトID）に加えてサブパブリッシャーが存在する場合や、バナー、インタースティシャル、動画など、アプリ内の広告の種類や掲載位置に関する追加情報を含める場合は、af_sub_siteidを使用します。例：af_sub_siteid =ABCD_4567
 はい はい
af_ad_type Link 以下の値を使用します。
  • text：検索結果など、テキストのみを含む広告ユニット。
  • banner：デバイスの画面の上部または下部に表示される基本的な広告フォーマット。
  • interstitial：コンテンツの切り替わりなどに表示される全画面広告。
  • video：リワード型ではない通常の動画広告。
  • rewarded_video：動画の視聴と引き換えにアプリ内報酬を提供する広告ユニット。
  • playable：アプリの操作を試せるインタラクティブなプレビューを含む広告ユニット。
  • sponsored_content：タイアップ記事などのスポンサーコンテンツ内に含まれるリンク。
  • audio：音声広告。
 はい はい

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

以下は、パートナーが利用できるアプリ内イベントポストバックの例です。

例

特定の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%22af_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 
http://YourCompanyDomain.com?pid=(media_source)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)
iOS 
http://YourCompanyDomain.com?pid=(media source)&device_ip=(ip)&idfa=(idfa)&install_time=(install-unix-ts)

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

Android 
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)&install_time=(install-unix-ts)&event_name=(event-name)&currency=(currency)&json=(event-value)
iOS 
http://YourCompanyDomain.com?pid=(media_source)&device_ip=(ip)&idfa=(idfa)&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?pid=(media_source)&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

Tags