跳到主要内容

广告曝光


信息

监测链接资产共享功能内测报名中。该功能适用于监测链接内容均相同的广告主,一键开启后,支持同一个业务单元下的投放账户共用一套监测链接,了解一下


信息

曝光监测为申请制,需配合新版转化归因使用。


1 广告曝光监测的作用

在<工具>-<转化归因>上填写“曝光监测链接”,通过您自定义的 Feedback URL,腾讯广告按照规则拼接参数后调用该接口,您将接收腾讯广告发出的曝光信息。




2 配置流程

ad_track_impress_01


2.1 DataNexus 中配置监测链接

进入 <DataNexus><数据监测>-<广告效果监测> 页面。

ad_track_click_04

填写“监测链接组名称”、选择”营销载体类型“,将监测链接填写至”曝光监测“栏。

ad_track_impress_02

2.2 将监测链接绑定至广告

1)转化规则中绑定监测链接组

进入投放管理平台 - 工具 - 效果分析 - 转化归因 页面,“监测链接类型”中“选择监测链接组”。

归因方式请选择“曝光归因”。

ad_track_click_03

2)广告绑定转化 id

在广告中选择刚才的转化 id,即完成了监测链接组 id 通过转化 id 被绑定至广告的操作。

ad_track_click_07


3)联调监测链接

进入投放管理平台 - 工具 - 效果分析 - 转化归因 页面,点击【转化联调】。




3 格式要求

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

https://XXX.XXX.com?

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

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

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




4 链接示例

当用户发生广告转化时,腾讯广告后台会获取相关参数,添加到 feedback url,发起请求,同步给广告主,推荐示例如下。

Android

https://www.example.com/impression/?impression_id=__IMPRESSION_ID__&impression_time=__IMPRESSION_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&impression_sku_id=__IMPRESSION_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/impression/?impression_id=__IMPRESSION_ID__&impression_time=__IMPRESSION_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&impression_sku_id=__IMPRESSION_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/?impression_id=__IMPRESSION_ID__&impression_time=__IMPRESSION_TIME__&adgroup_id=__ADGROUP_ID__&ad_platform_type=__AD_PLATFORM_TYPE__&ad_type=__AD_TYPE__&account_id=__ACCOUNT_ID__&agency_id=__AGENCY_ID__&billing_event=__BILLING_EVENT__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&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/impression/?adgroup_id=228691429&ad_id=251986746&muid=8d3ebd3654fb46a2832296669cf1b536&callback=http%3A%2F%2Fapi.e.qq.com%2Fconv%3Fcb%3DMTIzYWJjNDU2ZGVm%26conv_id%3D12345678

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




5 字段列表

所有字段宏定义支持版本字段说明枚举值及样例说明
impression_id__IMPRESSION_ID__all曝光id24oi6xq2aaakvagnqu7a
impression_time__IMPRESSION_TIME__all曝光时间1586437361
campaign_id__CAMPAIGN_ID__计划id102043154
adgroup_id__ADGROUP_ID__all广告组id228691429
ad_id__AD_ID__广告id251986746
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
impression_sku_id__IMPRESSION_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
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(必填)__CALLBACK__all新版转化归因中的监测链接信息(使用 DataNexus 或直接填写监测链接)
直接提供上报信息回传接口的 url,示例为url encode 编码原值,广告主需要 decode 作为 post 请求url回传至腾讯广告
情况1 开启鉴权(2024 年 10 月 16 日起支持在「DataNexus - 广告效果监测」中配置):http%3A%2F%2Fapi.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123
情况2 关闭鉴权:http%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 = 中广协 20220330[{"qaid":"12345","hash_qaid":"123456789012345","version":"1003"},{"qaid":"67890","hash_qaid":"6789523654780214556","version":"1006"}] 进行URL Encode后的结果
adgroup_name__ADGROUP_NAME__all广告名称793546610
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:微信搜一搜
ad_name__AD_NAME__创意名称推广品牌活动-20201011-图文-中国教育报
model__MODEL__all机型PCKM00
M2007J17C
V1813A
RMX2176
M2002J9E
OPPO R11Pluskt
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
impression_id
impression_time
device_os_type
hash_android_id
hash_oaid
muid
promoted_object_id
callback
__ACCOUNT_ID__
__IMPRESSION_ID__
__IMPRESSION_TIME__
__DEVICE_OS_TYPE__
__HASH_ANDROID_ID__
__HASH_OAID__
__MUID__
__PROMOTED_OBJECT_ID__
__CALLBACK__
应用 - iOSaccount_id
impression_id
impression_time
device_os_type
muid
promoted_object_id
callback
__ACCOUNT_ID__
__IMPRESSION_ID__
__IMPRESSION_TIME__
__DEVICE_OS_TYPE__
__MUID__
__PROMOTED_OBJECT_ID__
__CALLBACK__
网页account_id
impression_id
impression_time
callback
__ACCOUNT_ID__
__IMPRESSION_ID__
__IMPRESSION_TIME__
__CALLBACK__



7 响应信息

  • 响应格式:Json数据格式

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

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




FAQ

Q:DataNexus - 数据监测 - 广告效果监测中已创建监测链接,但转化规则 or 广告中无法选择?

A:因曝光监测只可配合「投放管理平台 - 工具 - 效果分析 - 转化归因」使用(曝光监测只在曝光归因中下发),若监测链接组中填写了曝光监测,该监测链接组 id 只可使用方案1,即只可在新版转化归因中且归因方式 = 曝光归因中被选择,无法在广告创建时被选择。


Q:如果既配置了 DataNexus 监测链接组并与广告绑定,又在新版转化归因中直接填写了监测链接并与广告绑定,又在投放端管理平台 - 配置了监测链接,会如何下发?

A:因曝光监测不支持与广告直接绑定,故上述问题不存在。


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 中参数作为 clickid 回传

如果通过点击下发和落地页参数同时获取点击信息,可使用落地页中的 gdt_vid 与 点击监测中的 request_id 和 impression_id 进行匹配

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


Q:为何创意组件信息 creative_components_info 会下发不是我上传的素材?

A:目前组件来源分为以下两种:

● 自建素材:客户从素材库点选或者本地上传的素材生成的组件;

● AIGC 衍生:基于客户的原始素材,通过创意中心的 AIGC 衍生能力生成的衍生素材组件。

出现上述情况时,该组件的来源为 AIGC 衍生。

关于组件和素材的整体介绍请见 3.0组件化管理功能指引


Q:我想优化及评估素材效果,对于 AIGC 衍生素材该如何处理?

A:可通过衍生素材与自建素材查询接口,根据 dynamic_creative_id 查询到 衍生素材 和 自建素材的关联关系。


Q:同一个广告中可以使用多个落地页,我想评估落地页效果该如何处理?

A:可通过 __PAGE_URL__ 宏区分同一条广告中不同落地页的转化效果。


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

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




该内容是否有帮助?