腾讯广告转化数据上报升级指引
1 背景
为保障广告主转化回传的安全性与可靠性，自 2025 年 3 月 31 日起，腾讯广告将不再支持通过 HTTP 协议及未通过鉴权上报的转化数据。对于使用转化归因上报 API 的广告主，需通过 HTTPS 协议上报数据，并携带鉴权参数，具体涉及两类上报场景：
- 投放前配置监测链接，通过下发的回传地址上报数据：需参照指引完成鉴权参数添加，开启鉴权开关。
- 投放前未配置监测链接，直接调用 API 回传数据且未鉴权：需参照指引完成鉴权参数添加，切换上报 API。
2 配置流程
不同类型不同上报方式的最新标准指引参考：
| API名称 |
|---|
| APP 转化数据 API 自归因 |
| Web 转化数据 API 自归因 |
| 小游戏转化数据 API 自归因 |
| 小程序转化数据 API 自归因 |
| 公众号转化数据 API 自归因 |
| 企业微信转化数据 API 自归因 |
3 升级指引
| 情况 | API 上报方式 | 上报方式 |
|---|---|---|
| 1 | 配置监测链接，获取 __CALLBACK__ 参数后上报 | ● 步骤 1：配置监测链接 ● 步骤 2：获取下发数据 ● 步骤 3：解析 __CALLBACK__ 上报地址 ● 步骤 4：自归因后上报数据 |
| 2 | 获取 click_id，直接调用 API 上报 | ● 步骤 1：获取 click_id ● 步骤 2：上报数据 |
情况1：配置监测链接，获取 __CALLBACK__ 参数后上报
步骤 1：获得 access_token
当前密钥调用 user_actions/add 的频次限制默认为4000次/分钟，如不满足使用诉求，可申请提额
方式1：通过 DataNexus 代为生成永久密钥
在 数据源接入 页面，点击 【查看密钥】，获得 token 信息。
方式2：自行申请开发者应用生成密钥
或自行在腾讯广告开放平台，申请 开发者应用 生成密钥。
步骤 2：上报添加密钥
获取监测下发数据，完成自归因后，上报数据时需在 header 中新增对应鉴权参数。
curl -X POST
https://api.e.qq.com/v3.0/user_actions/add?cb=YWRzX......iOWNi&conv_id=10001 //这里请求的url&path 直接从点击转发出去的__CALLBACK__字段中URLDecode获得，左边是示例请求，请勿直接上报
-H 'Content-Type: application/json'
-H 'access-token: <ACCESS_TOKEN>' // 注意：这里是中划线，静态 token 可从 DataNexus - 数据源 获得
-H 'timestamp: <TIMESTAMP>'
-H 'nonce: <NONCE>'
-H 'cache-control: no-cache'
-d '{
"actions":[
{
"outer_action_id":"outer_action_identity",// 选填，若上报可能有重复请填写该id，系统会根据该ID进行去重，详见FAQ
"action_time":1492998081,
"user_id":{//user_id，可采集到的设备标示
"wechat_openid":"",//当为小程序类转化时，此字段与wechat_unionid必传其一
"wechat_unionid":"",//当为小程序类转化时，此字段与wechat_openid必传其一
"wechat_app_id":"",//用户发生该行为对应的小程序appid，该字段必填，并确保该appid已对该账户进行了授权（请参考帮助中心-转化归因使用指南-微信小程序转化归因操作手册中的appid授权部分）
},
"action_type":"COMPLETE_ORDER", // 必填 行为类型
"action_param":{
......
}
}
]
}'
步骤 3：开启鉴权
进入 DataNexus - <广告效果监测> 页面，选择【查看开启配置】。勾选后，点击【确定】。
__CALLBACK__ 中下发的 url 将根据您的【开启鉴权】/【关闭鉴权】操作变化。
| 鉴权状态 | url | 新增校验点 |
|---|---|---|
| 开启鉴权 | https%3A%2F%2Fapi.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123 | 上报代码中是否添加-access-token、timestamp、nonce 字段 access-token 是否有效 |
| 关闭鉴权 | http%3A%2F%2Ftracking.e.qq.com%2Fconv%3Fcb%3DxXx%252BxXx%253D%26conv_id%3D123 | 无 |
情况2 : 获取 click_id，直接调用 API 上报
步骤 1：获得 access_token
当前密钥调用 user_actions/add 的频次限制默认为4000次/分钟，如不满足使用诉求，可申请提额
方式1：通过 DataNexus 代为生成永久密钥
在 数据源接入 页面，点击 【查看密钥】，获得 token 信息。
方式2：自行申请开发者应用生成密钥
或自行在腾讯广告开放平台，申请 开发者应用 生成密钥。
步骤 2：切换上报接口
获取密钥后，调用 user_actions/add 接口上报数据。上报数据时，需在请求参数中新增对应鉴权参数。
详情上报指引参考 用户行为添加/更新 。
curl 'https://api.e.qq.com/v3.0/user_actions/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
"account_id": 1111111111,
"user_action_set_id": 1111111111,
"actions": [
// 以下为 1 次请求的第 1 个行为：自然流量（"channel": "NATURAL")带来的自定义行为（CUSTOM）
{
"outer_action_id": "示例唯一行为 id_请指定",
"action_time": 1492998081,
"user_id": {
"hash_imei": "f9efca36a..."
},
"action_type": "CUSTOM",
"custom_action": "my_type",
"action_param": {
"value": 28,
"quantity": 5,
"brand_name": "my_brand",
"int_example": 123,
"int_array_example": [123, 234],
"double_example": 123.4500000000000028421709430404007434844970703125,
"double_array_example": [123.45, 234.56],
"bool_example": true,
"bool_array_example": [true, false],
"string_example": "123",
"string_array_example": ["123", "234", "abc"]
},
"product_inform": {
"content_type": "EC",
"category_path": [
"家用电器/厨房小电/豆浆机",
"本地生活旅游出行/旅游出行/机票火车票"
]
},
"channel": "NATURAL"
},
// 以下为 1 次请求的第 2 个行为：腾讯流量（"channel": "TENCENT"）带来的购买（PURCHASE）行为。1次请求最多上报50个行为，格式以此类推
{
"outer_action_id": "示例唯一行为 id_请指定",
"action_time": 1492998090,
"user_id": {
"hash_imei": "f9efca36a..."
},
"action_type": "PURCHASE",
"action_param": {
"value": 28,
"quantity": 5,
"brand_name": "my_brand",
"int_example": 123
},
"product_inform": {
"content_type": "EC",
"category_path": [
"家用电器/厨房小电/豆浆机",
"本地生活旅游出行/旅游出行/机票火车票"
]
},
"channel": "TENCENT"
}
]
}'
4 常见FAQ
Q：我有多个投放账户，如何升级更简单？
A：callback 上报（情况1）中，1 个 access-token 供多个投放账户（不限主体）使用。
Q：非 callback 上报，1 个 access-token 也可供多个投放账户使用吗？
A：非 callback 上报，将按 marketAPI 的要求完成鉴权，具体请见 通过 Oauth 2.0 获得 access_token 。
Q：已通过 DataNexus - <广告效果监测> 页面，开启鉴权配置并设置全量日期，但在全量日期当天上午收到的下发数据中，解析 callback 字段获取的数据上报地址，为什么还是「tracking.e.qq.com」 这个域名？
A：实际全量鉴权的时间，是按照设置的全量日期的上午 8 点开始生效，8 点后全量下发的数据中即为「api.e.qq.com」域名