广告回传与集成:像素回传、API 密钥、Telegram 与 AI 服务
· 约 6 分钟读完
把购买、注册等转化回传给 Meta、Google、TikTok 等广告平台;以及集成与 API 页里的密钥、事件通知、Telegram 机器人、数据导出和 AI 服务。
能帮你做什么
广告回传:用户在你的页面下单、注册后,系统从服务器直接把这次转化告诉广告平台(俗称 CAPI / S2S 回传)。广告平台知道哪些点击真正带来了订单,就能把广告推给更像买家的人。相比只靠浏览器里的像素,服务器回传不受广告拦截插件和浏览器隐私限制影响,数据更全。
集成与 API:让你自己的系统读取讯兔的数据、接收事件通知,或者在 Telegram 里查看数据和告警;还可以绑定自己的 AI Key。
使用前准备
- 在广告平台后台拿到对应凭证,例如 Facebook 的 Pixel ID 和系统用户访问令牌。具体位置见 Facebook 像素接入教程、TikTok 像素接入教程、Adjust 归因接入教程。
- 建议先建好斗篷规则,回传时关联斗篷,避免把机器人访问也回传给平台。
- 对接独立站订单回传的话,需要能修改商城服务器的技术人员。
分步操作
一、新增回传事件
- 侧栏「广告回传」→ 默认是「转化事件」页签下的「广告数据回传管理中心」。
- 点「新增回传事件」。
- ① 选择广告平台:Facebook(Meta CAPI)、Google(GA4 / Ads API)、TikTok(Events API)、Snapchat(Conversions API)、X (Twitter)(Ads API)、Pinterest(Conversions API),或展开「其他广告网络 / 跟踪器」。
- ② 基础信息与凭证:填「事件名称」,选「转化事件类型」(如 Purchase 购买、Lead 线索、CompleteRegistration 完成注册等),选「关联落地页」或「不关联落地页(全局事件)」,再填平台专属凭证。
- 高级设置:
- 「访客开口咨询后才回传」:只有访客点开聊天、开口咨询之后才回传。
- 「回传控量」:默认「全部回传」,也可以按比例抽样回传。
- 右侧「斗篷联动」:选择要关联的斗篷规则。未关联时会提示「未关联斗篷规则:机器人访问也会被回传,建议关联」。
- 点「测试回传」确认能发送成功,再「保存配置」。
右侧「配置完成度」会提示还差哪些步骤:已选择广告平台、已填写必填凭证、已关联斗篷、已测试回传。


二、接收独立站订单(Shopify / 自建站)
回传事件的设置里有「接收独立站订单」一栏:用 Shopify 或独立站卖货时,把这个地址填到你的商城,订单付款成功后由商城服务器通知讯兔,系统再调用广告平台官方接口真实回传,并按平台的真实响应记录成功或失败。
这一步需要技术人员对接:请求必须带签名,签名密钥只在事件创建时显示一次,请立即复制保存;丢了可以「重置密钥」。具体参数见页面上的「开发者对接说明」。
三、查看回传日志和诊断
- 「回传日志」:每一次回传的结果。
- 「受众同步」:把身份图谱里的人群同步到广告平台做再营销。
- 「一键诊断」:自动检查回传配置。
四、集成与 API
从头像菜单进入「集成与 API」,这里的设置斗篷、PWA 与双库支付共用。共 5 个页签:
| 页签 | 用途 |
|---|---|
| API 密钥 | 开放 API 密钥,让你自己的系统读取数据、暂停链接 |
| 事件通知 | Webhook:出现投诉等事件时第一时间推送到你的服务器 |
| Telegram 机器人 | 在 Telegram 里查看今日数据、处理投诉、暂停 / 恢复链接、换 offer,并接收告警 |
| 数据导出 | 导出数据文件 |
| AI 服务 | 绑定自己的 AI Key |


