跳到主要内容

广告曝光


1 广告曝光监测的作用​

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


信息

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


2 配置入口​

2.1 DataNexus​

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

ad_track_click_04

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

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

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

ad_track_click_03

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/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__

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


您收到的真实请求：

https://www.example.com/impression/?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）。



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（自归因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 = 中广协 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		__ACCOUNT_ID__
__IMPRESSION_ID__
__IMPRESSION_TIME__
__DEVICE_OS_TYPE__
__HASH_ANDROID_ID__
__HASH_OAID__
__MUID__
__PROMOTED_OBJECT_ID__
应用 - iOSaccount_id
impression_id
impression_time
device_os_type
muid
promoted_object_id		__ACCOUNT_ID__
__IMPRESSION_ID__
__IMPRESSION_TIME__
__DEVICE_OS_TYPE__
__MUID__
__PROMOTED_OBJECT_ID__
网页account_id
callback
impression_id
impression_time		__ACCOUNT_ID__
__CALLBACK__
__IMPRESSION_ID__
__IMPRESSION_TIME__


7 推荐示例​



FAQ​

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

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




该内容是否有帮助？