点击监测链接使用指南

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&mui

d=8d3ebd3654fb46a2832296669cf1b536&callback=http%3A%2F%2Ftracking.e.q

q.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678

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

encode）

4、点击监测字段列表

所有字段 宏定义 字段说明 枚举值及样例说明

click_id __CLICK_ID__ 点击 id 24oi6xq2aaakvagnqu7a

click_time __CLICK_TIME 点击时间 1586437362

__

campaign __CAMPAIGN 计划 id 102043154

_id _ID__

adgroup_ __ADGROUP_I 广告组 id 228691429

id D__
ad_id __AD_ID__ 广告 id 251986746

ad_platfo __AD_PLATFO 广告投放平台 1: GDT entrance

rm_type RM_TYPE__ 3: 京东直投

5: 经 wechat mp 投放的广告

6: 京东运营

8: QQ 公众账号平台

9: 移动联盟 SSP

10: 58 运营

11: 58 商户

12: 易车运营

13: 易车商户

14: 融 360 运营

15: 融 360 商户

16: 点评运营

17:点评商户

18: 来自 OMG 的广告主

19: 京东外单

ad_type __AD_TYPE__ 广告类型 1: 普通广告

2: 动态创意广告

3： 聚合页一跳广告

4: 合约 CPM 广告

5: 动态标题广告
 6: 内容化广告

7: 动态元素广告

8: 动态图片广告

9: 动态商品图片广告（枫叶相关）

10: 动态商品文字广告（枫叶相关）

11: 动态商品单商品广告

account_i __ACCOUNT_I 广告主 id 9471147

d D__

agency_i __AGENCY_ID 代理商 id 1050262

d __

click_sku_ __CLICK_SKU_ 点击 sku 478c4a93a054f7c9087b4ecb1f03f8a1

id ID__

billing_ev __BILLING_EV 计费类型 1: CPC

ent ENT__ 2: CPA

3: CPS

4: CPM

5: CPD

deeplink_ __DEEPLINK_ 应用直达链接 tbopen%3A%2F%2Fm.taobao.com%2Ftb

url URL__ （Android） open%2Findex.html%3F%26action%3Dali.

open.nav%26module%3Dh5%26bootIma

ge%3D0%26source%3Dtaobaolive%26h5

Url%3Dhttp%3A%2F%2Fhuodong.m.taob
 ao.com%2Fact%2Ftalent%2Flive.html%3Fi

d%3D258690996826

universal __UNIVERSAL 应用直达链接 %25%25universal_link%25%25%3Fallianc

_link _LINK__ （iOS） eid%3D1094307%26sid%3D2603989%26

ouid%3Dzaoding2tu2_haogao_ios%26op

enapp%3D3

page_url __PAGE_URL__ 落地页地址 https%3A%2F%2Fh5.gdt.qq.com%2Fxjvie

wer%2Fnemo%2F1644609

device_os __DEVICE_OS_ 设备类型 ios, android

_type TYPE__

process_ti __PROCESS_TI 请求时间 1586437335

me ME__

promote __PROMOTED 应用 id 1101072624, wx69618ae091cf2c76

d_object_ _OBJECT_ID__

id

promote __PROMOTED 推广类型 3: 认证空间——认证空间首页

d_object_ _OBJECT_TYP 4: 开放平台 PC 平台 APP——开放平台 PC

type E__ 应用

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_i __REQUEST_I 请求 id vqp7xdombqonw

d D__

impressi __IMPRESSIO 曝光 id xkrx5et47h7g401

on_id N_ID__

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 d4b8f3898515056278ccf78a7a2cca2d

或 idfa 的加密

值）

对 IMEI 设备号

转成小写，再
 进行 md5 编

码，再小写，

32 位

对 IDFA 设备

号保持大写，

进行 md5 编

码，再小写，

32 位

hash_and __HASH_AND 安卓 id 做 797745b011e3286de9e1a1c59ba72c97

roid_id ROID_ID__ md5 加密后小

hash_ma __HASH_MAC mac 地址去掉 1af7c1680fb36e9e37e5536c25b08303

c __ ':'md5 加密值

ip __IP__ 媒体投放系统 183.226.102.120

获取的用户终

端的公共 IPV4

地址

user_age __USER_AGEN 用户代理 Dalvik%2F2.1.0+%28Linux%3B+U%3B+A

nt T__ （user_agent ndroid+8.0.0%3B+PIC-

） AL00+Build%2FHUAWEIPIC-AL00%29

oaid __OAID__ Android Q 及 f76b1e7d-fff1-992a-ffbe-fff7f8723c2a

更高版本的设
 备号，64 位及

以下，原值

callback __CALLBACK_ 直接提供上报 http%3A%2F%2Ftracking.e.qq.com%2Fco

（点击转 _ 信息回传接口 nv%3Fcb%3DMTIzYWJjNDU2ZGVm%26c

发场景必 的 url，url onv_id%3D12345678

填，SDK encode 编

场景不可 码，广告主可

填） 以直接使用

encrypte __ENCRYPTED 联盟广告位 8144201

d_positio _POSITION_I id，权限需向

n_id D__ 运营申请

ipv6 __IPV6__ 媒体投放系统 2409%3A8a55%3A4cc0%3A4050%3A250

获取的用户终 7%3A4922%3Abbe0%3A524b

端的公共 IPV6

地址

hash_oai __HASH_OAI Android Q 及 9d271e4d04de7e4b0b4f1df20e79ce64

d D__ 更高版本的设

备号，64 位及

以下，取原值

后做 md5 加密

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

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

D__&muid=__MUID__&hash_android_id=__HASH_ANDROID_ID__&hash_mac=__H

ASH_MAC__&oaid=__OAID__&hash_oaid=__HASH_OAID__&ip=__IP__&user_agent

=__USER_AGENT__&account_id=__ACCOUNT_ID__&promoted_object_type=__PRO

MOTED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLB

ACK__

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

D__&muid=__MUID__&ip=__IP__&user_agent=__USER_AGENT__&account_id=__AC

COUNT_ID__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&device_os_t

ype=__DEVICE_OS_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_mac=__HAS

H_MAC__&oaid=__OAID__&hash_oaid=__HASH_OAID__&ip=__IP__&user_agent=__

USER_AGENT__&account_id=__ACCOUNT_ID__&promoted_object_type=__PROMO

TED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLBAC

K__

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=__PRO

MOTED_OBJECT_TYPE__&device_os_type=__DEVICE_OS_TYPE__&callback=__CALLB

ACK__