Push 与 Pop 联盟
从 push 和 pop 广告主联盟导入花费,外加 Zone Killer — 找出(并在你授权时屏蔽)烧钱 zone 的规则。所有功能集中在一处:⚙ → Integrations 里的 Push/Pop networks 卡片,位于 Facebook / TikTok / Google 花费旁边的广告网络分组。
支持的联盟
| 联盟 | 花费粒度 | API key |
|---|---|---|
| AdMaven | 活动 × zone | Advertiser panel → API section → API token |
| PropellerAds | 活动 × zone | SSP → Profile → API token |
| Kadam | 活动 × zone | Advertiser account → API section → API token |
| Galaxion | 活动 × zone | 账户的 E-mail + 密码(追踪器自行获取 token),或现成的 API token |
| HilltopAds | 仅活动 | My Account → API tab → API key |
| Adsterra | 仅活动 | Settings → API tab → Generate new token(只有最新的 token 有效) |
| Clickadu | 仅活动 | Advertiser account → API section → API key |
标记为仅活动的联盟,其 API 里其实有 zone 明细,但明细行不带活动 id — 那里的 zone 无法关联到买这些点击的活动。它们的花费只会摊到活动的点击上;连接卡片会在你接入前对此提示。
接入
选一个联盟磁贴,粘贴密钥,点 Check connection — 会显示账户的真实余额 — 然后保存。每条连接有自己的更新周期;列表里的按钮:Update spend(立即更新)、暂停、编辑、删除。删除连接后,已导入的花费仍保留在报表里。
同步与其他花费连接在同一次 aggregator_cron.php 轮里运行(见 Costs):每轮重读最近 5 天,首轮读 30 天。同一天重复同步是安全的 — 花费重新计算,不会累加。
花费如何落到点击上
核心要求与 Facebook 或 TikTok 相同:活动必须使用该联盟的流量来源模板,让链接把联盟的广告系列 id(进入 ad_campaign_id)和 zone id 带上(Keitaro 来源模板写进 source,内置 PropellerAds 模板写进 zone)。没有 zone 宏花费照样落地 — 但只能到活动级,永远无法按 zone 拆分。
匹配顺序,从最具体到最宽:
- 活动 × zone — zone 行只归因到同一天、且同时携带 zone id 和联盟广告系列 id 的点击。光有 zone id 不够:zone id 跨联盟并不唯一。
- 活动 — zone 没匹配到任何点击的 zone 行,会累加到该活动不带 zone 的点击上(绝不会爬到已被各自 zone 行计价的点击上 — 多个未匹配的 zone 相互累加而不是相互覆盖)。
算作"zone"的点击参数键:zone、zone_id、zoneid、sub_source_id。
如果同步返回"记录收到了,但没有一条能挂到点击上",最可能的原因是活动没有使用该联盟的来源模板 — 链接没把可匹配的广告系列 id 带进来。Costs 里的 "Received N, matched 0" 诊断在这里同样适用。
Zone Killer
活动编辑器 General 标签页上的一张卡片(活动需先保存)。一条规则把活动绑定到一条 push/pop 花费连接,并决定哪些 zone 是候选:
- window(回看窗口)— 往前多少天评判(窗口内按 zone 累计花费和转化);
- min spend(最低花费)— 花费低于此值的 zone 不值得动;
- zero conversions 和/或 max ROI — 屏蔽条件;
- mode(模式)—
dry_run(默认)或auto(带单轮屏蔽上限)。
候选 zone 基于 clicks.cost / clicks.revenue 按 zone 计算 — 与报表展示的是同一批分摊数字,zone 键也与花费导入匹配时用的完全一致,因此规则绝不会用与导入不一致的价格去评判某个 zone。
- Dry-run 列出候选;你勾选后点 Block selected(屏蔽所选)。
- Auto 让
zone_rules_cron.php自动执行候选(每轮有上限),并通过 Telegram 通知屏蔽了什么。
屏蔽动作通过联盟的写入 API 下发,支持 AdMaven、HilltopAds、PropellerAds、Kadam 和 Galaxion。Adsterra 和 Clickadu 没有可用的 zone 写入 API:它们的规则只能停留在 dry-run,卡片会复制所选的 zone id,方便你手动粘进联盟的黑名单。
每一次屏蔽和解屏蔽 — 无论手动还是自动 — 都会连同决策依据的指标写入一份只追加的日志;当前被屏蔽的集合,就是最近一次成功动作为"block"的 zone。日志渲染在规则下方。
对仅活动级的联盟(HilltopAds、Adsterra、Clickadu),Zone Killer 只能近似评判 zone — 按 zone 占活动点击的份额,因为 API 不提供逐 zone 花费。这类联盟的规则请保持在 dry-run,屏蔽前先核对列表。
Cron
*/15 * * * * php /var/www/orbitra/aggregator_cron.php >> /var/www/orbitra/var/logs/aggregator.log 2>&1
*/30 * * * * php /var/www/orbitra/zone_rules_cron.php >> /var/www/orbitra/var/logs/zone_rules.log 2>&1
第一行是安装器为花费同步添加的 cron。第二行 — Zone Killer 的执行器 — 由你自己添加,且只有用 auto 规则时才需要;每一轮开销很小(没有候选的规则只是一次针对活动点击的 GROUP BY)。参数:--campaign=12(单个活动)、--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 密钥安全。
阅读教程 →