Postback 与转化
转化以 postback(回传)的形式从联盟进入 Orbitra,并按其 ID(subid)挂到某次点击上。追踪器随后可以把它转发给流量来源(出站 S2S postback),也可以发给广告平台的 Conversions API。
入站 postback
postback 地址在 ⚙ → Postback URL。形如:
https://your-domain/<postback_key>/postback
postback_key 是本次安装的密钥(防止伪造转化)。如果它仍是代码仓库里的公开默认值,面板会发出警告;可以在同一页面生成新密钥,或执行 php cli/generate_postback_key.php。安装器本身也会生成自己的密钥。
参数
| 参数 | 是否必需 | 含义 |
|---|---|---|
subid | 是 | 追踪器点击 ID — 即联盟在 {subid} / {clickid} 里收到的值 |
status | 否 | 转化状态:lead、sale、rejected、registration、deposit、trash,或任意自定义状态 |
payout | 否 | 佣金金额 |
currency | 否 | 佣金币种 |
tid | 否 | 交易 ID — 同一次点击有多笔转化时使用 |
sub_id_N | 否 | 附加参数值 |
<type>_status | 否 | 直接在 URL 里映射状态:sale_status=approved,confirmed |
示例:
…/postback?subid={subid}&status=lead
…/postback?subid={subid}&status=sale&payout={payout}
…/postback?subid={subid}&status=sale&payout={payout}&tid={transaction_id}
…/postback?subid={subid}&status={status}&sale_status=approved,confirmed
如果联盟的参数名不同,在同一页面配置参数别名(parameter aliases)。
响应
200 — 转化已记录。4xx — 请求被拒绝(密钥错误、点击不存在)。500 / 503 — 写入出错,联盟应重试 postback。转化、相关计数器和 Conversions API 事件在同一个事务里写入:绝不会出现"回了 200 却丢了事件"。
状态如何判定
按以下顺序:
- Settings → Conversion Types 里的转化类型 — 如果状态出现在某个类型的取值列表里。
- 同名的内置类型。
- postback 自带的
<type>_status=…规则。 - 内置别名:
approved、confirmed、accepted、converted→sale;declined、refused、cancelled、canceled→rejected。 - 否则 —
custom。
没有匹配到任何类型的状态列在 Settings → Conversion Types → Unmapped statuses 下:可以在那里把它们归入某个类型,已记录的转化会随之重新归类。
转化类型
每个类型包含:名称、联盟状态取值列表、标签颜色,以及四个开关 — 是否计入"Conversions"、是否计入"Profit"、是否向来源发 S2S、是否计入 offer Cap。开箱即有一个 Revshare 类型(revshare 状态只进利润:不新增转化、不发 S2S、不计 Cap)。
其他币种的佣金
佣金会换算成追踪器的基础币种(汇率在 core/CurrencyRates.php)。原始金额、币种和汇率保存在点击上。出站 postback 的宏 {payout} / {currency} 输出基础币种金额;原始值用 {fx_orig_payout} / {fx_orig_currency}。未知的币种对按原样记录。
入站 postback 日志
⚙ → Logs → Postbacks — 每条入站请求及其结果:点击是否找到、最终状态、金额。点击 ID 可打开点击卡片。
出站 S2S postback(发往流量来源)
在活动的 S2S Postbacks 标签页配置。每条 postback 是一张卡片:URL、GET 或 POST 方法、状态芯片(sale、lead、rejected、registration、deposit、trash 以及自定义状态)。"插入宏"菜单会在光标位置插入宏。
如果所选流量来源设置了 postback_url,postback 列表为空的活动会自动继承它。如果已经配置了 postback,标签页顶部会出现一条带"添加"按钮的提示。
状态过滤器在以下情况放行转化:内部状态匹配(sale)、联盟自己的说法(approved),或旧版 custom 芯片 — 供现在已能被别名识别的词使用。
宏
{subid}(也可写作 {clickid}、{click_id})、{status}、{payout}(也可写作 {conversion_revenue})、{currency}、{tid}(也可写作 {external_id})、{campaign_id}、{offer_id}、{cost}、{revenue}、{profit},以及任意按名保存的点击参数:{sub_id_1} … {sub_id_30}、{fx_orig_payout}、{fx_orig_currency} 等。
{status} 输出内部状态(sale),而不是联盟的原始说法。要把它翻译成来源的词汇,用 Keitaro 风格的变换:{status: sale=purchase lead=lead} — 不在列表里的状态原样通过。
投递队列
出站 postback 不在转化发生的瞬间发送 — 它们进入 s2s_postbacks_log 队列,由 postback_queue_cron.php cron(每分钟一次)带重试地投递:
- 成功 — HTTP 2xx–3xx;
- 重试间隔:60 秒 → 5 分钟 → 30 分钟 → 2 小时 → 24 小时,之后该行标记为
failed; - 入队和发送前都做 SSRF 检查:私网地址立即标记
failed; - 崩溃 worker 遗留在
in_flight状态的行,10 分钟后回到队列。
⚠️ 没有 cron,队列永远不会被处理。安装器会配置好它;要检查或手动添加 — Settings → Automation → Postback Queue。通过面板更新也会补回缺失的 cron。
队列日志:⚙ → Logs → S2S(状态、尝试次数、下次尝试时间、最近错误、HTTP 码)。
Postback 测试器
S2S Postbacks 标签页上的按钮(仅管理员可见)向同一台服务器发送一条真实 postback(使用一次性点击),并给出每一步的判定结果:
- 转化以哪个状态记录;
- 每条 S2S postback 的状态过滤器是否放行 — 以及原因:按内部状态、按联盟说法,还是按旧版芯片;
- 试投递到来源:HTTP 码和耗时;
- 无法解析、会以纯文本发给来源的宏(
{external_id}、{sub_id_N}); - 来源模板里的占位符(
bbg=xxx、[YOUR_…]); - 队列 worker 是否存活、cron 是否已安装。
检查完成后,测试用的点击、转化和队列行都会删除。
重发遗漏的转化
"Re-send missed conversions"(重发遗漏转化)按钮会把最近 72 小时内通过当前过滤、却从未进入队列的转化重新入队。重复点击不会产生重复数据。
转化导入
⚙ → Conversion Import — 联盟发不了 postback、或需要补录时,上传文件或粘贴一列点击 ID。
Conversions API
向 Meta 和 TikTok 服务器发送转化,在 pixel 配置文件(pixel profile)和活动("Integrations" 标签页)里配置。Meta 的细节见 Facebook / Meta。事件与转化一起入队,带确认地投递:只有 2xx 响应且 events_received 与批次大小一致才算成功。
监控
conversion_monitor_cron.php 在一个时间窗口内(默认 60 分钟)统计失败 postback 占比,超过阈值(10%)时把告警写入 var/logs/conversion_alerts.log;告警发到 Telegram 的功能尚未实现。安装器不会配置这个 cron — 需要就自己加:
*/5 * * * * php /var/www/orbitra/conversion_monitor_cron.php --quiet
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 offer、流量来源、广告系列、验证、消耗与统计。
阅读教程 →文档安装与更新
系统要求、一条命令的安装器、PHP 更新与安全公告、按 IP 访问后台、更新完整性校验,以及本地开发环境。
阅读教程 →文档从 Keitaro 迁移
通过 SQL dump 把设置从 Keitaro 迁到 Orbitra:迁移内容清单、导出脚本、导入步骤,以及导入后要检查的事项。
阅读教程 →文档从 Binom 迁移
通过 Binom v2 Public API 直接导入广告系列、offer、流等设置 — 无需 dump 文件,附字段映射说明。
阅读教程 →文档功能总览
所有功能一览:流量与方案、postback 与消耗、数据分析、基础设施与管理 — 每项都链接到详细页面,并附各版本的新增内容。
阅读教程 →文档广告系列与流
广告系列编辑器详解:设置标签页、计费模式、流类型与全部过滤器、方案、自动优化轮询、测试链接与重复点击防护。
阅读教程 →文档斗篷(参考文档)
斗篷完整参考:流设置、检测层、灵敏度、定向过滤器、JavaScript 验证、全局设置、判定结果与原因代码及诊断方法。
阅读教程 →文档浏览器检查
通过浏览器自报矛盾识别机器人、审核员虚拟机、模拟器和反检测浏览器:四种模式、特征清单、结果查看与安全启用步骤。
阅读教程 →文档落地页(参考文档)
落地页完整参考:本地、跳转、Preload 与 Action 四种类型,{offer} 宏、subid 传递、停留时长、JS adapter、PHP 落地页与故障排查。
阅读教程 →文档PWA 与 Web Push
PWA 落地页与自建 Web Push:构建器、域名绑定、VAPID 密钥、订阅者、消息与发送 cron、转化归因和故障排查。
阅读教程 →文档PWA 漏斗
PWA 落地页内的可配置漏斗:store/screen/instructions/push 步骤类型、逐屏追踪、统计维度与编辑器用法。
阅读教程 →文档转化弹窗(Conversion Popups)
在落地页上展示带 offer 按钮的弹窗:适用场景、Popup 标签页设置、触发条件与统计指标。
阅读教程 →文档会话录制与热力图
像视频一样回放真实访问,配合点击热力图与滚动图;含整站录制、Cookie 同意、存储上限与隐私说明。
阅读教程 →文档素材库完整参考
Gallery 页面、上传与软删除、MediaPicker 的尺寸契约(sizeContract)、格式与大小限制,以及视频支持。
阅读教程 →文档创意库
平台同步的创意与手动上传的草稿统一存放,自动绑定花费/收入/ROI,找出真正赚钱的创意。
阅读教程 →文档外部 PWA 与 Telegram 频道
把第三方 PWA 构建器接入流做 A/B,并把 Telegram 频道当作可归因的 offer 目的地。
阅读教程 →文档Postback 与转化
入站 postback 参数与状态映射、转化类型、出站 S2S postback、投递队列与测试器、转化导入和 Conversions API。
阅读教程 →文档花费(Costs)
从 Facebook、TikTok、Google Ads 和 push/pop 联盟导入花费并分摊到点击;含收入聚合器、代理佣金与排错。
阅读教程 →文档Push 与 Pop 联盟
接入 push/pop 联盟的花费导入与 zone 级优化:支持联盟列表、匹配规则与 Zone Killer 屏蔽烧钱 zone。
阅读教程 →文档Facebook / Meta
两套独立集成:从 Meta 导入广告花费,以及用 Conversions API 服务端发送转化事件,含浏览器匹配与排错。
阅读教程 →文档Dolphin / Fbtool
通过 Dolphin(Fbtool)API 实时接收 Facebook 消耗:兼容 Keitaro 的入站端点、API 密钥与活动参数配置、消耗分摊与验证。
阅读教程 →文档FB 评论清理器
按计划批量审核 Facebook 广告贴下的评论:停用词、正则、链接与联系方式规则,默认 dry-run、默认隐藏、操作可恢复。
阅读教程 →文档流量来源与联盟
配置漏斗两端的两个目录:约 200 个流量来源模板与约 440 个联盟模板,参数三元组、postback URL 与 offer 参数宏。
阅读教程 →文档报表、日志与指标
仪表盘、报表生成器、趋势与群组、流量日志与点击卡片,以及每个指标的计算方式。
阅读教程 →文档域名与 SSL
添加域名、把 DNS 指向服务器、自动签发 Let's Encrypt 证书,以及 Domains 页面上每个开关的作用。
阅读教程 →文档Cloudflare
通过 API 接入 Cloudflare:域名自动停放 A 记录、多账号、代理(橙色云朵)与 Flexible / Full / Strict SSL 模式。
阅读教程 →文档管理
用户、角色与按资源授权、两步验证、API 密钥、安全设置、geo 数据库、面板更新与系统状态。
阅读教程 →文档Telegram 机器人
在 Telegram 里管理追踪器:转化通知、每日摘要、统计命令,以及发到频道/群组的转化提醒。
阅读教程 →文档MCP:追踪器里的 AI 助手
把 Claude 或任何 MCP 客户端连上 Orbitra,用大白话管理广告系列:41 个工具、远程与本地两种连接方式、API 密钥安全。
阅读教程 →