点击监测链接使用指南
1. 点击监测链接的作用是什么？
广告主在创建转化归因规则的时候，会在转化id上填写“点击监测链接”，用来接收AMS发出的点击信息。通过约定指定格式的字符串，用以代表将来将要替换的字段位置，这个格式我们统称为“宏”。
2. 点击监测的格式要求
监测链接主要由https://XXXX.XXX.com?+参数。具体格式如下：
(1) 监测链接的前缀格式为：
https://XXX.XXX.com?(2) 宏“参数”的格式为“__参数__”，其中：
- 参数必须全部大写，广告主可以根据自己的需要选择具体填写哪些参数，AMS支持宏参数请见下方；
- “__参数__”格式中参数两边为双下划线，即参数左右两边均为两个连续的英文字符’_’
- 若为点击监测的回传方式，必选字段为“__CALLBACK__”；其他场景“__CALLBACK__”不可选；
(3) 链接可以用http、https开头，不能直接用ip、必须是正式的域名；
3. 点击监测链接示例
- 广告主填写在转化id创建时的监测链接如下：
https://www.example.com/click/?adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&muid=__MUID__&callback=__CALLBACK__这里的 “__ADGROUP_ID__ ”，就是一个宏，代表将来真实的ADGROUP_ID 字段会在这里填写。
用户在腾讯的媒体上浏览广告并真实产生了广告点击的时候，我们会把相应的字段换成真实的广告信息，发送给广告主。
- 广告主收到的真实请求：
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）
4. 点击监测字段列表
| 所有字段 | 宏定义 | 字段说明 | 枚举值及样例说明 |
|---|---|---|---|
| click_id | __CLICK_ID__ | 点击id | 24oi6xq2aaakvagnqu7a |
| click_time | __CLICK_TIME__ | 点击时间 | 1586437362 |
| campaign_id | __CAMPAIGN_ID__ | 计划id | 102043154 |
| adgroup_id | __ADGROUP_ID__ | 广告组id | 228691429 |
| ad_id | __AD_ID__ | 广告id | 251986746 |
| ad_platform_type | __AD_PLATFORM_TYPE__ | 广告投放平台 | 1: GDT entrance 3: 京东直投 5: 经wechat mp投放的广告 6: 京东运营 8: QQ公众账号平台 9: 移动联盟SSP 10: 58运营 11: 58商户 12: 易车运营 13: 易车商户 14: 融360运营 15: 融360商户 16: 点评运营 17:点评商户 18: 来自OMG的广告主 19: 京东外单 adtype __AD_TYPE_\ 广告类型 1: 普通广告 2: 动态创意广告 3： 聚合页一跳广告 4: 合约CPM广告 5: 动态标题广告 6: 内容化广告 7: 动态元素广告 8: 动态图片广告 9: 动态商品图片广告（枫叶相关） 10: 动态商品文字广告（枫叶相关） 11: 动态商品单商品广告 |
| account_id | __ACCOUNT_ID__ | 广告主id | 9471147 |
| agency_id | __AGENCY_ID__ | 代理商id | 1050262 |
| click_sku_id | __CLICK_SKU_ID__ | 点击sku | 478c4a93a054f7c9087b4ecb1f03f8a1 |
| billing_event | __BILLING_EVENT__ | 计费类型 | 1: CPC 2: CPA 3: CPS 4: CPM 5: CPD |
| deeplink_url | __DEEPLINK_URL__ | 应用直达链接（Android） | tbopen%3A%2F%2Fm.taobao.com%2Ftbopen%2Findex.html%3F%26action%3Dali.open.nav%26module%3Dh5%26bootImage%3D0%26source%3Dtaobaolive%26h5Url%3Dhttp%3A%2F%2Fhuodong.m.taobao.com%2Fact%2Ftalent%2Flive.html%3Fid%3D258690996826 |
| universal_link | __UNIVERSAL_LINK__ | 应用直达链接（iOS） | %25%25universal_link%25%25%3Fallianceid%3D1094307%26sid%3D2603989%26ouid%3Dzaoding2tu2_haogao_ios%26openapp%3D3 |
| page_url | __PAGE_URL__ | 落地页地址 | https%3A%2F%2Fh5.gdt.qq.com%2Fxjviewer%2Fnemo%2F1644609 |
| device_os_type | __DEVICE_OS_TYPE__ | 设备类型 | ios, android |
| process_time | __PROCESS_TIME__ | 请求时间 | 1586437335 |
| promoted_object_id | __PROMOTED_OBJECT_ID__ | 应用id | 1101072624, wx69618ae091cf2c76 |
| promoted_object_type | ____PROMOTED_OBJECT_TYPE__ | 推广类型 | 3: 认证空间——认证空间首页 4: 开放平台PC平台APP——开放平台PC应用 12: 安卓应用 19: Apple App Store——苹果应用 20: 应用宝换量应用 21: 认证空间—日志页 22: 认证空间-嵌入页 23: 微信-关注 25: 京东POP商户直投广告 26: 大众点评商铺 29: 微信–图文 30: 微信–小店 31: 微信–品牌页 32: 京东商品 33: 京东店铺 34: 腾讯课堂 35: 应用宝推广应用 36: 微信卡券 37: QQ公众平台消息广告 38: 外部安卓应用（联盟应用） 39: 微信门店 40: 认证空间视频说说 41: 本地门店 42: 文章商品类型 43: 表单广告 44: NOW直播 45: QQ浏览器小程序 46: 微信小游戏 47: 微信支付代金券 48: Google Play的应用市场，用于海外市场中的广告推广 49: qq小游戏 1000: 腾讯域意外的连接–网站链接 |
| real_cost | __REAL_COST__ | 点击扣费金额 | 130000 |
| request_id | __REQUEST_ID__ | 请求id | vqp7xdombqonw |
| impression_id | __IMPRESSION_ID__ | 曝光id | xkrx5et47h7g401 |
| site_set | __SITE_SET__ | 流量广告版位 | 1. QQ空间 2. 拍拍站内搜索 3. QQ商城 4. 拍拍导购咨询 5. QQ空间搜索 6. 网站联盟 7. 直通车外投 8. 朋友社区 9. QQ客户端 10. 微博 11. QQ团购 12. QQ美食 13. QQ票务 14. QQ音乐 15. 移动联盟 16. QQ网购 18. 第三方流量 19. 腾讯网 20. QQ邮箱 21. 微信 22. 应用宝移动 23. PC联盟 24. 应用宝PC 25. 移动内部广告版位 26. 京东外采流量 27. 腾讯新闻流量 28. 腾讯视频流量 29. 天天快报流量 |
| muid | __MUID__ | 设备id（imei或idfa的加密值） | 对IMEI设备号转成小写，再进行md5编码，再小写，32位 对IDFA 设备号保持大写，进行 md5 编码，再小写，32位 d4b8f3898515056278ccf78a7a2cca2d |
| hash_android_id | __HASH_ANDROID_ID__ | 安卓id做md5加密后小写 | 797745b011e3286de9e1a1c59ba72c97 |
| ip | __IP__ | 媒体投放系统获取的用户终端的公共IPV4地址 | 183.226.102.120 |
| user_agent | __USER_AGENT__ | 用户代理（user_agent） | Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+8.0.0%3B+PIC-AL00+Build%2FHUAWEIPIC-AL00%29 |
| oaid | __OAID__ | Android Q 及更高版本的设备号，64位及以下，原值 | f76b1e7d-fff1-992a-ffbe-fff7f8723c2a |
| callback（自归因api场景必填，其他场景不需要填写） | __CALLBACK__ | 直接提供上报信息回传接口的 url，url encode编码，广告主可以直接使用 | http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678 |
| encrypted_position_id（依据联盟白名单判断） | __ENCRYPTED_POSITION_ID__ | 联盟广告位id | 8144201 |
| ipv6 | __IPV6__ | 媒体投放系统获取的用户终端的公共IPV6地址 | 2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b |
| hash_oaid | __HASH_OAID__ | Android Q 及更高版本的设备号，64位及以下，取原值后做md5加密 | 9d271e4d04de7e4b0b4f1df20e79ce64 |
| adgroup_name | __ADGROUP_NAME__ | 广告名称 | 793546610 |
| site_set_name | __SITE_SET_NAME__ | 版位名称 | 1：QQ 空间，PC 版位 (已废弃) 9：QQ 客户端(已废弃) 14：QQ 音乐，PC 版位 (已废弃) 15：优量汇 103：快手 19：腾讯网，PC 版位 (已废弃) 21：微信 25：QQ、腾讯看点、腾讯音乐 (待废弃) 27：腾讯新闻 28：腾讯视频 29：天天快报 (已废弃) 22：应用宝 104：QQ、QQ 空间、腾讯音乐、PC 版位 100：腾讯看点 101：QQ、腾讯音乐及游戏 102：微信朋友圈 106：微信生态内的小游戏场景 107：手机 QQ 生态内的小游戏场景 108：集合腾讯游戏和优量汇联盟生态的手机端游戏 特别说明：目前 21：微信/106：微信生态内的小游戏场景 统一返回 21：微信 |
| campaign_name | __CAMPAIGN_NAME__ | 计划名称 | 推广品牌活动-公众号互选广告 |
| id_name | __ID_NAME__ | 创意名称 | 推广品牌活动-20201011-图文-中国教育报 |
5. 字段必填/选填说明
安卓不可选字段：
universal_link
安卓必填字段：
click_id / click_time / account_id / device_os_type / promoted_object_id / muid / hash_android_id / oaid / callback
安卓A级竞品客户可使用字段：
click_id / click_time / account_id / agency_id / device_os_type / promoted_object_id / promoted_object_type / impression_id / muid / hash_android_id / ip / user_agent / oaid / callback / ipv6 / hash_oaid / adgroup_name
ios不可选字段：
deeplink_url / hash_android_id / oaid / hash_oaid
ios必填字段：
click_id / click_time / account_id / device_os_type / promoted_object_id / muid / callback
iosA级竞品客户可使用字段：
click_id / click_time / account_id / agency_id / device_os_type / promoted_object_id / promoted_object_type / impression_id / muid / ip / user_agent / callback / ipv6 / adgroup_name
网页不可使用字段：
universal_link
网页必填字段：
click_id / click_time / account_id / device_os_type / promoted_object_id / callback
网页A级竞品客户可选：
click_id / click_time / account_id / agency_id / device_os_type / promoted_object_id / promoted_object_type / impression_id / muid / hash_android_id / ip / user_agent / oaid / callback / ipv6 / hash_oaid / adgroup_name
6、点击监测链接推荐示例
应用类—Android：
https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&campaign_id=_CAMPAIGN_ID__&adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&muid=__MUID__&hash_android_id=__HASH_ANDROID_ID__&oaid=__OAID__&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__&promoted_object_id=__PROMOTED_OBJECT_ID__应用类—iOS：
https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&campaign_id=_CAMPAIGN_ID__&adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&muid=__MUID__&ip=__IP__&user_agent=__USER_AGENT__&account_id=__ACCOUNT_ID__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLBACK__&promoted_object_id=__PROMOTED_OBJECT_ID__a级竞品应用类—Android：
https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&muid=__MUID__&hash_android_id=__HASH_ANDROID_ID__&oaid=__OAID__&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/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&device_os_type=__DEVICE_OS_TYPE__&muid=__MUID__&ip=__IP__&user_agent=__USER_AGENT__&account_id=__ACCOUNT_ID__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLBACK__