AppsFlyer 回传里可用的 Macros

  • 广告网络

简介

当移动设备用户安装或执行应用内事件时, AppsFlyer 会将回传数据发送到原网络平台或其他网络结点。这些回传数据可能包括各种宏。

AppsFlyer 可以发送给广告平台 3 种不同源的回传数据:
  1. 追踪链接参数
    合作伙伴的点击或展示 URL 提供的参数将会包含在回传 URL 内。
    例如: 追踪链接的点击 ID 参数 -"&click_id=CLICK_ID"
  2. AppsFlyer的合作伙伴ID
    合作伙伴给到广告主的唯一ID会通过回传发送。
    例如: app ID, 账户 ID, 用户 ID, 平台 ID, SDK 密钥等.

    ad_network_key.png

  3. SDK提供的信息
    通过 AppsFlyer SDK 从设备上提取的信息
    例如:iOS 设备 ID 在回传中可以用 "&IDFA=(idfa)" 将其提取

 重要信息!

要更新回发消息的结构和信息, 广告平台应联系其相关的 AppsFlyer 合作伙伴发展联系人(PDM)

支持的回传 Macros

您可以在下面找到 AppsFlyer 支持的宏的完整列表。这些宏在回传时, 会自动替换为与用户相关的数据。例如, 若想要获取安装用户的 IP 地址只需将 "&ip_address=(ip)" 加入到回传架构中即可。

安装和应用内事件 Macros

Macro 来源 description

(idfa)

SDK

OS unique identifier.
也是: (sha1-idfa)

(advertiserId)

SDK

Android GAID 唯一标识符。
也是: (sha1-advertiserId)

(android-id)

SDK

Android ID unique identifier.
也是: (sha1-android-id)

(app-id)

SDK

应用 id 的名称

(wifi)

SDK

用户在转换时使用的数据连接类型 ("TRUE" 或 "FALSE")

(install-unix-ts)

SDK

安装的 Timestamp (first app open) 在 UNIX 时间

(click-ts)

SDK

AppsFlyer 归因链接上的点击或曝光时间

(campaign)

链接

AppsFlyer 归因链接发送的广告系列名称 (c =)

(publisher_id)

链接

AppsFlyer 归因链接发送的 Site ID (af _ siteid =)

(country-code)

SDK

记录转化时两个字符国家/地区代码

(city)

SDK

转换时记录的用户设备的城市

(device-brand)

SDK

转换时记录的用户设备的设备品牌

(carrier)

SDK

设备的服务提供商 (如 "AT & T")

(ip)

SDK

转换时记录的用户设备的 IP

(device-model)

SDK

转换时记录的用户设备的模型

(language)

SDK

转换时记录的用户设备上使用的语言

(appsflyer-device-id)

SDK

转换时记录的 AppsFlyer 唯一标识符

(sdk-version)

SDK

AppsFlyer SDK 版本

(app-version-name)

SDK

应用开发人员在应用代码中的应用版本设置

(user-agent)

SDK

User-Agent 的格式(e.g. "Mozilla/5.0 (iPad)"

(vendorId)

SDK

供应商的 ID, 如 iOS 的 IDFV

(os-version)

SDK

操作系统的版本名称

(app-name)

SDK

应用程序的名称

(match-type)

SDK

归因匹配类型 (例如 uid (id_matching)、ref (gp_referrer) 和 fp (fingerprint))

(gp_referrer_click_ts)

SDK

Google Play 打开的时间

(gp_referrer_install_ts)

SDK

用户单击在 Google Play 上安装的时间

(跟踪禁用)

SDK

 

如果用户选择开启限制广告跟踪 (LAT), 则予以标记。可以是 "真" 或 "假"。


仅针对应用内事件的宏

下面的宏仅适用于在应用内 (或服务器到服务器) 事件后,发送给合作伙伴的回传:

Macro description

(event-name)

从应用触发的事件的名称

(mapped-iae)

合作伙伴平台中相应事件的名称和 ID

(monetary)

事件价值 (美元)

(orig-monetary)

应用程序中配置的以原始货币表示的事件值

(currency)

事件货币代码

(timestamp)

应用内事件的时间

(event-value)

增强的富应用事件包含具有值的属性,这些属性将完全以 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 服务, 比如这个

回传示例

一般安装回传示例

Android iOS
http://YourCompanyDomain.com?clickid=(clickid)&site_id=(publisher_id)
&device_ip=(ip)&advertising_id=(advertiserId)&android_id=(android-id)
&install_time=(install-unix-ts)

一般应用内事件回传示例

Android iOS
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)&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
这篇文章有帮助吗?
4 人中有 3 人觉得有帮助

页面内容: