At a glance: As an ad network, you can define the content and endpoints of postbacks sent to you as part of your integration with AppsFlyer. Postbacks relate to app user engagement like installs, in-app events, re-engagements, and so on.
Related integrated partner postback guides:
Postbacks for ad networks
- Postback configuration: To request changes to your postback settings, contact integrations@appsflyer.com or your AppsFlyer partner development manager.
- Postback types: Postbacks are available for install and in-app events and blocked install and in-app events (due to fraud identified by Protect360 or in violation of targeting validation rules).
来源 | description |
---|---|
归因链接参数 |
Parameters provided by the partner on click and impression URLs 例如: 追踪链接的点击 ID 参数 -"&click_id=CLICK_ID" |
Partner IDs in AppsFlyer |
Unique IDs provided to the advertiser by the partner Examples: app ID, account ID, user ID, network ID |
SDK derived information |
Information extracted from the device by the AppsFlyer SDK Example: iOS device IDs can be extracted by using "&IDFA=(idfa)" on the postback |
Derived by the AppsFlyer platform |
Information derived by the AppsFlyer platform. |
Protect360 and validation rules | Information about installs identified as fraud and installs violating campaign targeting rules, and their associated in-app events |
回调宏
When included in a postback, macros are replaced with the user-relevant data. For example, to get the IP address of the user installing the app, include country_code=(ip)
in the postback structure. Supported macros supported are listed in the following table:
The columns in the table that follows have the following meaning:
-
Source: Where the data originates from.
- Link: Attribution links
- SDK: AppsFlyer SDK embedded in the app or server-to-server API
- AF: After processing by AppsFlyer
- Send all: If yes, you can receive the data of installs and events attributed to other networks or organic. (Means not attributed to you).
- [Base] Macros for all postbacks: Macros relevant to install, in-app event, and rejected event postbacks
- [Optional] for in-app events and rejected events as indicated in the column (rejected, in-app)
回传宏(名称) | 来源 | 发送全部 | description | [Base] Macros for all postbacks | [Optional] In-app and rejected events |
---|---|---|---|---|---|
advertising_id | SDK | 是 | User-resettable device ID, AKA GAID. Also available as: (sha1-advertiserId) | 是 | |
app_name | SDK | 是 | App name set by the advertiser | 是 | |
appsflyer_id | SDK | 是 | AppsFlyer unique identifier recorded upon conversion | 是 | |
attributed_touch_type | SDK | 否 | Possible values: click, impression, TV, pre-install | 是 | |
blocked_reason | AF | 否 | Fraud/validation rules reason | 否 | Rejected |
blocked_reason_value | AF | 否 | Fraud/validation rules reason value (like site ID) | 否 | Rejected |
blocked_sub_reason | AF | 否 | Fraud/validation rules sub-reason | 否 | Rejected |
bundle_id | SDK | 是 | iOS: Identification to match either a single app or a group of apps in iOS (See Apple developer bundle ID) Android: The app name | 是 | |
country_code | AF | 是 | Country Code using ISO 3166 (alpha-2) Example: US, CN. | 是 | |
event_name | SDK | 是 | 分配给事件的名称 | 否 | 应用内 |
event_revenue_USD | AF | 是 | 事件价值 (美元) | 否 | 应用内 |
event_revenue | SDK | 是 | Event value reported by SDK using event_revenue_currency or currency selected by you. | 否 | 应用内 |
event_revenue _currency |
SDK | 是 | The event revenue currency code reported in the event or the currency selected by you | 否 | 应用内 |
event_time | SDK | 是 | 事件时间 | 否 | 应用内 |
event_value | SDK | 是 | in-app event includes attributes with values, which can be sent entirely on the postback in JSON format. URL encoded using the (encode) macro. | 否 | 应用内 |
idfa | SDK | 是 | User resettable advertising ID found on iOS devices Also available as: (sha1-idfa) | 是 | |
idfv | SDK | 是 | Unique identifier per user per vendor on IOS devices | 是 | |
install_time | SDK | 是 | Install timestamp | 是 | |
install_unix_ts | SDK | 是 | Install timestamp in unix format | 是 | |
is_attributed | AF | 是 | 标记,指示安装或事件是否归因于此渠道 | 是 | |
is_lat | SDK | 是 | Limit ad tracking (LAT): iOS: Starting iOS 14 LAT is deprecated by Apple. Determine user privacy status using ATT. In this case disregard is_lat. Before iOS 14, if true, IDFA is not available and is set to 0. Android: When true, the user has opted-out of interest-based ads. This does not prevent the collection of GAID. | 是 | |
is_primary_attribution | AF | 是 |
If false, see is_retargeting. |
否 | 应用内 |
is_retargeting | 链接 | 否 |
Use in conjunction with is_primary_attribution. Learn more about double attribution of retargeting events. If true (1), the event is reported as part of a retargeting campaign and the media source is the retargeting media source. If false (0) and is_primary_attribution is false, the event is part of a retargeting campaign but the media source referenced is the user attribution media source
|
否 | |
语言 | SDK | 是 | Language (locale) reported by the device and set by the device OS. | 是 | |
oaid | SDK | 是 | 在某些 Android 设备上,用户可重置的 ID 是 GAID 备选 | 是 | |
partner_event_id | AF | 是 | Name/ID of the corresponding event in the partner's platform | 否 | 应用内 |
平台 | SDK | 是 | 设备系统:iOS、Android 或 Windows Mobile | 是 | |
再营销转化类型 | AF | 否 | A flag marking if this is a re-attribution or re-engagement | Retargeting only | |
app_version | SDK | 是 | App version name set by the developer in the app code | 是 | |
app_id | SDK | 是 | The app ID as reported by the app | 是 | |
att-0-1 | SDK | 是 |
Possible values:
|
是 | |
att-status | SDK | 是 |
The ATT status reported by iOS. Like authorized, not_determined. In some cases there is no value and "" is returned. |
是 | |
af_ad | 链接 | 否 |
广告名称(查看更多)-由广告主/发行商提供 |
是 | 是 |
af_ad_id | 链接 | 否 |
由广告商/发行商提供 |
是 | 是 |
af_adset | 链接 | 否 |
|
是 | 是 |
af_adset_id | 链接 | 否 | 由广告商/发行商提供 | 是 | 是 |
C | 链接 | 否 | 广告系列名称-由广告主/发行商提供。名称长度超过100个字符的广告系列在控制面板上会被显示为"c_name_exceeded_max_length" | 是 | 是 |
af_c_id | 链接 | 否 | 由广告商/发行商提供 | 是 | 是 |
af_siteid | 链接 | 否 |
|
是 | 是 |
af_subsite_id | 链接 | 否 |
|
是 | 是 |
af_ad_type | 链接 | 否 |
Use the following naming convention:
|
是 | 是 |
imei | SDK | 是 |
A unique number used to identify mobile phones |
是 |
In-app event only macros
The examples that follow relate to in-app event postbacks available to partners.
示例
事件回传模板 "&event=(event)&json=(encode)" 被转换为特定 af_purchase 事件的以下回传:
&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"}
Encoded values
Postbacks may contain irregular characters, which are not alpha-numerical. To transfer these values correctly via postbacks, AppsFlyer URL-encodes non-alpha-numerical values.
To decode or encode a postback use an encoding web service.
回传示例
一般安装回传示例
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)
In-app event postback example
事件参数:
- Event Name: af_revenue
- Event Revenue: 120.00
- Event Currency: 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