跳到主要内容

广告点击


1 广告点击监测的作用

当您同时投放多个平台的广告时,可通过填入监测链接,以识别出腾讯广告给您带去的流量信息。

在<投放管理平台>-<广告> 或<工具>-<转化归因>上选择“点击监测链接”,通过您自定义的 Feedback URL,腾讯广告按照规则拼接参数后调用该接口,您将接收腾讯广告发出的点击信息。




2 配置入口

2.1 DataNexus

入口:<DataNexus><数据监测>-<广告效果监测>

ad_track_click_04

2.2 投放管理平台 - 转化归因

入口:投放管理平台 - 工具 - 效果分析 - 转化归因

ad_track_click_03

2.3 投放管理平台 - 工具

入口:投放管理平台 - 工具 - 效果分析 - 点击监测 - 点击监测(计划 2024 年 5 月 30 日下线)

注:该入口不支持广告 v3.0 新增的字段下发,如需获取最新字段,请前往 「3.1 DataNexus - 数据监测 - 广告效果监测」中完成配置。

ad_track_click_02




3 格式要求

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

https://XXX.XXX.com?

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

  • 参数必须全部大写,广告主可以根据自己的需要选择具体填写哪些参数,但不能包含符号 #,腾讯广告支持宏参数请见下方;
  • __参数__”格式中参数两边为双下划线,即参数左右两边均为两个连续的英文字符’_’;
  • 广告主可以根据自己的需要选择具体填写哪些参数,支持参数详见参数列表
  • 若为点击监测的回传方式,必选字段为“CALLBACK”;其他场景“CALLBACK”不可选;
  • 不要占用平台下发的参数(见接受点击接口参数)。

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



4 链接示例

推荐示例如下。

Android

https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&click_sku_id=__CLICK_SKU_ID__&billing_event=__BILLING_EVENT__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&request_id=__REQUEST_ID__&callback=__CALLBACK__&adgroup_name=__ADGROUP_NAME__&dynamic_creative_id=__DYNAMIC_CREATIVE_ID__&dynamic_creative_name=__DYNAMIC_CREATIVE_NAME__&creative_components_info=__CREATIVE_COMPONENTS_INFO__&element_info=__ELEMENT_INFO__&marketing_goal=__MARKETING_GOAL__&marketing_sub_goal=__MARKETING_SUB_GOAL__&marketing_target_id=__MARKETING_TARGET_ID__&marketing_carrier_id=__MARKETING_CARRIER_ID__&marketing_sub_carrier_id=__MARKETING_SUB_CARRIER_ID__&marketing_asset_id=__MARKETING_ASSET_ID__&material_package_id=__MATERIAL_PACKAGE_ID__&hash_android_id=__HASH_ANDROID_ID__&hash_oaid=__HASH_OAID__&muid=__MUID__

iOS

https://www.example.com/click/? click_id=__CLICK_ID__&click_time=__CLICK_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&click_sku_id=__CLICK_SKU_ID__&billing_event=__BILLING_EVENT__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&request_id=__REQUEST_ID__&callback=__CALLBACK__&adgroup_name=__ADGROUP_NAME__&dynamic_creative_id=__DYNAMIC_CREATIVE_ID__&dynamic_creative_name=__DYNAMIC_CREATIVE_NAME__&creative_components_info=__CREATIVE_COMPONENTS_INFO__&element_info=__ELEMENT_INFO__&marketing_goal=__MARKETING_GOAL__&marketing_sub_goal=__MARKETING_SUB_GOAL__&marketing_target_id=__MARKETING_TARGET_ID__&marketing_carrier_id=__MARKETING_CARRIER_ID__&marketing_sub_carrier_id=__MARKETING_SUB_CARRIER_ID__&marketing_asset_id=__MARKETING_ASSET_ID__&material_package_id=__MATERIAL_PACKAGE_ID__&muid=__MUID__&caid=__CAID__

其他应用

