Postback 参数
回传是指向指定的 URL(称为回传 URL)发送的请求,该请求可能包含特定参数。 每一场活动最多可以添加五个请求。 要了解更多信息,请查看回传策略。
使用 Analytics module,您可以为追踪器分配回传,并指定何时发送。
Analytics module 支持:
- 关于应用安装的回传数据 (install postbacks)。
- 安装后发生的指定应用事件的回传 (事件回传)。
- Postbacks 在从应用接收电子商务事件时 (电子商务 postbacks)。
- 当从应用接收关于应用内购买的事件时的回传 (购买回传)
- Postbacks 在从应用接收广告展示事件时(广告收入 postbacks)。
以下规则适用:
- 当指定的归因事件(转换)出现时,会发送回传。
- 回传是在归因窗口内发生的事件中发送的,该窗口是在创建转换规则时指定的。
- 发送postbacks时延迟约为5分钟。
- 当收到HTTP状态
200 OK时,就认为已成功发送。 - 如果收到不同的HTTP状态,Analytics module会在接下来的24小时内重新发送postback。 重发会每隔5-10分钟重复。
传输跟踪URL参数
Analytics module 允许在 postback 请求中传递任何 跟踪 URL 参数。 在postback URL或postback主体(对于POST方法)中,用花括号指定跟踪URL中的参数名称:{parameter_name}.
例如,以下参数会在跟踪 URL 中传输:
https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2
要将 value1 和 value2 参数传递到 postback URL,请写出:
https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param}
要使用 POST 方法传递 value1 和 value2 参数,请在请求体中写入以下内容:
{
"某参数": "{custom_parameter}",
"另一个参数": "{another_param}"
}
回传宏
Analytics module 支持系统宏,可以在 postback URL 或 postback 主体(用于 POST 方法)中使用。 这些宏会传递设备、应用、归因点击或展示的信息。 如果AppMetrica无法确定宏的参数值,参数将为空。
有关点击、安装和事件的信息
{adwords_link_id} — Google Ads 和 AppMetrica 链接的 ID。 要了解更多信息,请参见为 Google Ads 广告投放设置跟踪。
{click_id} — 唯一的点击/展示 ID。 宏不适用于未归属的回传。
{match_type} — 点击/展示与安装的关联方式。 Possible values: 来源页面 | 指纹 | 标识符.
{attributed_touch_type} — 广告交互类型。 Possible values: 点击 | 展示.
{transaction_id} — 此事件或安装的 ID。 例如,如果同一设备生成相同的事件,transaction_id 会发生变化。
{click_user_agent} — 点击/展示的用户代理。
{click_datetime} — 点击/展示的日期和时间,格式为RFC3339。
{click_timestamp} — 点击/展示的时间,格式为 Unix 时间戳,单位为秒。
{click_timezone} — 点击/展示的时区,以与 UTC 的秒数偏差表示。
{click_ipv6} — 点击/展示时的 IP 地址,IPv6 格式。 例如,2a02:6b8::40c:6676:baff:fea6:53d8,::ffff:5.255.232.147。
{conversion_datetime} — UTC 转换日期和时间(设备事件),格式为 RFC3339。
{conversion_timestamp} — 转换时间(设备上的事件),格式为 Unix 时间戳,单位为秒。
{conversion_timezone} — 转换时区(用户所在地)。 以与 UTC 时间的差值(单位:秒)格式显示。
{conversion_event_name} — 注册转换的事件名称。
{conversion_event_json} — 嵌套事件属性,格式为。
{install_datetime} — 按 RFC3339 格式表示的安装日期和时间(UTC)。
{install_timestamp} — 安装时间,以 Unix 时间戳格式(秒)。
{install_timezone} — 安装时区(用户所在地)。 格式为与 UTC 时间的差值(以秒为单位)。
{install_ipv6} — 安装时的 IP 地址,采用 IPv6 格式(例如,2a02:6b8::40c:6676:baff:fea6:53d8,::ffff:5.255.232.147)。
{start_datetime} — RFC3339 格式的会话开始日期和时间(UTC)。
{start_timestamp} — 会话开始时间,以 Unix 时间戳格式(秒)。
{start_timezone} — 会话开始的时区,以与 UTC 的秒数偏差表示。
{session_id} — 会话 ID。 仅在特定应用中唯一,appmetrica_device_id、安装以及会话类型(前台/后台)。
设备信息
{adwords_rdid} — Google AID 用于 Android 或 IFA 用于 iOS。 如果Google AID或IFA不可用,则会发送"00000000-0000-0000-0000-000000000000"值。
{appmetrica_device_id} — 由 Analytics module 服务检测到的设备唯一标识符。
{profile_id} — 用户个人资料 ID。 要了解更多信息,请查看用户资料。
{limit_ad_tracking} — 设备上已限制广告跟踪。 它可以取以下值:1(用户禁用了广告识别);0(用户未禁用)。 如果设备支持多个ID(例如Google AID和Huawei OAID),只要其中至少有一个ID可用,值就设为0。
{google_aid} — 设备的 Google AID,以从设备接收的格式显示。
{ios_ifa} — 设备的IFA,以从设备接收的格式显示。
{ios_ifv} — 设备的 IFV,保持从设备接收时的格式。
{oaid} — 设备的华为 OAID,以从设备接收的格式显示。
{windows_aid} — Windows AID,以设备发送的格式接收。
{device_manufacturer} — 由Analytics module服务检测到的设备制造商(例如 Apple 或 Samsung)。
{device_model} — 由Analytics module服务检测到的设备型号(例如,Galaxy S6)。
{device_type} — 由 Analytics module 服务检测到的设备类型。 Possible values: 手机 | 平板电脑 | 混合设备 | 电视.
{device_locale} — 设备上的语言。
{os_name} — 操作系统。 可能的取值:ios | android | windows.
{os_version} — 用户设备操作系统的版本。
{operator_name} — 移动运营商的名称。
{mcc} — 移动国家代码。
{mnc} — 移动网络代码。
应用和操作系统的信息
{app_version_name} — 开发者指定格式的应用版本。
{app_package_name} — Android 的包名或 iOS 的 Bundle ID(例如,ru.yandex.metro)。
{appmetrica_sdk_version} — 已集成到应用中的AppMetrica SDK 版本。
{store_app_id} — 应用 ID(来自 Google Play 或 App Store)。
广告收入事件的宏
{price}: 广告收入。
{currency}: 广告收入的货币。
任何购买的宏
{price} — 购买或产品的成本。
{currency} — 购买所使用的货币。
{product_id} — 购买 product_id. 对于应用内购买,指在 App Store 或 Google Play 创建购买时指定的 ID。 对于电商,指定产品的product_id。
{order_id} — 订单 ID。
仅适用于应用内购买的宏
{inapp_transaction_id} — 唯一的购买ID。
{inapp_validated} — 显示购买是否在 App Store 或 Google Play 中已验证。
{inapp_receipt} — 来自 App Store 或 Google Play 的购买信息。
仅适用于电商购买的宏
{ecom_revenue} — 从完成的购买中获得的总收入。
{ecom_quantity} — 特定产品的数量。
{ecom_product_name} — 产品名称。
{ecom_promocodes} — 已应用促销码。
{ecom_type} — 电子商务事件类型。 可能的值:
1— 查看了页面。2— 查看了列表中的产品。3— 查看了产品详情。4— 已添加到购物车。5— 已从购物车移除。6— 开始结算。7— 已购买。
{ecom_category_path_1} — 产品类别。
{ecom_category_path_2} — 产品类别。
{ecom_category_path_3} — 产品类别。
{ecom_category_path_4} — 产品类别。
{ecom_category_path_5} — 产品类别。
{ecom_category_path_6} — 产品类别。
{ecom_category_path_7} — 产品类别。
{ecom_category_path_8} — 产品类别。
{ecom_category_path_9} — 产品类别。
{ecom_category_path_10} — 产品类别。
如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。