绑定 Telegram:在「Telegram 机器人」页签点「生成绑定码」,按页面提示在 Telegram 里完成绑定。如果页面提示平台的机器人还没有配置完成,就暂时不能绑定,需要等平台管理员配置。

绑定自己的 AI Key:在「AI 服务」页签填写。绑定后,PWA 的 AI 生成、翻译与评价改用你的 Key,不消耗平台 AI 额度;不绑也可以,直接用平台 AI(按额度计费)。
- 文本大模型:支持 OpenAI(含兼容网关,可填自定义 Base URL,用于接通义千问、Kimi、智谱、豆包、OpenRouter 等)、Claude 与 DeepSeek,按「默认文本模型」选用。
- 「模型名称(可选)」:填了就按这个名称调用,例如 qwen-plus。
- 图片大模型:DALL·E 3 未单独配置时,自动使用上面的 OpenAI Key。

实战技巧
跨境独立站投手(含黑五)
- 每个回传事件都关联斗篷规则。黑五期间机器人流量暴增,不关联的话机器人的“转化”也会被回传,会把广告模型带偏。
- 先用 Test Event Code 在 Meta 事件管理工具里联调,确认收到后再删掉测试码正式回传。
- 大促期间想控制平台学习的节奏,可以用「回传控量」只回传一部分订单。
- 用 Telegram 机器人接收告警,凌晨出问题也能第一时间暂停链接。
海外游戏买量 / PWA 团队
- PWA 的像素和充值回传在 PWA 工作区的「像素与归因」里配置;这里的回传事件主要用于落地页和独立站。
- 团队用自己的 AI Key(例如 DeepSeek 或兼容网关),批量生成多语言商店文案时不消耗平台 AI 额度。
- 用开放 API 把安装和投诉数据接进自己的 BI 报表。
限制与规则
| 项目 | 规则 |
|---|---|
| 官方接口直连回传的平台 | Facebook、TikTok、Google、Snapchat、Pinterest、X (Twitter)、TrafficStars,以及自定义 Webhook |
| 暂未接入的平台 | BIGO(凭证可保存,但不会真正回传) |
| 单次回传超时 | 6 秒 |
| 失败重试 | 网络错误、平台 5xx 或限流时最多重试 3 次 |
| 订单通知签名时效 | 时间戳前后 5 分钟内有效 |
| API 密钥 | 同时有效最多 10 个 |
| 事件通知端点 | 最多 10 个 |
| Telegram 绑定 | 最多 5 个聊天 |
具体数值请以页面实际显示为准。
常见问题
测试回传时提示「⚠️ BIGO 暂未接入,无法测试(凭证已保存但不会真正回传;该平台官方专线开发中)」 原因:这个平台的官方回传接口还没接入。 解决:换用已接入的平台,或通过「其他广告网络 / 跟踪器」的模板方式回传。
回传日志里显示「官方 CAPI 专线尚未接入,本次未发送」 原因:所选平台不在官方直连名单里。 解决:同上,改用已接入的平台。
配置完成度一直是「已关联斗篷」没勾上 原因:回传事件没有关联斗篷规则。 解决:在右侧「斗篷联动」里选择一条规则。
独立站订单回传都被拒绝 原因:请求没带签名、签名错误,或时间戳超过 5 分钟。 解决:让技术人员按「开发者对接说明」检查签名和服务器时间;密钥丢失时「重置密钥」并更新商城配置。
Telegram 页签提示平台的机器人还没有配置完成,暂时不能绑定 原因:平台管理员还没配置机器人。 解决:等待平台配置完成,或提交工单询问。
绑了 AI Key 还是提示 AI 不可用 原因:Key 无效、余额不足,或默认文本模型选的平台没填对应 Key。 解决:检查 Key 是否正确,并确认「默认文本模型」和填写的 Key 是同一家。
- #回传
- #CAPI
- #像素
- #API
- #Webhook
- #Telegram
- #AI
准备好试试了吗?
免费注册,几分钟内搭好第一个落地页并开始分流。
免费注册