广告系列与流
广告系列(campaign)就是流量到达的 URL,外加一组决定每个访客去向的流(stream)。Campaigns 板块在顶部菜单里。
广告系列编辑器
编辑器全屏打开。在宽屏(1280px 及以上)上分为两栏:左侧是广告系列设置,右侧是流;更窄的屏幕上则合并为单列。
设置标签页
| 标签页 | 内容 |
|---|---|
| General | 名称、别名(6 个字符,自动生成)、广告系列 URL、域名、分组、流量来源、状态、测试链接;标签页下方还有社交链接预览卡片和 Zone Killer 规则 |
| Finance | 计费模式、唯一性、流轮询类型 |
| Parameters | 追踪器把哪些链接参数保存进点击(keyword、cost、external_id、creative_id、ad_campaign_id、source、sub_id_1 … sub_id_30),以及从哪些来源参数取值 |
| Integrations | 像素(Facebook / TikTok 等,见 Facebook / Meta)和接入消耗同步(消耗) |
| Tracking | 集成代码生成器:追踪脚本、kclient.js、kclient.php、像素、横幅(script / iframe)、WordPress 插件、小部件(倒计时、"返回按钮"、exit-intent 退出意图)。首次保存后可用 — 代码里包含广告系列 token |
| Popup | 广告系列自己的转化弹窗:开/关(开启时标签页上有圆点标记)、实时预览、四个步骤和 Advanced 区块 |
| S2S Postbacks | 发往流量来源的出站 postback、postback 测试器、补发漏掉的转化 — 见 Postback 与转化 |
| Notes | 自由文本 |
计费模式
CPC、CPV、CPuC(按唯一点击)、CPM、CPA、CPS、RevShare。如果接入了消耗导入,手动填写的消耗会被导入值覆盖(消耗)。
唯一性
- 判定方式: IP、IP + User-Agent 或 Cookies。
- 周期: 以小时计。
- 唯一性在三个范围内分别计算 — 按广告系列、按流和全局;三者都会显示在报表里。
广告系列状态
已停止的广告系列(paused / disabled)以 503 响应,已归档的以 404 响应。别名 URL、click.php 和 Click API 都是如此。
社交链接预览
General 标签页上的一张卡片。启用后,访问广告系列 URL 的社交或即时通讯预览机器人 — facebookexternalhit、telegrambot、whatsapp、twitterbot 等链接预览抓取器 — 拿到的是一张只含你的标题、描述和图片的极简 og:* 卡片,而不是点击流程。所有真人的路由与从前完全一样:没有延迟,也没有不同的页面。
搜索爬虫(googlebot 之类)刻意继续看到真实的广告系列响应 — 这里只针对即时通讯工具的预览抓取器;完整的机器人处理是斗篷的职责。启用时的一次性免责声明会记录:自定义预览是否符合平台规则由运营者自行负责。
流
流就是一条路由规则:过滤器(匹配谁)+ 方案(展示什么)。
类型与顺序
- 拦截(Intercepting) — 最先检查。适合机器人、白页和例外情况。
- 常规(Regular) — 主流量。按位置或权重选择("Finance" 标签页上的轮询类型)。
- 兜底(Default) — 以上都没有匹配时。
保存广告系列不会重建它的流:每条流保持稳定的 ID,点击历史不会散落到旧编号上。新建的流命名为 "Stream 1"、"Stream 2"…卡片上的折叠箭头(chevron)可以收起流;折叠状态按广告系列记忆。
每张流卡片都显示今天 / 昨天 / 7 天 / 30 天的访问量、唯一访客、机器人数量及其在广告系列流量中的占比。这样可以一眼看出多少流量进了白页流、多少进了盈利流。
过滤器
| 过滤器 | 工作方式 |
|---|---|
| Country(国家) | 国家列表或 geo 配置(EU、CIS…)。当国家无法判定且为"包含"模式时,过滤器不放行该访客 — 但前提是装了 geo 数据库;没装则该过滤器弃权 |
| Device(设备) | Desktop / mobile / tablets(桌面 / 移动 / 平板) |
| Operating system、Browser | 取值来自追踪器实际能识别的列表,包括应用内浏览器(TikTok、Facebook、Instagram、Telegram、WebView)。也可以自己输入值再按回车 |
| Browser language(浏览器语言) | en — 任意英语;en-IN — 仅英语(印度)。参与比对的是整个 Accept-Language,而不只是第一种语言 |
| Bot(机器人) | 以最高灵敏度运行的机器人检测器(与斗篷使用的相同) |
| IP address(IP 地址) | 地址和 CIDR,IPv4 和 IPv6 |
| Provider (ISP)(运营商) | 与访客的 ISP 和 ASN 比对(需要 ASN 数据库) |
| Connection type(连接类型) | 来自 geo 数据库的数据 |
| Referer、Keyword(关键词) | 与点击上的对应值比对 |
| URL parameter(URL 参数) | 按名称匹配任意链接参数。不区分大小写的精确匹配;* — 任意字符;"Empty" — 参数缺失或为空 |
| Day of week、Time(时间) | 按访客的当地时间(时区取自 geo 数据库;没有则用服务器时间) |
一条流的多个过滤器以 AND(必须全部匹配)或 OR(一个即可)组合。无法做出判定的过滤器(没有 geo 数据库、没有 ISP 数据)不参与投票:在 "AND" 下它不会拦住流,在 "OR" 下它也不会放行流。
对付 TikTok 审核的技巧,利用"URL parameter":在广告系列 URL 上加 xxx=__PLACEMENT__;在挂白页的拦截流上,针对 xxx 设置一个"URL parameter"过滤器,取值 __PLACEMENT__ 和 "Empty"。真实点击里平台会把宏替换成实际值,而打开裸链接的审核员则带着 __PLACEMENT__ 或根本没有这个参数到来。
方案
| 方案 | 会发生什么 |
|---|---|
| Direct redirect to offer(直接跳转到 offer) | 跳转到目录里的 offer(多个 offer 按权重轮询)或直接 URL。每一次这样的跳转都是一次点击 |
| Landing + Offer | 先展示落地页,访客再从落地页前往 offer。offer 可选 |
| Action(动作) | 什么都不做、返回 404、展示文本、展示 HTML、送往另一个广告系列(点击同时写入两个广告系列) |
| Cloaking(斗篷) | 在安全页和盈利页之间分流 — 见 斗篷 |
"Landing + Offer" 方案下的 Offer selection(offer 选定时机):
- After the click(新流的默认值)— 访客真正离开落地页时才选定 offer。LP 点击、LP CTR 和到 offer 的时间都是真实数据。
- Before the click — 每次落地页展示都算作一次到 offer 的点击(旧行为,LP CTR 接近 100%)。
如何在落地页上构造 offer 链接({offer}、/?_lp=1、把 sub_id_N 传给 offer)见落地页。
Offer 跳转类型
在 offer 上设置。所有类型的宏和 SSRF 检查都相同。
| 类型 | 行为 |
|---|---|
| HTTP redirect | 302 跳转,默认值 |
| JS redirect | 通过 JavaScript 跳转的 HTML 页面 |
| Meta Refresh | 一个 <meta http-equiv="refresh"> 标签 |
| Iframe | 以你域名下的整页 iframe 展示 offer |
| Form Submit | 自动提交的 POST 表单:追踪数据放在请求体里 |
| curl proxy | offer 页面经由你的服务器输出,并带 <base> 标签 |
带自动优化的轮询
流的 offer 或落地页列表旁的 Auto 开关,可按指标自动重算权重:确认订单数、CR、EPV、EPC 或 ROI(ROI 需要消耗数据)。可配置项:以天计的窗口期、参与分流所需的最少订单数、份额的上下限和重算间隔。重算由 rotation_optimiser_cron.php cron 完成;决策日志显示在流卡片上。"Auto" 开启期间,手动输入权重被锁定。
其他流设置
- Collect clicks — 关闭时访客仍会得到去向,但点击不写入(也就没有东西可以挂转化)。
Bot Challenge 是广告系列级的设置,不是流级的:在选定流之前进行真人验证(reCAPTCHA v2/v3 或你自己的代码)。
测试链接
"General" 标签页的 Test link(测试链接)一行生成带 ?_t=<id>:<hmac> 签名的广告系列 URL。真实的路由逻辑完全生效 — 流、过滤器、轮询、落地页、offer — 但点击不记录,统计保持干净。
&_geo=DE— 覆盖访客国家:不用 VPN 就能测试按国家划分的流。&_dbg=1— 不跳转,而是显示一张轨迹页:每条流及其类型、方案,每个过滤器的投票(匹配 / 不匹配 / 弃权及原因)、选中的流,以及宏替换后的最终 URL。
签名由安装的 postback 密钥派生,因此更换广告系列 token 不影响它;更换 postback 密钥则会使所有测试链接失效。无效或他人的签名会让请求变成一次普通点击。
流量模拟
⚙ → Traffic simulation(流量模拟):设置 IP、User-Agent、国家、设备、语言和 URL 参数 — 面板会显示命中哪条流、为什么,且不记录任何数据。
Click API 与广告系列 token
每个广告系列都有一个 token(32 位十六进制字符)。集成脚本(click.php、kclient.php、tracking.js、Click API v3 /click_api/v3)按 token 而不是 ID 寻址广告系列。从 Keitaro 导入时 token 会一并迁移,已装好的脚本继续可用。token 可以在编辑器里重新签发。PHP 客户端的细节见 Tracking Client (PHP)。
重复点击防护
- 同一访客(广告系列 + IP + User-Agent)在 2 秒内的重复点击不会写成第二行;跳转会拿到已记录点击的 ID。
- 浏览器的 prefetch/prerender 请求会被响应但不写入。
- 如果数据库繁忙(
database is locked),点击会进入var/spool/clicks.log,由cli/click_spool_cron.phpcron 在一分钟内写入。
批量操作
复制广告系列、批量删除、导入、把一组广告系列移到另一个域名(bulk_set_campaign_domain,MCP 里也可用)、直接在列表里重命名分组。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →