创意库
Content Gallery 的 Creatives 标签页回答一个问题:哪套创意真的在赚钱。它在现有素材库的基础上生长而来 — 平台同步来的文件(Facebook 图片和视频、TikTok 封面)与你自己的上传并列存放,每套创意都带有花费/收入/ROI,手动上传的草稿一旦有广告开始投放就立刻获得数据。
数据如何进来
无需任何手动配置。链路是:
- 花费同步(aggregator cron 或 Sync now)从 Facebook/TikTok 拉取花费行。现在每行还携带广告/广告组/广告系列的名称以及平台自己的展示/点击计数(
cost_records.impressions、cost_records.platform_clicks),并 upsert 进ad_entities。 - 创意元数据扫描(
core/CreativeSync.php,每条连接限流为每 3 小时一次)向平台询问这些广告的内容:创意的图片 hash / 视频 id / 广告文案。绑定关系写入creative_usages,下载任务进入creative_fetch_queue。 - 文件 worker(
cli/creative_fetch_cron.php,由 install.sh 每 5 分钟调度一次)下载实际文件:Facebook 的原图(按 hash 走/act_X/adimages,视频源 + 封面),TikTok 的封面和预览(/file/video/ad/info/、/file/image/ad/info/)。去重以 sha256 精确匹配;近似重复用 64 位 dHash、汉明距离阈值 ≤6 匹配 — 这正是"草稿已上线"的关联机制:手动上传的草稿会绑定到平台的副本,而不是再生成一条重复项。 - 每日聚合(
core/CreativeStats.php::rebuildWindow)在每次花费同步后重建creative_daily:花费(含代理费)、展示、平台点击、追踪器点击/访客、安装、注册、FTD 和收入 — 追踪器指标通过带索引的clicks.ad_ref列归入广告账户自己时区的自然日。
worker 按签名校验下载内容(视频看 mp4 ftyp / webm EBML,图片用 getimagesize),通过中途断开传输来强制执行大小上限(图片 10 MB、视频 100 MB),并走该连接配置的代理。当文件已排队但 worker 尚未运行时,标签页会显示一条横幅提醒。
Creatives 标签页
- Filters(筛选):时间段(默认最近 7 天)、平台、格式、标签、搜索、仅活跃(广告仍在投放的创意),可按花费/收入/ROI/点击排序。
- KPI 卡片按去重后的素材统计 — 一条 3 图 carousel 算一套创意,当天花费在三张图之间平摊。
- 没有收入时 ROI 显示为短横线,绝不是 −100%:只是还没出转化的创意不算烧掉的钱。颜色:绿色 ≥ 30%,琥珀色 0–30%,红色为负。
- 创意卡片:逐日序列(花费柱、ROI 标记)、投放过它的广告及其状态和花费(Cabinet › Campaign › Adset 逐层下钻)、广告文案、近似重复组、你的标签、下载。
- 标签是自由格式(
offer, geo, approach, creator)— 按标签的报表回答"哪种打法更有效"。
创意还出现在哪里
- 活动报表新增 Creative 分组(显示文件名而不是干巴巴的广告 id),广告行上还有预览缩略图。
- 活动编辑器有 Creatives 标签页:最近 7 天里哪些创意给这个活动带来了流量,并带全站 ROI。
- Telegram 每日摘要列出当天最好和最差的各 3 套创意;当最近 7 天相对前 7 天的 ROI 或平台 CTR 跌幅超过阈值(默认 −50%)、且花费高于下限(默认 $50)时,触发 burnout(创意衰减)告警。阈值:设置项
telegram_creative_burnout_drop_pct、telegram_creative_burnout_min_spend。 - Ads Manager 扩展在广告的逐日列旁边显示 CREATIVE ROI(累计)。
- MCP:
orbitra_creatives_top、orbitra_creative_detail。 - 平台同步来的素材和其他文件一样,可在 MediaPicker 中用作 PWA/落地页海报。
归因健康横幅
报表顶部的横幅("Revenue linked to ads: 62%")来自 action=revenue_attribution_health:任何一个广告级点击参数携带真实平台 id 时,收入才算已关联 — 未替换的 __CID__ / {{ad.id}} 宏按缺失计,与花费导入诊断用的是同一规则。Fix 按钮直接跳到问题来源的编辑器,并高亮参数标签页。
备注
- TikTok 视频文件不下载(API 需要单独的素材授权);保存封面,创意仍带有完整指标。
- 第二优先级的功能(AI 文案提取、自动打标)有意尚未实现。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →