追踪 URL 的参数

此部分描述了Analytics module跟踪URL的结构和参数。

结构

https://redirect|impression.appmetrica.yandex.com/serve/[tracking ID — The ID of the tracker]

使用 redirect.appmetrica.yandex.com 域名进行点击归因,使用 impression.appmetrica.yandex.com 域名进行展现归因。

Example:

https://redirect.appmetrica.yandex.com/serve/1019409635088005254

redirect.appmetrica.yandex.com — 当前使用的主要域名。 Possible variations:

  • appmetrika.yandex.com
  • appmetrica.yandex.ru
  • appmetrika.yandex.ru

跟踪 URL 可以包含预定义参数,这些参数是跟踪功能正常工作所必需的。 广告系统(Analytics module 合作伙伴)必须通过这些参数传递特定值。 为了简化这个过程,Analytics module 提供了各种媒体源的宏,用于替换参数。 例如:

Analytics module 存储 macros-params,对应 合作伴侣 A:

  • 点击 ID — {transaction_id}
  • Google 广告 ID — {GAID}

生成的跟踪 URL 用于 Partner A:

https://redirect.appmetrica.yandex.com/serve/1019409635088005254?click_id={transaction_id}&google_aid={GAID}

用户必须将此跟踪 URL 提供给伙伴 A。跟踪将自动开始。

参数

参数被分为三类:必需、推荐和可选。 请注意,S2S 调用有额外的参数。

必填

click_id={YOURMACRO}& — 用于传输唯一点击 ID. 用于去重。

用于更精确统计安装的参数。

google_aid={YOURMACRO}& — 来自设备的 Google AID,保持原始格式。

google_aid_sha1={YOURMACRO}& — SHA1 哈希值 of Google AID。

google_aid_md5={YOURMACRO}& — Google AID 的 MD5 哈希值。

ios_ifa={YOURMACRO}& — IFA 以从设备接收的格式显示。

ios_ifa_sha1={YOURMACRO}& — IFA 的 SHA1 哈希。

ios_ifa_md5={YOURMACRO}& — IFA 的 MD5 哈希。

oaid = {YOURMACRO}& — 华为 OAID,保持从设备获取的格式。

oaid_sha1={YOURMACRO}& — SHA1 哈希值,来自华为 OAID。

oaid_md5={YOURMACRO}& — Huawei OAID 的 MD5 哈希。

windows_aid = {YOURMACRO}& — Windows AID 以从设备接收的格式提供。

windows_aid_sha1={YOURMACRO}& — Windows AID 的 SHA1 哈希。

windows_aid_md5={YOURMACRO}& — Windows AID 的 MD5 哈希。

S2S 调用的参数

device_ip={YOURMACRO}& — 设备的URL编码IP地址。 IPv4 和 IPv6 都受支持。

device_ua={YOURMACRO}& — 设备的 URL 编码 User-Agent。

click_timestamp={YOURMACRO}& — UTC 点击时间戳,以秒为单位。

noredirect={YOURMACRO}& — 通知Analytics module点击应被计数,而不重定向到应用商店。 默认值为 1。

要了解有关 s2s 集成的更多信息,请参见S2S 集成。

可选

用于优化广告投放的参数。 传输的参数以树形结构显示在流量来源报告中。

afpub_id={YOURMACRO}& — 伙伴出版商(子伙伴)的 ID。

site_id={YOURMACRO}& — 特定广告位的 ID。

creative_id={YOURMACRO}& — 特定广告牌的 ID。

appmetrica_js_redirect=0& — 禁用 JavaScript 重定向。

自定义参数

为了更好地优化广告投放,广告主和广告网络可以在跟踪 URL 中传输额外的参数。

要发送自定义参数,请将它们添加到跟踪 URL 中。 使用这些参数传输值有多种方式:

  • 手动 — 输入参数值:

    custom_parameter=value&
    
  • 自动 — 在广告网络侧使用宏来自动替换:

    示例参数={CUSTOM_MACRO}&
    

追踪 URL 中列出的所有参数都会以树形结构显示在 流量来源 报告中。

示例

你可以用这些示例进行测试——将宏替换为自己的。 根据需要删除任何不必要、不受支持或可选的参数。

安卓

https://redirect.appmetrica.yandex.com/serve/600573419754384676?click_id={transaction_id}&google_aid={google_aid}&afpub_id={affiliate_id}&custom_price={payout}

iOS

https://redirect.appmetrica.yandex.com/serve/528515824760210044?click_id={transaction_id}&ios_ifa={ios_ifa}&afpub_id={affiliate_id}&custom_price={payout}

将参数发送到postback URL、deeplink和目标URL

要将跟踪 URL 中的参数值传递到 postback URL、deeplink 或目标 URL,请在它们的 URL 中用花括号添加参数名称:{custom_parameter}。 这种方式可以传递任何参数——自定义或预定义的。

如果您使用通用链接作为跟踪 URL,参数会自动传递到深链。

参数传输示例:

到目标 URL

在追踪器设置中编辑目标 URL,以添加传输宏

例如,假设跟踪 URL 包含以下参数:

https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2

要在目标 URL 中传递 value1 和 value2,请按以下方式编辑它:

https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param}
到回传 URL

在追踪器设置中编辑 postback URL,以添加传输宏

例如,假设跟踪 URL 包含以下参数:

https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2

要在 postback URL 中传递 value1 和 value2,请按以下方式编辑它:

https://endpoint.myadnetwork.com?some_parameter={custom_parameter}&another_param={another_param}
转到深链

跟踪 URL 中的参数会以以下方式传递到深链:

到深链

在追踪器设置中编辑深链以添加传输宏

例如,假设跟踪 URL 包含以下参数:

https://redirect.appmetrica.yandex.com/serve/123456?custom_parameter=value1&another_param=value2

要在深链中传递 value1 和 value2,请按以下方式编辑它:

myscheme://custom_parameter={custom_parameter}&another_param={another_param}

了解更多

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

联系支持 为文档提出改进建议
上一篇
下一篇