文档

落地页(参考文档)

落地页(landing page)是访客在前往 offer 途中看到的页面。Orbitra 提供四种类型,它们的区别主要关乎一个问题:购买按钮如何通向 offer。

类型页面放在哪里Offer 链接
Local(本地)上传的 ZIP,由追踪器托管{offer} 或 /?_lp=1
Redirect(跳转)你自己的主机、另一个域名/?_lp=1 + JS adapter
Preload(预载)由追踪器抓取,以你的域名展示{offer}
Action(动作)不展示页面;由追踪器执行动作—

本地落地页

压缩包解压到 landings/<landing id>/。入口是 index.html,启用 PHP 落地页时也可以是 index.php。

要求

与 Keitaro 不同,Orbitra 不会添加 <base> 标签,也不会改写你的标记。页面按你上传时的字节原样输出,其文件相对当前展示的落地页解析。有两点值得知道:

链接到 offer

最简单的写法,也是首选:

<a href="{offer}">Buy</a>

{offer} 会被替换成带签名的落地页→offer 过渡链接(自 1.6.14 起,与 Keitaro 一致):点击经过追踪器,漏斗得以统计,offer 的宏在跳转时替换。1.6.14 之前它嵌入的是广告主的直链,绕过了追踪器 — 设置"offer selection: before"的流会显示零点击。

一个页面上放多个 offer 时,两种写法都行 — 显式写法在任何版本都可用:

<a href="/?_lp=1&offer_id=10">Offer 10</a>
<a href="{offer}&offer_id=22">Offer 22</a>

在 {offer} 后追加 &offer_id= 会切换 offer(自 1.6.14 起):{offer} 展开为带签名的过渡链接,追踪器会读取该参数并重新归因点击 — 转化落在你指定的那个 offer 上。1.6.14 之前,{offer} 展开为广告主直链,参数只是原样传给对方;显式的 /?_lp=1&offer_id=N 写法则在任何版本都有效。

传递访客在落地页上做出的选择(产品、套餐或问卷答案)采用 Keitaro 的方式:把 sub_id_1 … sub_id_30 加到过渡链接上,它们会更新点击。

<a href="/?_lp=1&sub_id_5=Blue%20Watch&sub_id_6=https%3A%2F%2Fcdn.example%2Fblue.jpg">Buy the blue one</a>

offer URL 随后以 {sub_id_5} / {sub_id_6} 接收它们,例如 https://network.example/?sub1={clickid}&product={sub_id_5}&image={sub_id_6}。这些值同时写入点击,报表和 postback 看到的是同样的内容。只接受 sub_id_N 键,空值绝不会抹掉流量来源发来的内容,每个值上限 512 字节。托管在别处的落地页则把它们追加到签名链接上:{lp_url}&sub_id_5=…。

自 1.6.14 起,{offer}&sub_id_5=… 也可用 — 该宏本身就是过渡链接,所以你追加的内容会被追踪器读取。如果值在点击之前就已知(每个广告系列只有一个产品),可以完全跳过落地页一步,把 ?sub_id_5=… 直接放进广告系列链接。

落地页停留时长

无需在页面上添加任何东西:追踪器输出的每个落地页都会在 </body> 之前注入一个小计时器。它上报访客停留了多久 — 无论他们是否按过 offer 按钮,这正是它与 Time to offer 的区别:没人点击跳出的页面在旧指标下什么都不会上报,而这恰恰是最值得找出来的页面。

它测量什么,以及刻意不测量什么:

它出现在哪里:Logs 里的 Time on LP 列(低于 5 秒的值会高亮)和点击详情中;报表里则是 Time on LP、LP bounce rate、LP scroll depth 和 LP measured visits 指标,外加 Time on LP (bucket) 维度。从未上报的访问 — 托管在别人域名上且没装追踪脚本的跳转落地页、不执行 JS 的机器人 — 会归入 Unknown,而不是被算成零秒访问。

