Postback(回传):该给联盟经理发什么
postback 是什么
当访客在广告主的网站上付款时,订单记录在联盟那里,而不是你的追踪器里。postback 就是联盟把这个消息告诉你的追踪器:一条简短的服务器到服务器请求,形如
https://track.example.com/a7f3c91e/postback?subid=0bc4ba11-688d-4de0-98b4-8b0d6e81cef&status=sale&payout=30
它的意思是:"点击 0bc4ba11… 转化了,状态 sale,你赚 30"。Orbitra 找到这次点击,从此就知道是哪个活动、哪条流、哪个 offer、哪个国家、哪条广告、哪套创意带来了这笔钱。
没有 postback,追踪器只数点击、看不到任何转化,收入、利润、ROI 和 CR 会一直是零。
点击 ID 如何走完一个来回
1. Visitor clicks your ad → Orbitra creates click 0bc4ba11…
2. Orbitra redirects to the offer: https://network/offer?aff=777&sub1=0bc4ba11…
▲ added by the network's "offer parameters"
3. The network remembers sub1 for this visitor
4. Visitor buys → the network calls your postback URL and puts sub1 back:
https://track.example.com/a7f3c91e/postback?subid=0bc4ba11…&status=sale&payout=30
5. Orbitra marks click 0bc4ba11… as a conversion
让这件事跑通靠两个设置:
- Orbitra 中联盟的 offer 参数(
&sub1={subid})— 点击 ID 由此送往联盟; - 联盟后台里的 postback URL — 点击 ID 由此传回。联盟会把自己宏(
{sub1}、{clickid}、[SUB1]— 每家写法不同)替换成保存的值。
如果联盟是从模板创建的,两头的字段名都已经对上了。
在哪里找你的 postback URL
- Networks → 联盟所在行(或联盟编辑页)→ Postback URL。这是首选:它用的是该联盟自己的宏名称。
- ⚙ → Postback URL — 通用地址以及不在模板列表里的联盟的示例。

Orbitra 能识别的参数:
| 参数 | 是否必需 | 含义 |
|---|---|---|
subid | 是 | Orbitra 的点击 ID — 即联盟在 sub1(或你选定的字段)里收到的值 |
status | 否 | lead、sale、rejected、trash、registration、deposit,或联盟自己的说法(approved、pending、declined……) |
payout | 否 | 这笔转化你赚多少 |
currency | 否 | 联盟用其他币种结算时 — 会换算成追踪器币种 |
tid | 否 | 交易 ID,一次点击可能带来多笔转化时需要(例如重复充值) |
联盟自己的状态说法会自动翻译(approved、confirmed → sale;declined、cancelled → rejected)。其他词可以直接在 URL 里映射:&sale_status=approved,paid&lead_status=pending。Orbitra 不认识的词会出现在 ⚙ → Settings → Conversion Types → Unmapped statuses,在那里手动指定即可。
该给联盟经理发什么
大多数联盟只要你开口就会帮你配好 postback。可以发这样的话(把 URL 换成你自己的):
你好!请为我的账号(所有 offer)配置一条 global postback:
https://track.example.com/a7f3c91e/postback?subid={sub1}&status={status}&payout={payout}
- 我的点击 ID 放在 offer 链接的 sub1 参数里 — 请在subid中回传。
- 请发送所有状态的 postback:新 lead(hold/pending)、approved、rejected 和 trash,approved 的带上 payout。
- 用 GET 方式即可。
如果点击 ID、状态和佣金的宏名与{sub1}、{status}、{payout}不同,也请告诉我你们的具体写法。谢谢!
检查对方的回复时注意:
- 哪个字段承载你的点击 ID。 如果对方说"用
aff_sub",就把 Orbitra 里该联盟的 offer 参数改成&aff_sub={subid},postback 里改成subid={aff_sub}。 - 对方的宏语法。
{sub1}、[SUB1]、%sub1%、{{sub1}}— 原样照抄他们的写法。 - 状态用词。 如果对方传
status=1/2/3或俄语单词,用&sale_status=…&lead_status=…&rejected_status=…或在 Conversion Types 里映射。 - 单 offer 还是全局。 global postback 覆盖所有 offer;per-offer postback 则要逐个 offer 单独添加。
怎么测试
- 通过活动链接产生一次真实点击(或从 ⚙ → Logs → Traffic 里挑一条点击),复制它的点击 ID。
- ⚙ → Postback URL → Test Postback:粘贴点击 ID,选一个状态,点 Test。

