跳到主要内容

游戏预约


信息

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


通知

该监测只 for 游戏行业生效


0 前置条件​

因投放管理平台 - 工具 - 效果分析 - 点击监测 - 效果转发不支持广告 v3.0 新增的字段下发，该功能已于 2024 年 7 月 1 日下线（停止新增，历史已配置监测链接继续支持下发至 2024 年 12 月 31 日）。两者对比如下：

2024 年 7 月 1 日下线前2024 年 7 月 1 日下线后
配置人优化师开发者 + 优化师
配置位置投放管理平台 - 工具 - 效果分析 - 点击监测 - 效果转发DataNexus - 数据监测 - 广告效果监测
配置方式优化师
在 投放管理平台 - 工具 - 效果分析 - 点击监测 - 效果转发 完成配置，
可获得所有广告监测数据		开发者
在 DataNexus - 数据监测 - 广告效果监测 完成配置；
优化师
在新建广告时选择对应的监测链接
可获得对应广告的监测数据
升级点-开发者可使用 操作 API 批量新建监测链接及将监测链接批量绑定广告

您在使用 DataNexus 监测链接之前，请确保“已关闭”或“删除” 投放管理平台 - 工具 - 点击监测 - 效果转发 中的“游戏预约”配置。否则将出现同一次游戏预约行为下发 2 次的情况——投放管理平台 - 工具 - 点击监测 - 效果转发中收到 1 次，DataNexus 中的监测链接 1 次。

ad_track_official_account_follow_03


1 游戏预约监测的作用​

当您投放腾讯广告时，可通过填入监测链接，识别出腾讯广告给您带去的流量信息。当用户通过腾讯广告预约游戏时，腾讯广告会将发生了对应的用户 id 和广告信息发送给您。




2 配置流程​

ad_track_click_01


2.1 DataNexus 中配置监测链接​

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

ad_track_click_04

填写“监测链接组名称”、”营销载体类型“选择“Android 应用” 或 “iOS 应用”，将监测链接填写至”游戏预约监测“栏。

ad_track_game_reserve_01

2.2 将监测链接绑定至广告​

方案1：通过转化规则绑定至广告​

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

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

ad_track_click_03
2）广告绑定转化规则​

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

ad_track_click_07


3）联调监测链接​

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



方案2：直接绑定广告​

1）广告绑定监测链接组​

进入投放端推广页面，选择监测链接组，完成绑定。

ad_track_click_05


2）联调监测链接​

进入投放管理平台 - 推广 - 广告页面，点击操作 - 【在线预览】。详细请见 在线预览功能使用指南 。




4 格式要求​

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

https://XXX.XXX.com?

（2）宏“参数”的格式为“__参数__”，其中：

  • 参数必须全部大写，广告主可以根据自己的需要选择具体填写哪些参数，但不能包含符号 #，腾讯广告支持宏参数请见下方；
  • “__参数__”格式中参数两边为双下划线，即参数左右两边均为两个连续的英文字符’_’；
  • 广告主可以根据自己的需要选择具体填写哪些参数，支持参数详见参数列表；
  • 下发字段为空代表该条监测信息中该字段为空，下发字段为宏代表不支持该字段下发；
  • 不要占用平台下发的参数（见接受点击接口参数）。

（3）广告主为区分不同监测链接数据，可添加自定义参数，如：

https://xx.xx.com?planid=123&channel=ams&click_id=__CLICK_ID__

其中 "planid=123&channel=ams" 为广告主自定义参数。


（4）链接可以用 http、https 开头，不能直接用 ip、必须是正式的域名；使用 https 的话机器不能有多个域名，不支持 sni 。




5 链接示例​

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

Android​

https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&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__&deeplink_url=__DEEPLINK_URL__&page_url=__PAGE_URL__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&promoted_object_id=__PROMOTED_OBJECT_ID__&request_id=__REQUEST_ID__&callback=__CALLBACK__&impression_id=__IMPRESSION_ID__&adgroup_name=__ADGROUP_NAME__&dynamic_creative_id=__DYNAMIC_CREATIVE_ID__&dynamic_creative_name=__DYNAMIC_CREATIVE_NAME__&creative_components_info=__CREATIVE_COMPONENTS_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__&act_type=__ACT_TYPE__&act_time=__ACT_TIME__

iOS​

