腾讯广告小程序转化数据API自归因实战：PHP实现与2025升级指南

最新推荐文章于 2026-06-16 00:34:03 发布

原创

最新推荐文章于 2026-06-16 00:34:03 发布 · 205 阅读

标签

#腾讯广告 #小程序 #API #PHP #ViewUI

如果你正在运营微信小程序，并且通过腾讯广告进行推广，那么“转化数据回传”这件事你一定不陌生。简单来说，就是告诉广告平台：“嘿，你带来的那个用户，刚刚在我这里下单了！” 这个动作直接关系到你的广告费花得值不值，能不能精准衡量ROI。

过去，你可能用过一些第三方工具或者比较老的方法来做数据对接。但我要告诉你，2025年腾讯广告对小程序转化数据API进行了一次重要的升级。这次升级不是小修小补，而是从接口地址、鉴权方式到请求参数都有变化。如果你还在用老一套的代码，很可能会发现数据上报失败，广告效果追踪直接“失明”，这可不是闹着玩的。

我自己就踩过这个坑。年初的时候，一个项目的转化数据突然对不上了，排查了半天才发现是接口升级了，老版本的调用方式已经失效。所以，今天我就结合最新的官方文档和实战经验，用PHP给你捋清楚整个流程，特别是2025年升级后你必须注意的几个关键点，让你能快速、稳定地把这套系统跑起来。

在写任何一行代码之前，我们必须把“粮草”准备好。这一步没做对，后面全是白费功夫。

首先，你需要登录 腾讯广告数据接入中心（DataNexus）。这个地方是管理所有数据上报相关设置的“总指挥部”。

找到“转化归因”设置：在广告投放管理平台，点击顶部的“工具箱”，然后找到“转化归因”下的“微信小程序转化”。
创建转化事件：这里你需要创建一个转化行为，比如“提交订单”、“支付成功”。关键点来了：在创建时，系统会要求你填写一个 wechat_app_id。这个ID必须和你小程序后台的AppID完全一致。这一步通常需要你的广告投放代理或运营同学协助完成，务必确认清楚。
获取三个核心ID：创建成功后，请务必记下这三个参数，它们是你的“弹药”：
- account_id：你的腾讯广告主账号ID。
- user_action_set_id：你刚刚创建的转化事件对应的“数据源ID”。你可以把它理解为你这个转化行为的专属“收件箱”编号。
- access_token：这是2025年升级后一个重大变化。以前可能需要通过OAuth 2.0接口动态获取，现在**直接在DataNexus后台申请一个固定的access_token**即可。这个token是长期有效的，大大简化了开发流程。你可以在“数据源”或“应用管理”相关页面找到它。

注意：access_token的获取方式从动态接口调用变为后台固定配置，这是2025年升级的核心变化之一，务必使用新方式，否则会报鉴权错误。

腾讯广告提供了两种主要的用户匹配方式，你需要根据你的广告落地页配置来选择：

__CALLBACK__ (cb)：适用于使用了点击监测链接的广告。每次广告点击会生成一个唯一的cb参数，跟随跳转链路传递到你的落地页或小程序。你需要从URL中解析出这个参数并上报。
click_id：适用于未使用点击监测链接的广告（也就是我们本文重点讲解的方式）。当用户点击腾讯广告（无论是微信流量还是其他腾讯系流量）时，会生成一个click_id，并自动附加在跳转的URL参数中。对于小程序场景，这个click_id通常存在于场景值或页面路径的参数里。

我们这篇文章选择 click_id 方案进行讲解，因为它更常见，且不依赖额外的监测链接配置。你需要和你的广告投放同学确认：在创建转化时，没有启用“点击监测”服务。

好了，前置工作搞定，现在进入核心环节：怎么写代码把数据发出去。2025年的接口有显著变化，我会把新旧对比和注意事项都讲明白。

这是第一个大坑。老版本的接口地址可能是 http://tracking.e.qq.com/conv 之类的。2025年升级后，统一使用新的Marketing API域名和路径。

新版接口地址：https://api.e.qq.com/v1.3/user_actions/add
- 注意：这里是 v1.3 版本，也是目前文档中主推的稳定版本。
必须的请求头（Header）：除了常规的 Content-Type: application/json，必须新增三个安全校验头：
- access-token: 就是你在后台获取的那个固定令牌。