Dolphin / Fbtool
Dolphin 和 Fbtool.pro 自身没有自己的追踪器集成。这两个服务只做一件事:通过 Keitaro 的 Admin API 把消耗发送给 Keitaro。因此 Orbitra 里的"Dolphin/Fbtool 支持"是一个兼容的入站端点:服务照常调用它,以为自己在和 Keitaro 通信:
POST https://your-tracker.com/admin_api/v1/campaigns/CAMPAIGN_ID/update_costs
Authorization: Bearer <API_KEY>
Content-Type: application/json
{
"start_date": "2026-08-15",
"end_date": "2026-08-15",
"cost": 12.34,
"currency": "USD",
"timezone": "Europe/Berlin",
"filters": { "sub_id_4": "120212558973560058" }
}
响应沿用 Keitaro 的格式:{"success":true, ...},或 HTTP 状态码 + {"success":false,"error":"..."}。
该端点实现在 admin_api.php 里;路由位于 .htaccess(Apache)和 core/nginx_config.php(nginx)。更新后重新生成 nginx 配置时会自动带上这个 location。
1. 创建 API 密钥
该端点接受追踪器的个人密钥(user_api_keys 表)— 也就是 MCP 用的同一批密钥。
- 管理员打开 ⚙ → Users → API keys。
- 创建一把带 write 权限的密钥(只读密钥会得到
403)。 - 密钥通过
Authorization: Bearer <key>或X-Api-Key: <key>请求头传递。
2. Dolphin 设置
Dolphin → Settings → Cost export → Keitaro:
- Tracker URL:
https://your-tracker.com - API key:第 1 步创建的密钥
- Matching:按 Adset ID(默认)— 此时
sub_id_3过滤器会自动匹配到点击的adset_id参数。
3. Fbtool.pro 设置
Fbtool → Costs → Keitaro:
- Admin panel URL:
https://your-tracker.com - API key:第 1 步创建的密钥
- Fbtool 按
ad.id匹配并发送sub_id_4过滤器 — 会自动匹配到点击的ad_id参数。
4. 活动上必须配置什么
过滤器匹配的是点击参数(clicks.parameters_json)。Facebook 流量来源模板会把这些参数放到每次点击上:活动必须接收链接中带有
ad_id={{ad.id}}&adset_id={{adset.id}}&campaign_id={{campaign.id}}
的流量。
在活动编辑器里选择"Facebook Ads"来源即可完成:参数自动填好(Parameters 标签页、带宏的链接)。
5. 消耗如何分摊
- 该活动在
[start_date .. end_date]内的点击,再按过滤器收窄。 - 过滤器的键先按原样作为参数名尝试(
ad_id、adset_id、campaign_id……),再加上 Keitaro FB 模板的默认映射:sub_id_3→adset_id、sub_id_4→ad_id。多个过滤器以 AND 组合。 - 总金额换算成追踪器币种(
core/CurrencyRates.php),然后在匹配的点击之间均摊(统一 CPC)— 与core/CostImporter.php使用的模型相同。 - 重发同一时间段会覆盖之前的分摊而不是累加(这两个服务每 60–90 分钟发送一次消耗)。
- 如果一个点击都没找到,金额会存进
cost_records,挂在隐藏的external_api连接下、不做归因 — 消耗不会无声消失。如果消耗"迟迟不到",检查过滤器和活动的参数。
6. 验证
curl -X POST 'https://your-tracker.com/admin_api/v1/campaigns/10/update_costs' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"start_date":"2026-08-15","end_date":"2026-08-15","cost":10,"currency":"USD","filters":{"ad_id":"123456"}}'
响应 {"success":true,"clicks":N,...} 表示消耗已记录并分摊到 N 次点击。clicks:0 — 消耗被存放但未归因:过滤器在该时间段内没有匹配到任何点击。
v0.9.7.7 新增。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →