接口文档SDK业务专题开发者工具

点击监测链接使用指南

1. 点击监测链接的作用是什么?

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

2. 点击监测的格式要求

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

https://XXX.XXX.com?

(2) 宏“参数”的格式为“__参数__”,其中:

  • 参数必须全部大写,广告主可以根据自己的需要选择具体填写哪些参数,AMS支持宏参数请见下方;
  • “__参数__”格式中参数两边为双下划线,即参数左右两边均为两个连续的英文字符’_’
  • 若为点击监测的回传方式,必选字段为“__CALLBACK__”;其他场景“__CALLBACK__”不可选;

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

3. 点击监测链接示例

  1. 广告主填写在转化id创建时的监测链接如下:
https://www.example.com/click/?adgroup_id=__ADGROUP_ID__&ad_id=__AD_ID__&muid=__MUID__&callback=__CALLBACK__

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

  1. 广告主收到的真实请求:
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:微信

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__