https://www.example.com/click/? click_id=__CLICK_ID__&click_time=__CLICK_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&click_sku_id=__CLICK_SKU_ID__&billing_event=__BILLING_EVENT__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&promoted_object_type=__PROMOTED_OBJECT_TYPE__&request_id=__REQUEST_ID__&callback=__CALLBACK__&adgroup_name=__ADGROUP_NAME__&dynamic_creative_id=__DYNAMIC_CREATIVE_ID__&dynamic_creative_name=__DYNAMIC_CREATIVE_NAME__&creative_components_info=__CREATIVE_COMPONENTS_INFO__&element_info=__ELEMENT_INFO__&marketing_goal=__MARKETING_GOAL__&marketing_sub_goal=__MARKETING_SUB_GOAL__&marketing_target_id=__MARKETING_TARGET_ID__&marketing_carrier_id=__MARKETING_CARRIER_ID__&marketing_sub_carrier_id=__MARKETING_SUB_CARRIER_ID__&marketing_asset_id=__MARKETING_ASSET_ID__&material_package_id=__MATERIAL_PACKAGE_ID__

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


广告主收到的真实请求:

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

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



5 字段列表

所有字段宏定义支持版本字段说明枚举值及样例说明
click_id__CLICK_ID__all点击id24oi6xq2aaakvagnqu7a
click_time__CLICK_TIME__all点击时间1586437362
impression_time__IMPRESSION_TIME__all曝光时间1586437361
campaign_id__CAMPAIGN_ID__计划id102043154
adgroup_id__ADGROUP_ID__all广告组id(实际为广告id)228691429
ad_id__AD_ID__广告id(实际为创意id)251986746
dynamic_creative_id__DYNAMIC_CREATIVE_ID__创意 ID654321
dynamic_creative_name__DYNAMIC_CREATIVE_NAME__创意名称创意名称
creative_components_info__CREATIVE_COMPONENTS_INFO__创意组件信息广告中被用户点击的组件信息
[{"id": 101234567,"type":"video"},{"id": 101234568,"type":"image"}
element_info__ELEMENT_INFO__all素材信息广告中被曝光的所有素材
[{"id":"123"},{"id":"456"},{"id":"789"}]
marketing_goal__MARKETING_GOAL__一级营销目的MARKETING_GOAL_UNKNOWN:未知
MARKETING_GOAL_USER_GROWTH:用户增长
MARKETING_GOAL_PRODUCT_SALES:商品销售
MARKETING_GOAL_LEAD_RETENTION:线索留资
MARKETING_GOAL_BRAND_PROMOTION:品牌宣传
MARKETING_GOAL_INCREASE_FANS_INTERACTION:加粉互动
marketing_sub_goal__MARKETING_SUB_GOAL__二级营销目的MARKETING_SUB_GOAL_UNKNOWN:未知
MARKETING_SUB_GOAL_NEW_GAME_RESERVE:新游预约
MARKETING_SUB_GOAL_NEW_GAME_TEST:新游测试
MARKETING_SUB_GOAL_NEW_GAME_LAUNCH:新游首发
MARKETING_SUB_GOAL_PLATEAU_PHASE_LAUNCH:平推期投放
MARKETING_SUB_GOAL_MINI_GAME_NEW_CUSTOMER_GROWTH:新客增长
MARKETING_SUB_GOAL_MINI_GAME_RETURN_CUSTOMER_ENGAGEMENT:回流触达
MARKETING_SUB_GOAL_APP_ACQUISITION:应用拉新
MARKETING_SUB_GOAL_APP_ACTIVATION:应用拉活
marketing_target_id__MARKETING_TARGET_ID__营销对象12345
marketing_carrier_id__MARKETING_CARRIER_ID__一级营销载体20001111111
marketing_sub_carrier_id__MARKETING_SUB_CARRIER_ID__二级营销载体
marketing_asset_id__MARKETING_ASSET_ID__营销资产ID12345
material_package_id__MATERIAL_PACKAGE_ID__素材标签ID
ad_platform_type__AD_PLATFORM_TYPE__all广告投放平台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:京东外单
ad_type__AD_TYPE__all广告类型1:普通广告 DYNAMIC_AD_TYPE_COMMON
2:动态创意广告 DYNAMIC_TYPE_DYNAMIC_CREATIVE
3:聚合页一跳广告
4:合约 CPM 广告
5:动态标题广告
6:内容化广告
7:动态元素广告 DYNAMIC_AD_TYPE_DYNAMIC_ELEMENT
8:动态图片广告
9:动态商品图片广告(枫叶相关)
10:动态商品文字广告(枫叶相关)
11:动态商品单商品广告
account_id__ACCOUNT_ID__all广告主id9471147
agency_id__AGENCY_ID__all代理商id1050262
click_sku_id__CLICK_SKU_ID__all点击sku478c4a93a054f7c9087b4ecb1f03f8a1
billing_event__BILLING_EVENT__all计费类型1:CPC BILLINGEVENT_CLICK
2:CPA
3:CPS
4:CPM BILLINGEVENT_IMPRESSION
5:CPD BILLINGEVENT_APP_DOWNLOAD
deeplink_url__DEEPLINK_URL__all应用直达链接(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__all应用直达链接(iOS)%25%25universal_link%25%25%3Fallianceid%3D1094307%26sid%3D2603989%26ouid%3Dzaoding2tu2_haogao_ios%26openapp%3D3
page_url__PAGE_URL__all落地页地址https%3A%2F%2Fh5.gdt.qq.com%2Fxjviewer%2Fnemo%2F1644609
device_os_type__DEVICE_OS_TYPE__all设备类型ios
android
process_time__PROCESS_TIME__all请求时间1586437335
promoted_object_id__PROMOTED_OBJECT_ID__all应用id1101072624
wx69618ae091cf2c76
promoted_object_type__PROMOTED_OBJECT_TYPE__all推广类型12:Android 应用推广 PROMOTED_OBJECT_TYPE_APP_ANDROID
19:iOS 应用推广 PROMOTED_OBJECT_TYPE_APP_IOS
20:应用宝换量应用推广 PROMOTED_OBJECT_TYPE_EXCHANGE_APP_ANDROID_MYAPP
23:微信公众号推广
25:京东商品推广
29:微信品牌活动推广
30:商品推广 PROMOTED_OBJECT_TYPE_ECOMMERCE
31:品牌活动推广
35:Android 应用推广(应用宝)PROMOTED_OBJECT_TYPE_APP_ANDROID_MYAPP
36:优惠券推广
37:QQ 消息推广 PROMOTED_OBJECT_TYPE_QQ_MESSAGE
39:微信门店推广 PROMOTED_OBJECT_TYPE_LOCAL_ADS_WECHAT
41:QQ 门店推广 PROMOTED_OBJECT_TYPE_LOCAL_ADS
43:销售线索收集 PROMOTED_OBJECT_TYPE_LEAD_AD
45:QQ 浏览器小程序 PROMOTED_OBJECT_TYPE_QQ_BROWSER_MINI_PROGRAM
46:微信小游戏推广 PROMOTED_OBJECT_TYPE_MINI_GAME_WECHAT
47:微信支付代金券推广 PRODUCT_TYPE_WECHAT_PAY_COUPON
49:QQ 小游戏推广 PRODUCT_TYPE_WECHAT_PAY_COUPON
1000:网页推广 PROMOTED_OBJECT_TYPE_LINK
request_id__REQUEST_ID__all请求idvqp7xdombqonw
impression_id__IMPRESSION_ID__all曝光idxkrx5et47h7g401
muid__MUID__all设备id(imei或idfa的加密值)对 IMEI 设备号转成小写,再进行md5编码,再小写,32位
对 IDFA 设备号保持大写,再进行 md5 编码,再小写,32位
d4b8f3898515056278ccf78a7a2cca2d
hash_android_id__HASH_ANDROID_ID__all安卓id做md5加密后小写797745b011e3286de9e1a1c59ba72c97
ip__IP__all媒体投放系统获取的用户终端的公共IPV4地址183.226.102.120
user_agent__USER_AGENT__all用户代理(user_agent)Dalvik%2F2.1.0+%28Linux%3B+U%3B+Android+8.0.0%3B+PIC-AL00+Build%2FHUAWEIPIC-AL00%29
callback(自归因 api 场景必填,其他场景不需要填写)__CALLBACK__all直接提供上报信息回传接口的 url,示例为url encode编码原值,广告主需要decode作为post请求url回传至AMShttp%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123
encrypted_position_id(依据联盟白名单判断)__ENCRYPTED_POSITION_ID__all联盟广告位id8144201
ipv6__IPV6__all媒体投放系统获取的用户终端的公共IPV6地址2409%3A8a55%3A4cc0%3A4050%3A2507%3A4922%3Abbe0%3A524b
hash_oaid__HASH_OAID__allAndroid Q 及更高版本的设备号,64位及以下,取原值后做md5加密9d271e4d04de7e4b0b4f1df20e79ce64
caid__QAID_CAA__allURL Encode后的JSON数组;其中qaid为中广协ID(即CAID),hash_qaid为CAID原值MD5加密后的结果, version为腾讯版本号,支持两个版本同时下发(即最新版和上一版),腾讯版本号与中广协版本对应关系为:腾讯 1001 = 中广协 20200901;腾讯 1003 = 中广协 20201230; 腾讯1004 = 中广协 20211207;腾讯1005=中广协 20220111;腾讯1006=中广协 20230330[{"qaid":"12345","hash_qaid":"123456789012345","version":"1003"},{"qaid":"67890","hash_qaid":"6789523654780214556","version":"1006"}] 进行URL Encode后的结果
adgroup_name__ADGROUP_NAME__all广告组名称三国志·战略版IOS
site_set_name__SITE_SET_NAME__all广告版位SITE_SET_MOMENTS:微信朋友圈
SITE_SET_WECHAT:微信公众号与小程序
SITE_SET_KANDIAN:腾讯看点
SITE_SET_QQ_MUSIC_GAME:QQ、腾讯音乐及游戏
SITE_SET_MOBILE_INNER:QQ、腾讯看点、腾讯音乐(待废弃)
SITE_SET_TENCENT_NEWS:腾讯新闻
SITE_SET_TENCENT_VIDEO:腾讯视频
SITE_SET_MOBILE_UNION:优量汇
SITE_SET_MOBILE_YYB:应用宝
SITE_SET_PCQQ:PC QQ、QQ 空间、腾讯音乐
SITE_SET_MINI_GAME_WECHAT:微信小游戏
SITE_SET_MINI_GAME_QQ:QQ 小游戏
SITE_SET_MOBILE_GAME:App 游戏
SITE_SET_QBSEARCH:QQ 浏览器、应用宝版位
SITE_SET_CHANNELS:微信视频号
SITE_SET_WECHAT_SEARCH:微信搜一搜
campaign_name__CAMPAIGN_NAME__计划名称推广品牌活动-公众号互选广告
ad_name__AD_NAME__广告名称推广品牌活动-20201011-图文-中国教育报
model__MODEL__all机型PCKM00
M2007J17C
V1813A
RMX2176
M2002J9E
OPPO R1 Pluskt
Redmi 7
iPhone 7
……
boost_exp_info__BOOST_EXP_INFO__all专用于ROI策略(原联合专区RuleLab)的UV分组实验信息,用于区分实验组和对照组0: 未知
1: base
2: 实验组
boost_model_id__BOOST_MODEL_ID__all专用于ROI策略(原联合专区RuleLab),对应ROI策略的策略ID(原Rule ID),用于定位对应的ROI策略格式为LongInt
wechat_openid__WECHAT_OPEN_ID__all专用于网页类小程序转化规则的点击监测下发,其它类型不支持该字段下发。每个用户针对小程序应用会产生一个安全的OpenID,只针对当前的小程序有效ozWH25VK0aodxYMZrX0Lqj9HHhrg
keyword_id__KEYWORD_ID__all专用于搜索广告的关键词ID下发,仅在搜索广告计划的QQ浏览器和应用宝版位下发
keyword_text__KEYWORD_TEXT__all专用于搜索广告的关键词下发,仅在搜索广告计划的QQ浏览器和应用宝版位下发
ip_md5__IP_MD5__all媒体投放系统获取的用户终端的公共IPV4地址MD5加密后转小写,仅在新版转化里支持配置
ipv6_md5__IPV6_MD5__all媒体投放系统获取的用户终端的公共IPV6地址MD5加密后转小写,仅在新版转化里支持配置
caid(原值)__CAID__allURL Encode后的JSON数组:其中caid为中广协ID(即CAID),hash_caid为CAID原值MD5加密后的结果, version为中广协caid版本号,支持两个版本同时下发(即最新版和上一版),仅在新版转化归因支持[ { "caid": "bed47550547dc8d51c98b668eb690140","caid_md5": "27dc3f5a7c02e8cba6e699c3ee07b295","version": "20220501"}, {"caid": "cb187c190ba19b7863c803cb27ab2523", "caid_md5":"34ae823c759e5c0480867247c77462bb", "version": "20210501"} ] 进行URL Encode后的结果

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


6 字段必填/选填说明

载体类型必填字段宏字段
应用 - Androidaccount_id
click_id
click_time
device_os_type
hash_android_id
hash_oaid
muid
promoted_object_id
__ACCOUNT_ID__
__CLICK_ID__
__CLICK_TIME__
__DEVICE_OS_TYPE__
__HASH_ANDROID_ID__
__HASH_OAID__
__MUID__
__PROMOTED_OBJECT_TYPE__
应用 - iOSaccount_id
click_id
click_time
device_os_type
muid
promoted_object_id
__ACCOUNT_ID__
__CLICK_ID__
__CLICK_TIME__
__DEVICE_OS_TYPE__
__MUID__
__PROMOTED_OBJECT_TYPE__
应用 - 快应用account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
网页account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
微信 - 小程序account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
微信 - 公众号account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
微信 - 视频号account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
微信 - 企业微信account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
小游戏 - 微信小游戏account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__
小游戏 - QQ 小游戏account_id
callback
click_id
click_time
__ACCOUNT_ID__
__CALLBACK__
__CLICK_ID__
__CLICK_TIME__



7 响应信息

  • 响应格式:Json数据格式

  • 响应内容:{ret: 返回码, msg: 错误提示}

  • 返回码:返回码为0标识正常接收,其他返回码标识错误




FAQ

Q:获取点击数据后,广告主如何设置归因逻辑?

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

AndroidiOS微信小程序
优先使用 muid 归因
若 muid 归因失败,使用 AndroidID 归因
若 AndroidID 归因失败,使用 oaid 归因
若 oaid 归因失败,使用 IP+UA 归因
优先使用 muid 归因
若 muid 归因失败,使用 qaid caa 归因
若qaid
caa归因失败,使用IP+UA归因
对于通过点击下发进行归因的方式:建议通过wechat_open_id进行归因,回传自归因成功的 click_id 与 wechat_openid
对于通过落地页参数进行归因的方式:建议通过对应行为发生的小程序参数gdt_vid进行归因,回传全量的gdt_vid中的traceid作为clickid;落地页参数下发可参考:https://ad.weixin.qq.com/guide/679
注意:对于微信小程序,如果通过点击下发和落地页参数同时获取点击信息,请勿通过将点击下发的 id 信息与 gdt_vid 信息进行匹配归因(因部分版位拼接的参数id取值逻稍有差异)

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


Q:对于非 oCPX 的竞价广告,是否支持点击下发?

A:支持,在<DataNexus>-<数据监测>-<广告效果监测>中完成新建,<广告投放管理平台>-<广告>中完成配置即可。


Q:关于旧版投放广告支持的宏参。

A:目前旧版投放广告支持宏参(包括 CAMPAIGN_ID,AD_ID,BILLING_EVENT,PROMOTED_OBJECT_ID,PROMOTED_OBJECT_TYPE,AD_NAME,CAMPAIGN_NAME ),在新版升级过渡期暂会保留该字段,该类宏参添加与否不影响您在新版的广告投放,建议您在投放新版时可忽略或不添加该宏参。




该内容是否有帮助?