Postback 参数

回传是指向指定的 URL(称为回传 URL)发送的请求,该请求可能包含特定参数。 每一场活动最多可以添加五个请求。 要了解更多信息,请查看回传策略。

使用 Analytics module,您可以为追踪器分配回传,并指定何时发送。

Analytics module 支持:

以下规则适用:

  • 当指定的归因事件(转换)出现时,会发送回传。
  • 回传是在归因窗口内发生的事件中发送的,该窗口是在创建转换规则时指定的。
  • 发送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} — 产品类别。

如果您没有找到所需答案,可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能,请附上截图。

联系支持 为文档提出改进建议