简介
当移动设备用户安装或执行应用内事件时, AppsFlyer 会将回传数据发送到原网络平台或其他网络结点。这些回传数据可能包括各种宏。
-
追踪链接参数
合作伙伴的点击或展示 URL 提供的参数将会包含在回传 URL 内。
例如: 追踪链接的点击 ID 参数 -"&click_id=CLICK_ID" -
AppsFlyer的合作伙伴ID
合作伙伴给到广告主的唯一ID会通过回传发送。
例如: app ID, 账户 ID, 用户 ID, 平台 ID, SDK 密钥等.
-
SDK提供的信息
通过 AppsFlyer SDK 从设备上提取的信息
例如:iOS 设备 ID 在回传中可以用 "&IDFA=(idfa)" 将其提取
重要信息!
要更新回发消息的结构和信息, 广告平台应联系其相关的 AppsFlyer 合作伙伴发展联系人(PDM)
支持的回传 Macros
您可以在下面找到 AppsFlyer 支持的宏的完整列表。这些宏在回传时, 会自动替换为与用户相关的数据。例如, 若想要获取安装用户的 IP 地址只需将 "&ip_address=(ip)" 加入到回传架构中即可。
安装和应用内事件 Macros
Macro | 来源 | description |
---|---|---|
|
SDK |
OS unique identifier. |
|
SDK |
Android GAID 唯一标识符。 |
|
SDK |
Android ID unique identifier. |
|
SDK |
应用 id 的名称 |
|
SDK |
用户在转换时使用的数据连接类型 ("TRUE" 或 "FALSE") |
|
SDK |
安装的 Timestamp (first app open) 在 UNIX 时间 |
|
SDK |
AppsFlyer 归因链接上的点击或曝光时间 |
|
链接 |
AppsFlyer 归因链接发送的广告系列名称 (c =) |
|
链接 |
AppsFlyer 归因链接发送的 Site ID (af _ siteid =) |
|
SDK |
记录转化时两个字符国家/地区代码 |
|
SDK |
转换时记录的用户设备的城市 |
|
SDK |
转换时记录的用户设备的设备品牌 |
|
SDK |
设备的服务提供商 (如 "AT & T") |
|
SDK |
转换时记录的用户设备的 IP |
|
SDK |
转换时记录的用户设备的模型 |
|
SDK |
转换时记录的用户设备上使用的语言 |
|
SDK |
转换时记录的 AppsFlyer 唯一标识符 |
|
SDK |
AppsFlyer SDK 版本 |
|
SDK |
应用开发人员在应用代码中的应用版本设置 |
|
SDK |
User-Agent 的格式(e.g. "Mozilla/5.0 (iPad)" |
|
SDK |
供应商的 ID, 如 iOS 的 IDFV |
|
SDK |
操作系统的版本名称 |
|
SDK |
应用程序的名称 |
|
SDK |
归因匹配类型 (例如 uid (id_matching)、ref (gp_referrer) 和 fp (fingerprint)) |
|
SDK |
Google Play 打开的时间 |
|
SDK |
用户单击在 Google Play 上安装的时间 |
|
SDK |
如果用户选择开启限制广告跟踪 (LAT), 则予以标记。可以是 "真" 或 "假"。 |
仅针对应用内事件的宏
下面的宏仅适用于在应用内 (或服务器到服务器) 事件后,发送给合作伙伴的回传:
Macro | description |
---|---|
|
从应用触发的事件的名称 |
|
合作伙伴平台中相应事件的名称和 ID |
|
事件价值 (美元) |
|
应用程序中配置的以原始货币表示的事件值 |
|
事件货币代码 |
|
应用内事件的时间 |
|
增强的富应用事件包含具有值的属性,这些属性将完全以 JSON 格式回传,且通过(编码)宏进行 URL 编码。 |
示例
事件回传模板 "&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"}
编码值
回传可能会包含不规则字符,即非字母或数字。为了通过回传精确的传输这些值,AppsFlyer URL 在回传中将非字母或数字的值进行加密转化。
如果要对编码的回发进行解码, 或对解码后的回发进行编码, 则可以使用任何免费编码 Web 服务, 比如这个。
回传示例
一般安装回传示例
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)&
device_ip=(ip)&;idfa=(idfa)&install_time=(install-unix-ts)
一般应用内事件回传示例
http://YourCompanyDomain.com?clickid=(clickid)&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