腾讯广点通--点击监测链接使用指南

一. 点击监测链接的作用是什么？

广告主在创建转化归因规则的时候，会在转化id上填写“点击监测链接”，用来接收AMS发出的点击信息。通过约定指定格式的字符串，用以代表将来将要替换的字段位置，这个格式我们统称为“宏”。

二. 点击监测的格式要求

监测链接主要由https://XXXX.XXX.com?+参数。具体格式如下：
(1) 监测链接的前缀格式为：

https://XXX.XXX.com?

(2) 宏“参数”的格式为“__参数__”，其中：

• 参数必须全部大写，广告主可以根据自己的需要选择具体填写哪些参数，AMS支持宏参数请见下方；
• “__参数__”格式中参数两边为双下划线，即参数左右两边均为两个连续的英文字符’_’

• 若为点击监测的回传方式，必选字段

  为“__CALLBACK__”；其他场景“__CALLBACK__”不可选；

(3) 链接可以用http、https开头，不能直接用ip、必须是正式的域名；

三. 点击监测链接示例

1. 广告主填写在转化id创建时的监测链接如下：

https://www.example.com/click/?adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&muid=__MUID__&callback=__CALLBACK__

这里的 “__ADGROUP_ID__ ”，就是一个宏，代表将来真实的ADGROUP_ID 字段会在这里填写。
用户在腾讯的媒体上浏览广告并真实产生了广告点击的时候，我们会把相应的字段换成真实的广告信息，发送给广告主。

2. 广告主收到的真实请求：

https://www.example.com/click/?adgroup_id=228691429&ad_id=251986746&muid=8d3ebd3654fb46a2832296669cf1b536&callback=http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678

其中下划线的部分，就是我们替换后的真实广告信息（非 ASC 字符，进行了 url encode）

四. 点击监测字段列表

注意：callback服务器下发的是 url encode编码原值，直接摘取该字段内容。自归因数据上报时，将callback进行一次 url decode操作后作为post请求url回传至AMS。
存在有些http库会自动进行一次url decode，故在回传数据的时候无需再操作一次decode编译，否则将报错。

五. 字段必填/选填说明

安卓不可选字段：

universal_link / qaid_caa

安卓必填字段：

account_id / click_id / click_time / device_os_type / hash_android_id / hash_oaid / muid / promoted_object_id

安卓A级竞品客户可使用字段：

account_id / agency_id / callback / click_id / click_time / device_os_type / encrypted_position_id / hash_android_id / hash_oaid / impression_id / ip / ipv6 / muid / promoted_object_id / promoted_object_type / user_agent

ios不可选字段：

deeplink_url / hash_android_id / hash_oaid

ios必填字段：

account_id / click_id / click_time / device_os_type / muid / promoted_object_id

iosA级竞品客户可使用字段：

account_id / agency_id / callback / click_id / click_time / device_os_type / encrypted_position_id / impression_id / ip / ipv6 / muid / promoted_object_id / promoted_object_type / qaid_caa / user_agent

网页不可使用字段：

ad_name / campaign_name / deeplink_url / model / promoted_object_id / universal_link

网页必填字段：

account_id / callback / click_id / click_time

网页A级竞品客户可选：

account_id / adgroup_name / agency_id / callback / click_id / click_time / device_os_type / encrypted_position_id / impression_id / ip / ipv6 / qaid_caa / user_agent

六、点击监测链接推荐示例

应用类—Android：

https://www.example.com/click/?account_id=__ACCOUNT_ID__&click_id=__CLICK_ID__&click_time=__CLICK_TIME__&device_os_type=__DEVICE_OS_TYPE__&hash_android_id=__HASH_ANDROID_ID__&muid=__MUID__&hash_oaid=__HASH_OAID__&promoted_object_id=__PROMOTED_OBJECT_ID__&campaign_id=__CAMPAIGN_ID__&adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&ip=__IP__&user_agent=__USER_AGENT__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&callback=__CALLBACK__

应用类—iOS：

https://www.example.com/click/?account_id=__ACCOUNT_ID__&click_id=__CLICK_ID__&click_time=__CLICK_TIME__&device_os_type=__DEVICE_OS_TYPE__&muid=__MUID__&promoted_object_id=__PROMOTED_OBJECT_ID__&campaign_id=__CAMPAIGN_ID__&adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&ip=__IP__&user_agent=__USER_AGENT__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&callback=__CALLBACK__

a级竞品应用类—Android：

https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&muid=__MUID__&hash_android_id=__HASH_ANDROID_ID__&hash_oaid=__HASH_OAID__&ip=__IP__&user_agent=__USER_AGENT__&account_id=__ACCOUNT_ID__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLBACK__

a级竞品应用类—iOS：

https://www.example.com/click/?account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&callback=__CALLBACK__&click_id=__CLICK_ID__&click_time=__CLICK_TIME__&device_os_type=__DEVICE_OS_TYPE__&hash_android_id=__HASH_ANDROID_ID__&hash_oaid=__HASH_OAID__&ip=__IP__&muid=__MUID__&user_agent=__USER_AGENT__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&promoted_object_id=__PROMOTED_OBJECT_ID__