概览：本文详细介绍可嵌入回传链接中的宏参数，帮助您了解各项宏参数的用途及其对应的数据类型。
以下列出了 Apptrove 提供并支持的回传宏参数。发送回传时，这些宏参数会被替换为对应用户或事件的实际数据。
例如，如需传递安装应用时用户的 IP 地址，可在回传链接中使用 install_ip={install_ip}。其中，等号左侧是接收方使用的参数名称，右侧的 {install_ip} 是 Apptrove 宏参数。
支持的回传宏参数
| 回传宏参数名称 | 说明 | 数据类型 |
|---|---|---|
click_id | 唯一的点击 ID。 | 字符串，例如：664b1b09c8d26f1c5b6360xx |
geo | 地理位置。 | 字符串，例如：IN |
region | 用户所在的地区。 | 字符串，例如：Madhya Pradesh |
city | 城市名称。 | 字符串，例如：Mumbai |
source_ip | 安装来源的 IP 地址。 | 字符串 |
user_agent | 发生点击事件时所使用的浏览器信息。 | 字符串 |
device_model | 用户设备的型号。 | 字符串 |
device_brand | 设备品牌名称。 | 字符串 |
device_language/Locale | 设备内容的显示语言。 | 字符串 |
language | 由设备操作系统设置并由设备报告的语言。 | 字符串 |
platform | 设备平台，例如 iOS、Android 或 Windows Mobile。 | 字符串，例如：ios |
os_version | 操作系统版本。 | 字符串，例如：14 |
sdk_version | 用户设备上运行的软件开发工具包（SDK）版本。 | 字符串，例如：1.6.57 |
app_version | 应用版本。 | 字符串，例如：2.1 |
app_name | 应用名称。 | 字符串 |
bundle_id | 用于在 Apple 生态系统中唯一标识应用的 Bundle ID。 | 字符串，例如：id535886823 |
gaid | Google 广告 ID。 | 字符串 |
idfa | iOS 设备上的广告标识符。 | 字符串 |
oaid | 部分 Android 设备上可由用户重置的标识符，通常用作 GAID 的替代标识符。 | 字符串 |
id_type | Google 广告 ID 和 iOS 标识符的类型。 | 字符串 |
advertising_id_type | 用户可重置的设备标识符类型。 | 字符串 |
click_time | 点击事件的时间戳。 | 整数 |
click_time_unix | 以整数格式发送的点击事件时间戳。 | 整数，原文示例：1716198088.000000 |
p1-p5 | 从发布商端获取值的自定义参数。 | 字符串 |
click_user_agent | 发生点击时所使用的浏览器名称。 | 整数 |
cost | 成本金额。 | 浮点数 |
cost_usd | 以美元计价的成本金额。 | 浮点数 |
cost_currency | 成本所使用的币种。 | 浮点数 |
cost_currency_rate | 成本币种对应的汇率。 | 浮点数 |
install_time | 安装事件的时间戳。 | 整数 |
install_time_unix | 以整数格式发送的安装事件时间戳。 | 整数 |
install_time_micro | 以微秒为单位的安装事件时间戳。 | 整数 |
install_date_ymd | 以年、月、日格式表示的安装日期。 | 日期时间 |
install_ip | 安装事件的 IP 地址。 | 字符串 |
event_id | 与事件关联的唯一 ID。 | 字符串，例如：664b1c6cf7a49c498b180zyx |
event_name | 事件名称。 | 字符串，例如：payment_gateway |
event_revenue_currency | 事件中报告的收入币种代码，或用户选择的币种。 | 浮点数 |
event_revenue | SDK 报告的事件金额，使用 event_revenue_currency 指定的币种或用户选择的币种。 | 浮点数 |
event_revenue_usd | 以美元计价的事件金额。 | 浮点数 |
revenue_currency_rate | 收入币种对应的汇率。 | 原文未注明 |
discount | 与产品或事件关联的折扣。 | 浮点数 |
order_id | 产品订单的 ID。 | 字符串 |
sub1-sub10 | 通过 SDK 一同发送的其他附加参数。 | 字符串 |
sdk_param_1 - sdk_param_10 | 通过 SDK 发送的参数。 | 字符串 |
event_time | 事件发生的时间戳。 | 日期时间 |
event_time_unix | 以整数格式表示的事件时间戳。 | 整数 |
event_time_micro | 以微秒为单位的事件时间戳。 | 字符串 |
event_date_ymd | 以年、月、日格式表示的事件日期。 | 日期时间 |
is_reengagement | 用于判断是否发生再互动。如检测到再互动，则返回 true；否则返回 false。 | 整数 |
event_ip | 事件的 IP 地址。 | 字符串 |
reject_reason | 事件或安装被拒绝的原因。 | 字符串 |
attribution_time | 归因时间。 | 日期时间 |
attribution_time_unix | 以整数格式表示的归因时间。 | 整数 |
is_retargeted | 标识广告活动是否属于再营销。false 表示常规用户获取广告活动；true 表示再营销广告活动。 | 字符串 |
is_attributed | 标识安装或事件是否归因于该媒体来源。 | 整数 |
is_lat | 限制广告跟踪（LAT）标识。iOS：Apple 自 iOS 14 起弃用 LAT，应通过 ATT 判断用户隐私授权状态，并忽略 is_lat。在 iOS 14 之前，若该值为 true，则 IDFA 不可用并被设为 0。Android：该值为 true 表示用户已退出基于兴趣的广告。 | 字符串 |
is_lat_bool | 返回与 is_lat 相同的结果，但采用布尔格式。 | 字符串 |
carrier | 运营商名称，例如 Jio、Airtel。 | 字符串 |
connection_type | 连接类型，例如 Wi-Fi、宽带。 | 字符串 |
isp | 互联网服务提供商名称。 | 字符串 |
customer_user_id | 客户的唯一用户 ID。 | 字符串 |
customer_user_email | 与客户关联的电子邮箱地址。 | 字符串 |
ad | 广告名称。 | 字符串 |
ad_id | 由发布商或广告主提供的广告 ID。 | 字符串 |
ad_group | 广告所属的广告组。 | 字符串 |
ad_set | 由发布商或广告主提供的广告集。广告集中的广告共享投放方式、时间和位置等设置；在广告集层级所做的设置会自动应用于其中的所有广告。 | 字符串 |
ad_group_id | 广告组 ID。 | 字符串 |
ad_set_id | 广告集 ID。 | 字符串 |
camp | 广告活动名称。 | 字符串 |
camp_id | 广告活动 ID。 | 字符串 |
site_id | 用于唯一标识展示广告的发布商的 ID。 | 字符串 |
sub_site_id | 广告子网络或子发布商 ID，适用于主要发布商（site_id）下还有子发布商的情况。 | 字符串 |
channel | 用于应用安装或相关活动的 Google Play 以外的来源，例如 App Store、Samsung Store。 | 字符串 |
ad_type | 广告类型，例如文字、横幅或视频。 | 字符串 |
partner_id | 合作伙伴 ID。 | 字符串 |
partner_name | 合作伙伴名称。 | 字符串 |
gplay_click_time_unix | 以整数格式表示的 Google Play 点击时间戳。 | 整数 |
gplay_download_time_unix | 以整数格式表示的 Google Play 下载时间戳。 | 整数 |
can_claim_attr_bool | 当广告主在应用内事件回传配置中选择“所有媒体来源（All media source）”时，可添加此宏，以 true 或 false 表示是否可认领该归因。 | true 或 false |
联系我们
我们拥有一支经验丰富的专业团队，随时准备处理您的咨询并解答问题。
您可以随时发送电子邮件至 support@apptrove.com，或使用平台内的在线聊天功能与我们联系。我们期待听到您的声音！