- 打开 ⚙ → Conversions — 转化已经出现,活动的计数也随之变化。
很多联盟后台也有"test postback"按钮,会用假的 sub1 发一条请求。Orbitra 会回复"click not found" — 这是预期行为,说明 URL 是可达的。

⚙ → Logs → Incoming Postbacks 列出收到的每条请求,包括被拒绝的及其原因。当出现"联盟说发了、追踪器里啥也没有"的情况,先来这里查。
把转化回传给流量来源(S2S)
有些流量来源(push/pop 联盟、TikTok、部分 native 联盟)在收到你的转化数据后优化效果更好。这就是出站 postback,在活动的 S2S Postbacks 标签页配置。如果流量来源模板带有 postback URL,新建活动会自动带上。那里的 Run test 按钮可以检查整条链路。Facebook 和 TikTok 走的是它们的 Conversions API — 见 Facebook / Meta。

排错
| 现象 | 去哪里查 |
|---|---|
| Incoming Postbacks 里什么都没有 | 联盟根本没回调你:对方后台 URL 填错了,或者 postback 只配在了另一个 offer 上 |
| "Click not found" | 点击 ID 没传过来:检查联盟的 offer 参数和 postback 里的宏 |
| "Wrong key" | URL 里是旧的 postback 密钥。在你更换密钥之前创建的联盟,其保存的 Postback URL 里仍是旧密钥 — 在联盟编辑页修正该 URL 中的密钥,并同步更新联盟后台 |
转化被记成 custom 状态 | 联盟的状态词没有映射 — 到 Conversion Types 里修好 |
| 佣金为 0 | 联盟没有替换 {payout},或用了别的参数名 — 在 Postback 页面添加参数别名 |
参考:Postback 与转化。
新手指南:从这里开始
一屏一屏带你认识 Orbitra:追踪器是干什么的、你会遇到哪些术语,以及读这些教程的顺序。
阅读教程 →教程手把手创建你的第一个活动
从全新安装到可用的活动链接和一条测试转化:域名、联盟、offer、流量来源、活动、postback。
阅读教程 →教程绑定域名
添加域名、把 DNS 指向追踪器、免费签发 SSL 证书,以及 Domains 页面上每个开关的作用。
阅读教程 →教程Offer 与联盟
Orbitra 如何组织 offer 和联盟:模板、offer 参数与佣金设置。
阅读教程 →教程Postback(回传):该给联盟经理发什么
转化如何进入 Orbitra:postback URL、状态,以及要复制粘贴给联盟的内容。
阅读教程 →教程流(Stream):流量如何分配
什么是流、方案(schema)、轮询与权重,以及 Orbitra 如何决定一次点击的去向。
阅读教程 →教程流过滤器
国家、设备、ISP、机器人等:每个过滤器都有说明和常见路由配置示例。
阅读教程 →教程新手斗篷(Cloaking)入门
安全页与盈利页、检测层、灵敏度,以及上真实流量前如何测试你的斗篷。
阅读教程 →教程落地页
把落地页直接托管在追踪器里:落地页类型、{offer} 宏、JS adapter 与追踪像素。
阅读教程 →教程PWA 应用
把落地页做成可安装的 PWA:图标、截图、商店详情页与限制。
阅读教程 →教程给 PWA 用户发 Push 通知
从 PWA 落地页收集 push 订阅者并给他们发通知 — 免费的召回流量。
阅读教程 →教程素材库(Content Gallery)
把图标、截图和创意存进追踪器,在 PWA 和落地页之间复用。
阅读教程 →教程创意(Creative)与创意测试
追踪每次点击来自哪套创意:subid 路由、测试活动与报表解读。
阅读教程 →