https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&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__&page_url=__PAGE_URL__&device_os_type=__DEVICE_OS_TYPE__&process_time=__PROCESS_TIME__&promoted_object_id=__PROMOTED_OBJECT_ID__&request_id=__REQUEST_ID__&callback=__CALLBACK__&impression_id=__IMPRESSION_ID__&adgroup_name=__ADGROUP_NAME__&dynamic_creative_id=__DYNAMIC_CREATIVE_ID__&dynamic_creative_name=__DYNAMIC_CREATIVE_NAME__&creative_components_info=__CREATIVE_COMPONENTS_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__&act_type=__ACT_TYPE__&act_time=__ACT_TIME__

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


广告主收到的真实请求：

方案1：通过转化规则绑定至广告

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

方案2：直接绑定广告

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

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




6 字段列表​

所有字段宏定义支持版本字段说明枚举值及样例说明
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"}
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
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
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（必填）__CALLBACK__all情况1：使用 DataNexus 配置，并与广告直接绑定或使用投放管理平台 - 工具
情况2：新版转化归因中的监测链接信息（使用 DataNexus 或直接填写监测链接）
直接提供上报信息回传接口的 url，示例为url encode 编码原值，广告主需要 decode 作为 post 请求url回传至腾讯广告		情况1.1 开启鉴权（2024 年 10 月 16 日起支持在「DataNexus - 广告效果监测」中配置）：http%3A%2F%2Fapi.e.qq.com%2Fconv%3Fcb%3DNEvhXGxPSq1r4ebVdKurL8_xxxI5Hy-uoc9zqiGixJrHf4EfFaSTn_qw0F2ZM
情况1.2 关闭鉴权：http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DNEvhXGxPSq1r4ebVdKurL8_xxxI5Hy-uoc9zqiGixJrHf4EfFaSTn_qw0F2ZM
情况2.1 开启鉴权（2024 年 10 月 16 日起支持在「DataNexus - 广告效果监测」中配置）：http%3A%2F%2Fapi.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123
情况2.2 关闭鉴权：http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123
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
……
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 编译，否则将报错。




7 字段必填/选填说明​

载体类型必填字段必填宏字段
应用 - Androidaccount_id
click_id
click_time
act_type
device_os_type
hash_android_id
hash_oaid
muid
promoted_object_id
callback		__ACCOUNT_ID__
__CLICK_ID__
__CLICK_TIME__
__ACT_TYPE__
__DEVICE_OS_TYPE__
__HASH_ANDROID_ID__
__HASH_OAID__
__MUID__
__PROMOTED_OBJECT_ID__
__CALLBACK__
应用 - iOSaccount_id
click_id
click_time
act_type
device_os_type
muid
promoted_object_id
callback		__ACCOUNT_ID__
__CLICK_ID__
__CLICK_TIME__
__ACT_TYPE__
__DEVICE_OS_TYPE__
__MUID__
__PROMOTED_OBJECT_ID__
__CALLBACK__



8 响应信息​

  • 响应格式：Json数据格式

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

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




FAQ​

Q：广告投放中，将“监测链接组” 中的 id 由当前 id（如 01） 更换为其他 id（如 02），对广告有影响吗？（是否会重新送审？）

A：无影响，不影响在投广告，不会触发重新送审。


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

A：可能有以下几种情况：

情况1：DataNexus - 数据监测 - 广告效果监测 中创建的“营销载体类型”与广告投放不符。如您广告投放的是 Android 设备，请在 DataNexus 中的“营销载体类型”也选择 “Android 应用”。

情况2：因曝光监测只可配合新版转化归因（曝光监测只在曝光归因中下发）使用，若监测链接组中填写了曝光监测，该监测链接组 id 只可使用方案1，即只可在新版转化归因中且归因方式 = 曝光归因中被选择，无法在广告创建时被选择。

情况3：当前广告不支持使用监测链接，如“竞价广告v2.0”。针对这一情况，请与您的行业销售、运营 or 点击右下角的【反馈工单】进一步确认。


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

A：因 1 条广告只支持绑定 1 个监测链接组 id，故当广告绑定了转化规则 id 时，不再支持绑定监测链接组 id。故不存在既配置了 DataNexus 监测链接组并与广告绑定，又在新版转化归因中直接填写了监测链接并与广告绑定的情况。


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

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




该内容是否有帮助？