托管在别处的落地页,同样的计时器内置于 tracking.js / kclient.js;PHP 页面则输出 $client->timerScript()(见 Tracking Client (PHP))。

会话录制与热力图

落地页编辑器的 Session recording 标签页为该落地页开启类 Clarity 录制:访客比例(5–100%)、录制时长,以及共享的存储上限。录制在 ⚙ → Logs → Session recordings 中回放;同一标签页还可打开该落地页的点击热力图和滚动图。Local 和"Show HTML"落地页无需额外操作;外部页面通过 tracking.js / kclient.js / kclient.php 录制。表单字段在访客浏览器端打码。→ 会话录制与点击热力图

宏

在本地落地页的 HTML 中替换:

宏值
{offer}带签名的落地页→offer 过渡链接(/index.php?_lp=1&_token=…;自 1.6.14 起点击经过追踪器,漏斗得以统计,追加的 &offer_id= / &sub_id_N 参数也会生效;与 {lp_url} 值相同)
{lp_url}同一个带签名的过渡链接,拼写形式面向外部落地页
{offer_id}所绑 offer 的 ID
{clickid}、{subid}点击 ID
{token}签名 token,JS adapter 使用
{keyword}、{sub_id_1} … {sub_id_30}从流量来源捕获的点击参数

取自 URL 的值会做 HTML 转义。其他一切不动 — {unknown}、JS 模板字面量、Vue 和 Angular 语法都原样保留。

流上没有 offer 时,{offer} 会变成不带签名的过渡链接,点击它会展示配置错误的说明,而不是默默重新加载页面。


跳转(外部)落地页

落地页放在你自己的主机上。追踪器把访客送过去,并追加两个参数:

https://your-landing.example/promo?_subid=<click id>&_token=<signed token>

这个 token 是 offer 链接能工作的根本。别的域名上的落地页读不到追踪器的 cookie,没有 token 追踪器就无法判断回来的是哪次点击。它用 HMAC-SHA256 签名,24 小时后过期;URL 里裸的 _subid 不会被单独接受,否则任何人都能把访问归到任意点击 ID 上。本地或 preload 落地页改为从 cookie 里恢复点击,因此不需要 token。

落地页自身 URL 里的 {offer} 会展开为同一个过渡链接(绝对地址 http://your-tracker/index.php?_lp=1&_token=…),因此从查询参数取 CTA 的落地页也能拿到可用链接。这两种行为都需要 v1.6.14;在此之前这一对参数根本不会送达,{offer} 嵌入的是广告主直链。

安装 JS adapter,然后这样链接 offer:

<a href="/?_lp=1">Buy</a>

适配器会把它改写成指向追踪器的绝对链接,并附上 _subid 和 _token。


Preload 落地页

追踪器在服务器端抓取你的页面,注入 <base href> 使其图片和样式仍从原站加载,应用宏,然后以你的域名输出结果 — 没有跳转。offer 链接用 {offer}。


Action 落地页

什么都不展示。选择要发生的动作:

动作结果
Send to campaign把访客交给另一个广告系列;点击在两边都计入
Show a 404 error空白页,状态码 404
Show as text以 text/plain 输出你填写的文本
Show as HTML输出你填写的 HTML
Do nothing空响应;访客停留在原地

文本和 HTML 两种变体中都会替换 {offer}、{clickid} 和点击参数。

Keitaro 不经跳转就把访客交给另一个广告系列。Orbitra 使用跳转:在同一请求里再次进入追踪器意味着把它的入口脚本包含两次,PHP 做不到这一点。无论哪种方式,点击都会记录进两个广告系列 — 访客只是多走了一跳。


JS adapter

<script src="https://your-tracker/js/orbitra-adapter.js"
        data-postback="https://your-tracker/POSTBACK_KEY/postback"></script>

把它粘贴到每个页面的 <head> 里。面板会在落地页设置下方展示已填入你自己密钥的代码片段。

跳转落地页必须安装。本地落地页如果有多页,则可选但有用:它把点击带到内页和表单,第二页仍然知道访客是谁。

它刻意不碰 Keitaro 适配器会改写的东西:#anchors、mailto:、tel: 和 javascript: 链接原样保留,指向第三方域名的链接也绝不会带上你的点击 ID。

从页面上报转化

<a href="{offer}" onclick="orbitraPostback(this, event, 'lead', 10)">Buy</a>

参数依次为:元素、事件、转化状态、可选的金额和可选的交易 ID。即使 postback 失败,跳转也会继续 — 因为上报打了个嗝就丢掉订单是更糟的交易。

对表单处理程序来说,PHP 更简单:

file_get_contents('https://your-tracker/POSTBACK_KEY/postback?subid=' . urlencode($_COOKIE['subid']) . '&status=lead');

PHP 落地页

默认关闭。在 Settings → General → Allow PHP landings 里开启,并且只对你信任其代码的落地页使用:PHP 落地页运行在追踪器内部、Web 根目录下。

要求

  1. 入口页为 index.php。
  2. 上传时拒绝以下调用:exec、system、shell_exec、passthru、proc_open、popen、pcntl_exec、pcntl_fork、dl、eval、assert、create_function、symlink、link、set_time_limit、ini_set、ini_alter。
  3. 用绝对路径引入其他文件:
   require_once dirname(__FILE__) . '/src/lib.php';   // right
   require_once 'src/lib.php';                        // wrong
  1. 执行时间保持在超时限制内(默认 3 秒,最大 9 秒)。给每个 curl 调用设置超时:
   curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 3);
   curl_setopt($ch, CURLOPT_TIMEOUT, 3);

读取点击

<?php
$clickId = $rawClick->get('click_id');
$keyword = $rawClick->get('keyword');
$offer   = $rawClick->get('offer');      // the offer URL, same as {offer}

$rawClick 是只读的。要记录转化,请发送 postback。

扫描不是沙箱。 它用 PHP 自带的 tokenizer 读取上传的源码,因此看到的是真实调用而不是注释里的单词 — 但 $f = 'sys' . 'tem'; $f(); 可以绕过它,任何其他追踪器里的同等检查也拦不住这种写法。真正控制住风险的是:该功能默认关闭、只有管理员能开启,以及你 php.ini 里的 disable_functions 和 open_basedir 对落地页与其他任何代码一视同仁。请设置它们。


LeadForge 2.0(落地页分析器、JS 校验与多联盟桥接)

LeadForge 2.0 是 Orbitra 内置的引擎,用于分析、清理落地页包,并把它们重新嫁接到目标联盟。

集成模式

150 国电话号码校验与客户端适配器(orbitra_adapter.js)

启用后,LeadForge 会注入 orbitra_adapter.js,提供:

通用 CPA 订单桥接(order.php)

生成一个独立、自包含的订单处理程序,支持 10 家 CPA 联盟:


故障排查

图片和视频不加载。 请使用相对路径。如果路径正确而页面仍然裸奔,检查你打开的是广告系列 URL,而不是直接访问 landings/<id>/index.html。

购买按钮点了没反应。 落地页很可能还直接指向广告主 — 从别人的漏斗复制来的落地页保留着他们的联盟链接。把这些 href 换成 {offer}。

Landing transition failed: original click not found。 别的域名上的落地页没装 JS adapter,或者访客禁用了 cookie 且 URL 里没有 _token。

no offer attached to this stream。 流上有落地页但没有 offer。添加一个 offer,或者把落地页当作最终页面、去掉 offer 链接。

PHP 落地页显示"disabled on this tracker"。 该功能未开启;见上文。

← 上一篇
浏览器检查
下一篇 →
PWA 与 Web Push
在 GitHub 上查看源码: github.com/fenjo26/Orbitra.link/wiki
全部教程
文档

快速上手

从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。

阅读教程 →