教程

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

让这件事跑通靠两个设置:

如果联盟是从模板创建的,两头的字段名都已经对上了。

在哪里找你的 postback URL

postback 设置页面
postback 设置页面

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} 不同,也请告诉我你们的具体写法。谢谢!

检查对方的回复时注意:

  1. 哪个字段承载你的点击 ID。 如果对方说"用 aff_sub",就把 Orbitra 里该联盟的 offer 参数改成 &aff_sub={subid},postback 里改成 subid={aff_sub}。
  2. 对方的宏语法。 {sub1}、[SUB1]、%sub1%、{{sub1}} — 原样照抄他们的写法。
  3. 状态用词。 如果对方传 status=1/2/3 或俄语单词,用 &sale_status=…&lead_status=…&rejected_status=… 或在 Conversion Types 里映射。
  4. 单 offer 还是全局。 global postback 覆盖所有 offer;per-offer postback 则要逐个 offer 单独添加。

怎么测试

  1. 通过活动链接产生一次真实点击(或从 ⚙ → Logs → Traffic 里挑一条点击),复制它的点击 ID。
  2. ⚙ → Postback URL → Test Postback:粘贴点击 ID,选一个状态,点 Test。
测试 postback
测试 postback
  1. 打开 ⚙ → 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。

活动的 S2S Postbacks 标签页
活动的 S2S Postbacks 标签页

排错

现象去哪里查
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 与转化。

← 上一篇
Offer 与联盟
下一篇 →
流(Stream):流量如何分配
在 GitHub 上查看源码: github.com/fenjo26/Orbitra.link/wiki
全部教程
教程

新手指南:从这里开始

一屏一屏带你认识 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 路由、测试活动与报表解读。

阅读教程 →