---
metadata:
- name: generator
content: Diplodoc Platform v5.64.0
alternate:
- https://boost.yandex.com/doc/en/analytics/content/mobile-tracking/postback-specification.md
- https://boost.yandex.com/doc/ru/analytics/content/mobile-tracking/postback-specification.md
- https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-specification.md
- href: https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-specification.md
type: text/markdown
title: Markdown version
- href: https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://boost.yandex.com/doc/zh/llms.txt?revision=r21738064
# Postback 参数
回传是指向指定的 URL（称为回传 URL）发送的请求，该请求可能包含特定参数。 每一场活动最多可以添加五个请求。 要了解更多信息，请查看[回传策略](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/policy.md)。
使用 Analytics module，您可以为追踪器分配回传，并指定何时发送。
Analytics module 支持：
- 关于应用安装的回传数据 ([install postbacks](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-quota.md#install-postback))。
- 安装后发生的指定应用事件的回传 ([事件回传](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-quota.md#event-postback))。
- Postbacks 在从应用接收电子商务事件时 ([电子商务 postbacks](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-quota.md#ecommerce-postback))。
- 当从应用接收关于应用内购买的事件时的回传 ([购买回传](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-quota.md#inapp-postback))
- Postbacks 在从应用接收广告展示事件时（[广告收入 postbacks](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/postback-quota.md#adrevenue-postback)）。
以下规则适用：
- 当指定的归因事件（[转换](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/conversions.md)）出现时，会发送回传。
- 回传是在归因窗口内发生的事件中发送的，该窗口是在创建[转换规则](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/conversions.md#add-conversion)时指定的。
- 发送postbacks时延迟约为5分钟。
- 当收到HTTP状态`200 OK`时，就认为已成功发送。
- 如果收到不同的HTTP状态，Analytics module会在接下来的24小时内重新发送postback。 重发会每隔5-10分钟重复。
## 传输跟踪URL参数 {#trackingurl-params}
Analytics module 允许在 postback 请求中传递任何 [跟踪 URL 参数](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/tracking-specification.md)。 在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}"
}
```
## 回传宏 {#macros}
Analytics module 支持系统宏，可以在 postback URL 或 postback 主体（用于 POST 方法）中使用。 这些宏会传递设备、应用、归因点击或展示的信息。 如果AppMetrica无法确定宏的参数值，参数将为空。
### 有关点击、安装和事件的信息 {#events}
`{adwords_link_id}` — Google Ads 和 AppMetrica 链接的 ID。 要了解更多信息，请参见[为 Google Ads 广告投放设置跟踪](https://boost.yandex.com/doc/zh/analytics/content/mobile-tracking/adwords-settings.md)。
`{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`、安装以及会话类型（前台/后台）。
### 设备信息 {#device}
`{adwords_rdid}` — Google AID 用于 Android 或 IFA 用于 iOS。 如果Google AID或IFA不可用，则会发送`"00000000-0000-0000-0000-000000000000"`值。
`{appmetrica_device_id}` — 由 Analytics module 服务检测到的设备唯一标识符。
`{profile_id}` — 用户个人资料 ID。 要了解更多信息，请查看[用户资料](https://boost.yandex.com/doc/zh/analytics/content/data-collection/about-profiles.md)。
`{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}
`{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）。
### 广告收入事件的宏 {#adrevenue}
`{price}`: 广告收入。
`{currency}`: 广告收入的货币。
### 任何购买的宏 {#purchases}
`{price}` — 购买或产品的成本。
`{currency}` — 购买所使用的货币。
`{product_id}` — 购买 `product_id`. 对于应用内购买，指在 App Store 或 Google Play 创建购买时指定的 ID。 对于电商，指定产品的`product_id`。
`{order_id}` — 订单 ID。
### 仅适用于应用内购买的宏 {#inapp}
`{inapp_transaction_id}` — 唯一的购买ID。
`{inapp_validated}` — 显示购买是否在 App Store 或 Google Play 中已验证。
`{inapp_receipt}` — 来自 App Store 或 Google Play 的购买信息。
### 仅适用于电商购买的宏 {#ecommerce}
`{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}` — 产品类别。
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。
联系支持
为文档提出改进建议