点击监测链接使用指南

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

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

二. 点击监测的格式要求

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

https://XXX.XXX.com?

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

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

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

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

(3) 链接可以用http、https开头，不能直接用ip、必须是正式的域名；使用https的话机器不能有多个域名，不支持sni；

三. 点击监测链接示例

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

网页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

小程序必填字段：

account_id / callback / click_id / click_time

小程序不可使用字段：

hash_android_id / hash_oaid / muid / ip / ipv6 / qaid_caa / user_agent / boost_exp_info / boost_model_id

公众号必填字段：

account_id / callback / click_id / click_time

公众号不可使用字段：

hash_android_id / hash_oaid / muid / qaid_caa / wechat_open_id

企业微信必填字段：

account_id / callback / click_id / click_time

企业微信不可使用字段：

hash_android_id / hash_oaid / muid / qaid_caa / wechat_open_id

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

应用类—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__

七、点击转发的其它功能介绍

1. 修改：目前仅支持修改转化名称和点击监测链接的宏。
   若您要修改转化名称，点击转化名称右边的按钮即可进行修改。
   若您要修改点击检测链接，则点击 详情按钮，点击 点击监测链接 旁边的按钮即可修改。目前仅支持修改宏，不允许修改点击链接域名
   一旦配置信息修改提交成功，联调状态默认为未联调；转化状态为未开启。您需要重新进行联调和开启转化状态。
   如果您的转化生效时未配置点击监测链接，目前暂不支持在修改时在该转化下新增。
2. 删除：您可以通过删除按钮对已有配置进行删除，一旦配置信息删除，系统将停止向您发送对应的点击行为数据。
3. 详情：您可以通过详情按钮查看配置信息，并修改点击检测链接、进行转化联调联调。

八、FAQ

1.获取点击数据后，广告主如何设置归因逻辑：

应用类：

建议广告主按照如下优先级设置自己的归因逻辑：

对于Android系统：

（1）优先使用muid归因

（2）若muid归因失败，使用AndroidID归因

（3）若AndroidID归因失败，使用oaid归因

（4）若oaid归因失败，使用IP+UA归因

对于iOS系统：

（1）优先使用muid归因

（2）若muid归因失败，使用qaid_ caa归因

（3）若qaid_ caa归因失败，使用IP+UA归因

在新版转化归因链路中，API上报必须将click_id放在callback中回传，具体上报方式可在APP转化数据API自归因文档查看。

微信小程序类：

• 对于通过点击下发进行归因的方式：建议通过wechat_open_id进行归因，回传自归因成功的click_id与wechat_openid
• 对于通过落地页参数进行归因的方式：建议通过对应行为发生的小程序参数gdt_vid进行归因，回传全量的gdt_vid中的traceid作为clickid；落地页参数下发可参考：https://ad.weixin.qq.com/guide/679

备注：对于微信小程序，如果通过点击下发和落地页参数同时获取点击信息，不建议通过将点击下发的id信息与gdt_vid信息进行匹配归因（因部分版位拼接的参数id取值逻稍有差异）

2. 对于非OCPX的竞价广告，是否支持用新版转化归因进行点击下发：

新版转化归因的点击下发，需要选择优化目标后，在广告创建流程时绑定转化。目前仅支持应用推广和商品推广场景，对其它场景，不支持用新版转化归因配置点击下发。

应用推广：

⑴ 在转化归因，APP场景下创建转化

⑵在对应转化下填写对应应用ID

⑶选择点击为优化目标，转化联调生效后即可下发

商品推广：

⑴ 在转化归因，WEB场景下创建转化

⑵在对应转化下填写对应落地页域名（如投放原生推广页，域名为https://mp.weixin.qq.com）

⑶选择点击为优化目标，转化联调生效后即可下发

特别说明：仅支持该账户自建的转化，对于从其它广告主账户授权的转化不支持在该种操作下对非ocpx的竞价广告点击下发