广告回传与集成:像素回传、API 密钥、Telegram 与 AI 服务

· 约 6 分钟读完

把购买、注册等转化回传给 Meta、Google、TikTok 等广告平台;以及集成与 API 页里的密钥、事件通知、Telegram 机器人、数据导出和 AI 服务。

本文目录

能帮你做什么

广告回传:用户在你的页面下单、注册后,系统从服务器直接把这次转化告诉广告平台(俗称 CAPI / S2S 回传)。广告平台知道哪些点击真正带来了订单,就能把广告推给更像买家的人。相比只靠浏览器里的像素,服务器回传不受广告拦截插件和浏览器隐私限制影响,数据更全。

集成与 API:让你自己的系统读取讯兔的数据、接收事件通知,或者在 Telegram 里查看数据和告警;还可以绑定自己的 AI Key。

使用前准备

  • 在广告平台后台拿到对应凭证,例如 Facebook 的 Pixel ID 和系统用户访问令牌。具体位置见 Facebook 像素接入教程、TikTok 像素接入教程、Adjust 归因接入教程。
  • 建议先建好斗篷规则,回传时关联斗篷,避免把机器人访问也回传给平台。
  • 对接独立站订单回传的话,需要能修改商城服务器的技术人员。

分步操作

一、新增回传事件

  1. 侧栏「广告回传」→ 默认是「转化事件」页签下的「广告数据回传管理中心」。
  2. 点「新增回传事件」。
  3. ① 选择广告平台:Facebook(Meta CAPI)、Google(GA4 / Ads API)、TikTok(Events API)、Snapchat(Conversions API)、X (Twitter)(Ads API)、Pinterest(Conversions API),或展开「其他广告网络 / 跟踪器」。
  4. ② 基础信息与凭证:填「事件名称」,选「转化事件类型」(如 Purchase 购买、Lead 线索、CompleteRegistration 完成注册等),选「关联落地页」或「不关联落地页(全局事件)」,再填平台专属凭证。
  5. 高级设置:
    • 「访客开口咨询后才回传」:只有访客点开聊天、开口咨询之后才回传。
    • 「回传控量」:默认「全部回传」,也可以按比例抽样回传。
  6. 右侧「斗篷联动」:选择要关联的斗篷规则。未关联时会提示「未关联斗篷规则:机器人访问也会被回传,建议关联」。
  7. 点「测试回传」确认能发送成功,再「保存配置」。

右侧「配置完成度」会提示还差哪些步骤:已选择广告平台、已填写必填凭证、已关联斗篷、已测试回传。

新增回传事件

回传事件列表

二、接收独立站订单(Shopify / 自建站)

回传事件的设置里有「接收独立站订单」一栏:用 Shopify 或独立站卖货时,把这个地址填到你的商城,订单付款成功后由商城服务器通知讯兔,系统再调用广告平台官方接口真实回传,并按平台的真实响应记录成功或失败。

这一步需要技术人员对接:请求必须带签名,签名密钥只在事件创建时显示一次,请立即复制保存;丢了可以「重置密钥」。具体参数见页面上的「开发者对接说明」。

三、查看回传日志和诊断

  • 「回传日志」:每一次回传的结果。
  • 「受众同步」:把身份图谱里的人群同步到广告平台做再营销。
  • 「一键诊断」:自动检查回传配置。

四、集成与 API

从头像菜单进入「集成与 API」,这里的设置斗篷、PWA 与双库支付共用。共 5 个页签:

页签用途
API 密钥开放 API 密钥,让你自己的系统读取数据、暂停链接
事件通知Webhook:出现投诉等事件时第一时间推送到你的服务器
Telegram 机器人在 Telegram 里查看今日数据、处理投诉、暂停 / 恢复链接、换 offer,并接收告警
数据导出导出数据文件
AI 服务绑定自己的 AI Key

集成与 API-API 密钥

集成与 API-事件通知

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

集成与 API-Telegram

绑定自己的 AI Key:在「AI 服务」页签填写。绑定后,PWA 的 AI 生成、翻译与评价改用你的 Key,不消耗平台 AI 额度;不绑也可以,直接用平台 AI(按额度计费)。

  • 文本大模型:支持 OpenAI(含兼容网关,可填自定义 Base URL,用于接通义千问、Kimi、智谱、豆包、OpenRouter 等)、Claude 与 DeepSeek,按「默认文本模型」选用。
  • 「模型名称(可选)」:填了就按这个名称调用,例如 qwen-plus。
  • 图片大模型:DALL·E 3 未单独配置时,自动使用上面的 OpenAI Key。

集成与 API-AI 服务

实战技巧

跨境独立站投手(含黑五)

  • 每个回传事件都关联斗篷规则。黑五期间机器人流量暴增,不关联的话机器人的“转化”也会被回传,会把广告模型带偏。
  • 先用 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

准备好试试了吗?

免费注册,几分钟内搭好第一个落地页并开始分流。

免费注册

相关文章