会话录制与热力图
回看访客在你的落地页上做了什么:鼠标移动、滚动、点击和点按,像视频一样回放。原理与 Microsoft Clarity 或 Yandex Webvisor 相近,区别在于录制数据保存在你自己的服务器上。每个落地页还会得到点击热力图和滚动图。
从 v1.8.3 起,录制还覆盖整个网站,而不只是落地页:一个每个页面都装了追踪脚本的自然流量站点(SEO 流量、自己的服务页)可以跨页面录制 — 一次访问就是一条录制,播放器里能看到页面切换,且每页有独立的点击热力图。见下文录制整站(自然流量)。
开启录制
- 打开落地页 → Session recording 标签页。
- 勾选 Record sessions on this landing(在此落地页录制会话)。
- 选择录制多大比例的访客:5 / 10 / 25 / 50 / 100 %。访客随机抽取,但结果按点击固定(同一次点击要么始终录制,要么从不录制)。
- 选择录制时长:直到你手动关闭,或 1 小时 / 24 小时 / 3 天 / 7 天。时间一到录制自动停止,已录好的内容保留。
- 点击 Save — 落地页常用的保存按钮。
标签页会根据该落地页过去 24 小时的真实流量给出实时估算,例如:"about 120 recordings a day, roughly 18 MB"(每天约 120 条录制,约 18 MB)。
机器人和安全页访客永远不会被录制。服务器在发送页面之前就完成了判断,这些访客连录制脚本都拿不到。
录制整站(自然流量)
对于不是落地页的站点 — 靠 SEO、直接流量和社交流量生存的服务型网站 — 录制在活动层级开启:
- 把
tracking.js放到站点的每个页面,位于<head>与</head>之间(代码片段在活动的 Tracking 标签页里)。这里要用tracking.js—kclient.js和kclient.php不支持跨页面会话和同意(consent)API。 - 打开活动 → Integrations 标签页 → Session recordings 卡片。
- 设置与落地页相同:录制比例(流量大的站点通常 5–10 % 就够 — 一次访问的每个页面都占磁盘)、录制时长,以及基于活动真实流量的实时估算。
- 如果还想把访问粘合成一次点击,勾选 Multi-page site: one click per visit(多页面站点:每次访问一个点击)— 见下一节。
之后一次访问会跨页面录制:播放器显示页面切换,列表显示访客打开了多少个页面、第一页和最后一页是什么,点击热力图多出页面选择器(每页有自己的热力图),录制列表还可以按活动、按流量来源(Google / Bing / Yandex / social / direct)、按页面子串以及按仅多页面过滤。
活动级开关也覆盖那些到达落地页、但落地页自身没有录制设置的点击 — 不过只要某个落地页配置过录制,它就始终完全掌控自己的点击(它的开关关闭就真的关闭)。
每次访问一个点击
不勾选时,站点的每个页面都在活动里登记自己的点击 — 与以往一样。勾选 Multi-page site: one click per visit 后,访客在站内多个页面之间的浏览只算一次点击:统计不再被页面浏览量灌水,录制也粘合成一条会话。
粘合机制有多重保护,付费点击绝不会被记忆中的点击吞掉:
- 只有当访客来自同一站点(站内跳转)且距上一页不足 30 分钟时,追踪器才会粘合;
- 带新增或变化的广告标记(
fbclid、gclid、ttclid、msclkid、utm_、sub_id_N等)的请求,即使在这 30 分钟内也算新的活动入口 — 第二次广告点击会得到自己的点击、自己的参数和自己的 CAPI 归因。站内链接原样传递同一组*标记的站点仍能正常粘合; - 该开关默认关闭:你自己勾选之前,更新永远不会改动任何人的点击数据。
Cookie 同意(欧盟站点)
对欧盟访客,会话录制需要取得访客同意。在活动卡片里勾选 Start only after cookie consent(获得 cookie 同意后才开始),访客同意之前什么都不写入 — 连热力图用的点击也不记。你的 cookie 横幅用一行调用唤醒录制器:
window.OrbitraReplay && OrbitraReplay.consent();
window.OrbitraReplay && … 这个保护很重要:tracking.js 会在每个页面定义 OrbitraReplay 桩对象,但你的横幅可能在它加载之前就触发 — 有了这个保护就不会出错。两个等效的替代方案:
- 你的同意管理工具可以直接把 localStorage 键
orbitra_replay_consent设为1— 录制器会轮询它,并在当前页面就启动,而不只是下一页; OrbitraReplay.revoke()撤回同意并立即停止录制;访客拒绝时,你的横幅应当调用它。
同意一经给出就会被记住,因此该访问的后续页面从一开始就能录制。访客撤回时清除记录是你的横幅的职责。同意模式控制写入的内容;隐私一节描述的表单字段遮罩在所有模式下都生效。
录制在哪些地方生效
| 场景 | 工作方式 |
|---|---|
| 上传到 Orbitra 的落地页(ZIP / 编辑器),或 "Show HTML" 动作落地页 | 自动 |
带 tracking.js / kclient.js 的外部落地页 | 自动:Click API 响应标明该点击需要录制时,脚本加载 /replay.js |
带 kclient.php 的外部落地页 | 自动:当前版本的 kclient.php 会在页面末尾输出录制器标签。也可以自己放置 <?php echo $client->replayScript(); ?> |
每页都带 tracking.js 的整站 | 自动(v1.8.3):活动 → Integrations 里的活动级开关覆盖该访问的每个页面 |
| 直接重定向到 offer 的活动 | 不可用:没有页面可录 |
跨页面粘合(?_subid= 续接)和同意桩只存在于 tracking.js;kclient.js 和 kclient.php 能录制各自的单页,但不粘合访问,也不暴露 OrbitraReplay。
查看录制
⚙ → Logs → Session recordings。 过滤器:落地页、活动、时间范围、设备(desktop / mobile)、流量来源(Google / Bing / Yandex / social / direct,从 referrer 推断)、页面子串(匹配访问的入口页或最后一页)、仅多页面、最短时长、去了 offer、已转化、含 rage clicks(暴怒点击)。每行显示时间、国家与设备、落地页与活动、时长、点击数(rage click 带 🔥 角标)、滚动深度、结果(转化 / 去了 offer / 离开)和文件大小;多页面访问会显示 "N pages" 角标以及首→末页路径。
点击任意列头即可排序(再次点击反转方向),列表分页显示,底部有每页条数选择器。
删除。 勾选行来选择,或勾选表头复选框选择整页。此时会出现一条操作栏,含 Delete (N) 和 Clear selection。当还有更多页时,还会出现 Select all recordings matching these filters (N)(选中所有符合当前过滤条件的录制),一次选中所有页面里符合条件的录制。所以"删除落地页 X 上所有 5 秒以内的移动端跳出"就是:设置过滤器 → 勾选表头 → Select all matching → Delete。每行还有自己的垃圾桶图标;存储面板里有 Delete this landing's recordings 和 Delete all recordings。
播放器支持播放/暂停、在每次点击处标红点的时间轴、1× 到 8× 倍速,以及 Skip inactivity(跳过无动作的停顿)。流量日志里的点击卡片在该点击被录制时也会出现 Session recording 按钮。
Rage click(暴怒点击):0.7 秒内在同一位置连点三次。通常意味着某个按钮或元素点了没反应,值得修复。
点击热力图与滚动图
可以从落地页的录制标签页打开,从活动的录制卡片打开,或在录制列表里先选中某个落地页/活动,再点 Click heatmap 按钮。
- 点击:访客点击的位置,从蓝色(少见)到红色(频繁)。红圈标出 rage click。桌面和移动端是两张独立的图,因为页面布局不同。
- 滚动:页面分成 10 段,每段标注 "X % reached Y %"(X % 的访客到达了 Y % 处)。它用的是驻留计时器,因此覆盖每一位被测量的访客,而不只是被录制的那些。
- 页面选择器(多页面站点):站点的每个页面有自己的点击图 — 选定一个路径,点击点和背景框架都会切到该页。没有它,所有页面会混进同一个毫无意义的坐标系。
热力图背后的页面画面取自该设备类型的最新一条录制(选定页面时,取该录制中对应的帧)。不会向线上站点发出任何请求,也不会记录任何点击。
该看什么
在日常投放下,录制的几种实际用法:
- 不转化的落地页。 过滤出该落地页,设 Duration ≥ 15 s,不勾 Went to offer,看 5–10 条访问。认真读了却仍不点击的访客通常会告诉你原因:移动端 CTA 在首屏之外、计时器或弹窗挡住了按钮、表单看起来坏了。
- Rage clicks。 勾选 With rage clicks。同一位置的聚集几乎总是意味着某个看起来可点其实点不动的元素(假视频、按钮图片、失效的锚链接)。热力图上的红圈一眼就能看到同样的问题。
- 移动端 vs 桌面端。 两端的热力图都打开看。如果滚动图上手机访客根本到不了下单区块,就缩短页面,或把 CTA 在更靠上的位置再放一次。
- 流量质量。 真人移动鼠标是曲线、有停顿、滚动不均匀。如果一批录制里毫无鼠标动作、瞬间完美滚动或加载一秒内就点击,说明该来源或版位的流量质量差或机器人多,即使它通过了斗篷过滤器。
- 改版前后对比。 修改落地页,删掉它的旧录制(按落地页过滤 → 勾选表头 → Select all matching → Delete),再把新热力图和旧的对比。
通常按 10 % 录制一两天就足以看清规律。不需要一直开 100 %。
存储限制
这些限制由所有录制来源共享 — 落地页和活动一视同仁。它们显示在落地页的录制标签页、活动的卡片上,以及录制列表的容量按钮下方:
- Keep recordings for(录制保留)1 / 3 / 7 / 14 / 30 天。更早的录制自动删除。
- Maximum disk space(最大磁盘占用):256 MB 到 20 GB。占满后最老的录制会被删除,新录制取而代之。
无法关闭的保底限制:
- 单条录制上限 30 分钟、5 MB;
- 服务器磁盘剩余不足 1 GB 时不开始新的录制;
- 从未收到任何数据的录制在 2 小时后被清理。
一条录制通常占 50–300 KB(它是页面结构加变化,不是视频)。卡片会显示你真实录制的平均值,以及所选上限大约能装多少条。
清理最多每分钟运行一次,由新进来的录制和打开列表的动作触发。更新后无需添加任何 cron,也没有要在服务器上跑的命令。
隐私
- 每个表单字段都在访客的浏览器里被遮罩。 他们输入的内容(电话、姓名、密码)永远不会离开设备;回放里只显示星号。
- 给任意区块加上
orbitra-no-recordclass 即可完全隐藏(回放中显示为空框)。用orbitra-mask则只遮罩其文字。 - 录制文件存放在你服务器的
var/replays/,nginx 配置不会公开提供这些文件。只有能访问落地页的用户才能通过面板读取。 - 如果录制欧盟访客,要么开启同意模式,要么在网站的隐私政策中提到会话录制。
排错
标签页显示 "Recording is on"(录制已开启),但列表一直是空的。
- 确认访问确实到达这个落地页:流必须把流量发给它,且访问不能是机器人或安全页访客(这些人永远不会被录制)。
- 比例设得低(5 %)而流量又少时,第一条录制可能要等一阵。想快速测试,就把比例设为 100 %,然后用手机打开活动链接。
- 检查录制窗口是否已到期:到期时落地页的标签页会显示 "Recording stopped…"(录制已停止)。
- 外部落地页:页面必须有
tracking.js、kclient.js或当前版本的kclient.php。旧版kclient.php不支持录制;从活动的 Tracking 标签页重新下载(Download kclient.php)。
"The recording is too short to play"(录制太短无法播放)。 访客在第一份页面快照发出之前就离开了(通常不到一秒)。对一部分跳出流量来说这很正常。
多页面访问仍显示为分开的点击。 One click per visit 粘合需要三个条件同时满足:活动卡片里勾选了开关、每个页面都有 tracking.js(而不是 kclient)、访客确实在站内浏览 — 来自广告、书签或其他站点的入口会刻意开启新点击,付费点击因此永远不会被粘合。另外检查 30 分钟窗口:长时间停顿之后,下一页会开启新点击。
回放没有样式或图片缺失。 回放从落地页自身的 URL 加载图片和字体。如果访问发生之后落地页的文件被删除或替换,旧录制就无法显示它们。
新录制停止了。 检查存储卡片:服务器磁盘剩余不足 1 GB 时录制会暂停,直到你腾出空间或调低上限。
某条录制显示 LIVE。 访客还在页面上。数据每几秒到达一批,录制会持续增长,直到访客离开(最多 30 分钟)。
技术说明
- 录制器:rrweb(
@rrweb/record),打包进/replay.js(约 25 KB gzip)。仅对被录制的点击以defer方式加载,数据分批在浏览器里 gzip 压缩。 - 接收:
POST /pixel.gif?action=rr。只有服务器预先标记的点击、且携带其 HMAC 签名时,数据批次才被接受。 - 存储:每条录制一个
.ndjson.gz文件,外加session_replays、replay_clicks(热力图点位,保留 30 天)和replay_landing_settings三张表,由 migration 76 添加。 - 自然流量站点(v1.8.3,migration 78):
replay_campaign_settings(活动开关、同意模式、每次访问一个点击)、跨页面会话用的entry_url/pages列、逐页热力图点位,以及 Click API v3 的访问续接 —tracking.js在同一访问的站内页面上发送?_subid=;服务器会对照已记忆点击的参数重新校验广告标记。源码:core/click_api.php(续接分支)、core/SessionReplay.php。 - 源码:
frontend/replay/recorder.js(用npm run build:replay重新构建)、frontend/src/components/replay/、tracking.js。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →