落地页(参考文档)
落地页(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。
要求
- 入口页必须命名为
index.html(或index.php)。 - 使用相对路径:
img/hero.jpg,而不是/img/hero.jpg。两者都能用,但相对路径在本地直接打开压缩包时也能工作。 - 不要在站内重定向到
index.html— 否则访客会离开被追踪的 URL。
与 Keitaro 不同,Orbitra 不会添加 <base> 标签,也不会改写你的标记。页面按你上传时的字节原样输出,其文件相对当前展示的落地页解析。有两点值得知道:
- 你自己写的
<base>标签不会被改动。 - 锚点链接(
href="#form")、弹窗脚本和平滑滚动都正常工作。在 Keitaro 里这些会失效,因为它会改写每一个href。
链接到 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 的区别:没人点击跳出的页面在旧指标下什么都不会上报,而这恰恰是最值得找出来的页面。
它测量什么,以及刻意不测量什么:
- 只统计可见时间 — 留在后台的标签页不累计;
- 达到的最深滚动深度(0–100%),与秒数并列;
- 5、15、30、60 秒检查点,之后每分钟一次;页面隐藏或卸载时最后上报一次,所以关掉的标签页也能留下数字。
它出现在哪里: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 根目录下。
要求
- 入口页为
index.php。 - 上传时拒绝以下调用:
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。 - 用绝对路径引入其他文件:
require_once dirname(__FILE__) . '/src/lib.php'; // right
require_once 'src/lib.php'; // wrong
- 执行时间保持在超时限制内(默认 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 内置的引擎,用于分析、清理落地页包,并把它们重新嫁接到目标联盟。
集成模式
- Auto Mode(自动模式):通过代码特征自动识别来源联盟,并把表单提交映射到目标联盟。
- Cross-Network Mode(跨联盟模式):移除旧联盟的订单处理程序(
send.php、order.php、api.php),清掉外来的追踪像素/脚本,并安装通用多联盟桥接。 - Raw Mode(Clone Patch 克隆补丁):剥掉外来统计代码和脚本,注入 ClickID/SubID 桥接和
{offer}宏,不生成后端处理程序。
150 国电话号码校验与客户端适配器(orbitra_adapter.js)
启用后,LeadForge 会注入 orbitra_adapter.js,提供:
- 150 国规则:精确的本国与国际号码正则、移动运营商号段校验,以及最小/最大长度限制。
- 动态切换国家:用户改变
<select name="country">时,自动更新校验规则、长度上限和计数器文案。 - 交互式实时输入徽标:实时计数已输入和还差的位数(例如 «3 cifre inserite, 7 mancanti» → «Numero complete»,意大利语"已输入 3 位,还差 7 位"→"号码完整")。
- 严格的 Unicode 姓名校验:实时过滤,阻止客户姓名中出现数字和垃圾符号。
- 触觉振动反馈:手机号格式无效时让移动设备振动。
- ClickID / SubID 桥接:捕获所有传入的追踪参数(
subid、click_id、sub1..sub5、utm_*、fbp、fbc等),并在多页漏斗间填充表单字段。
通用 CPA 订单桥接(order.php)
生成一个独立、自包含的订单处理程序,支持 10 家 CPA 联盟:
- Dr.Cash、Webvork(带 SuperClient 回退)、Lucky.online、KMA.biz、TerraLeads(带 SHA1 校验和验证)、Leadbit、LemonAD、Everad、Ezaff,以及自定义 Webhook。
- 自动 E.164 规范化:把本地电话号码标准化为国际格式,并对国家前缀进行核对。
- CRM 双写:把 lead 同时发给联盟,并将完整的原始 lead 快照记录进 Orbitra CRM Vault(
orbitraCrmRecordLead//crm-ingest)。 - 本地兜底日志:lead 会追加写入
leadforge.leads.log和orbitra_leads_backup.log。
故障排查
图片和视频不加载。 请使用相对路径。如果路径正确而页面仍然裸奔,检查你打开的是广告系列 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"。 该功能未开启;见上文。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →