归因转发
该功能将于 2024 年 11 月 27 日 发布。
1 归因转发的作用
当您使用腾讯广告官方 SDK 上报数据时，可填入监测链接，当用户命中腾讯广告转化行为时（如激活、沉默唤起），腾讯广告会将发生了对应的用户 id 和广告信息发送给您，用于报表使用。
2 配置流程
2.1 DataNexus 中配置监测链接
进入 <DataNexus><数据监测>-<广告效果监测> 页面。
填写“监测链接组名称”、选择”营销载体类型“，如小游戏选择“微信小游戏”，将监测链接填写至”归因转发“栏。
2.2 将监测链接绑定至广告
方案1：通过转化规则绑定至广告
1）转化规则中绑定监测链接组
进入投放管理平台 - 工具 - 效果分析 - 转化归因 页面，“监测链接类型”中“选择监测链接组”。
2）广告绑定转化规则
在广告中选择刚才的转化 id，即完成了监测链接组 id 通过转化 id 被绑定至广告的操作。
3）联调监测链接
进入投放管理平台 - 工具 - 效果分析 - 转化归因 页面，点击【转化联调】。
方案2：直接绑定广告
1）广告绑定监测链接组
进入投放端推广页面，选择监测链接组，完成绑定。
2）联调监测链接
进入 投放管理平台- <推广> - <广告>页面，点击操作 - 【在线预览】。详细请见 在线预览功能使用指南 。
3 格式要求
监测链接主要由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 。
4 链接示例
当用户发生广告转化时，腾讯广告后台会获取相关参数，添加到 feedback url，发起请求，同步给广告主，推荐示例如下。
小游戏
https://www.example.com/click/?click_id=__CLICK_ID__&click_time=__CLICK_TIME__&impression_time=__IMPRESSION_TIME__adgroup_id=__ADGROUP_ID__&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__&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__&promoted_object_id=__PROMOTED_OBJECT_ID__&request_id=__REQUEST_ID__&impression_id=__IMPRESSION_ID__&callback=__CALLBACK__&adgroup_name=__ADGROUP_NAME__&site_set_name=__SITE_SET_NAME__&act_type=__ACT_TYPE__&act_time=__ACT_TIME__&wechat_account_id=__WECHAT_ACCOUNT_ID__
这里的 “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）。
5 字段列表
| 所有字段 | 宏定义 | 字段说明 | 枚举值及样例说明 |
|---|---|---|---|
| click_id | __CLICK_ID__ | 点击id | 24oi6xq2aaakvagnqu7a |
| click_time | __CLICK_TIME__ | 点击时间 | 1586437362 |
| impression_time | __IMPRESSION_TIME__ | 曝光时间 | 1586437361 |
| adgroup_id | __ADGROUP_ID__ | 广告组id（实际为广告id） | 228691429 |
| dynamic_creative_id | __DYNAMIC_CREATIVE_ID__ | 创意 ID | 654321 |
| dynamic_creative_name | __DYNAMIC_CREATIVE_NAME__ | 创意名称 | 创意名称 |
| creative_components_info | __CREATIVE_COMPONENTS_INFO__ | 创意组件信息 | 广告中被用户点击的组件信息 [{"id": 101234567,"type":"video"},{"id": 101234568,"type":"image"} |
| element_info | __ELEMENT_INFO__ | 素材信息 | 广告中被曝光的所有素材 [{"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__ | 营销资产ID | 12345 |
| material_package_id | __MATERIAL_PACKAGE_ID__ | 素材标签ID | |
| ad_platform_type | __AD_PLATFORM_TYPE__ | 广告投放平台 | 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__ | 广告类型 | 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__ | 广告主id | 9471147 |
| agency_id | __AGENCY_ID__ | 代理商id | 1050262 |
| billing_event | __BILLING_EVENT__ | 计费类型 | 1：CPC BILLINGEVENT_CLICK 2：CPA 3：CPS 4：CPM BILLINGEVENT_IMPRESSION 5：CPD BILLINGEVENT_APP_DOWNLOAD |
| device_os_type | __DEVICE_OS_TYPE__ | 设备类型 | ios android |
| process_time | __PROCESS_TIME__ | 请求时间 | 1586437335 |
| promoted_object_id | __PROMOTED_OBJECT_ID__ | 应用id | 1101072624 wx69618ae091cf2c76 |
| request_id | __REQUEST_ID__ | 请求id | vqp7xdombqonw |
| impression_id | __IMPRESSION_ID__ | 曝光id | xkrx5et47h7g401 |
| callback（必填） | __CALLBACK__ | 情况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 |
| encrypted_position_id（依据联盟白名单判断） | __ENCRYPTED_POSITION_ID__ | 联盟广告位id | 8144201 |
| adgroup_name | __ADGROUP_NAME__ | 广告组名称 | 三国志·战略版 iOS |
| site_set_name | __SITE_SET_NAME__ | 广告版位 | 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：微信搜一搜 |
| act_type | __ACT_TYPE__ | 行为类型 | "ACTIVATE"：激活，"RE_ACTIVE"：沉默唤起 |
| act_time | __ACT_TIME__ | 行为时间 | 1586437361 |
| wechat_openid | __WECHAT_OPEN_ID__ | wechat_openid | oYuQD6fKDK7jX8NsgjuXmGxaBFRI |
| wechat_account_id | __WECHAT_ACCOUNT_ID__ | 微信广告 appid | wx0e208510eabd2c98 |
注意：callback 服务器下发的是 url encode 编码原值，直接摘取该字段内容。自归因数据上报时，将 callback 进行一次 url decode 操作后作为 post 请求 url 回传至腾讯广告。 存在有些 http 库会自动进行一次 url decode，故在回传数据的时候无需再操作一次 decode 编译，否则将报错。
6 字段必填/选填说明
| 载体类型 | 必填字段 | 必填宏字段 |
|---|---|---|
| 小游戏 - 微信小游戏 | account_id click_id click_time callback | __ACCOUNT_ID__ __CLICK_ID__ __CLICK_TIME__ __CALLBACK__ |
7 响应信息
响应格式：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 监测链接组并与广告绑定，又在新版转化归因中直接填写了监测链接并与广告绑定的情况。所以问题变为如果既配置了 DataNexus 监测链接组并与广告绑定，又在投放端管理平台 - 配置了监测链接，会如何下发？
| 监测链接组类型 | 既配置了监测链接组并与广告绑定，又在投放端管理平台 - 配置了监测链接 |
|---|---|
| 点击监测 | 监测链接组优先，不会重复下发 |
Q：为何创意组件信息 creative_components_info 会下发不是我上传的素材？
A：目前组件来源分为以下两种：
● 自建素材：客户从素材库点选或者本地上传的素材生成的组件；
● AIGC 衍生：基于客户的原始素材，通过创意中心的 AIGC 衍生能力生成的衍生素材组件。
出现上述情况时，该组件的来源为 AIGC 衍生。
关于组件和素材的整体介绍请见 3.0组件化管理功能指引 。
Q：我想优化及评估素材效果，对于 AIGC 衍生素材该如何处理？
A：可通过衍生素材与自建素材查询接口，根据 dynamic_creative_id 查询到 衍生素材 和 自建素材的关联关系。
Q：同一个广告中可以使用多个落地页，我想评估落地页效果该如何处理？
A：可通过 __PAGE_URL__ 宏区分同一条广告中不同落地页的转化效果。