PWA 漏斗
Renderer v16 · migration 51。访客在浏览器里访问 PWA 落地页的这段旅程,现在是一条可配置的漏斗(funnel):一组按顺序排列的 screen(屏),第一个启用的步骤就是冷访客最先看到的画面;每块屏幕的每次激活都会上报数据,每块屏幕还可以携带自己的追踪脚本。
漏斗模型
landings.config_json 新增一个键 funnel — 一个有序的步骤数组:
"funnel": [
{ "id": "scr_k3x9_2a", "type": "screen", "enabled": true,
"template": "lobby", "title": "...", "text": "...",
"button": "...", "image": "...", "custom_html": "...", "custom_js": "..." },
{ "id": "store", "type": "store", "enabled": true },
{ "id": "instructions", "type": "instructions", "enabled": true },
{ "id": "push", "type": "push", "enabled": true }
]
步骤类型:
| type | 渲染的内容 |
|---|---|
store | Google Play / App Store 商店详情页(沿用现有标记;由 UA 决定布局) |
screen | 运营者自定义屏:模板 lobby / slot / wheel / custom HTML — 与已安装应用屏幕用的是同一批模板。每条漏斗最多 5 块 |
instructions | 整页安装指引屏。两个平台的步骤列表都会渲染;基于 data-store 的 CSS(<head> 里的 UA 嗅探)在 iOS 上显示 Safari 步骤,在其他设备上显示 Chrome 菜单步骤 |
push | 放进浏览器流程的 push 授权卡片。只在 Push enabled 时出现 — 缺 VAPID 密钥或浏览器不支持时,这一步会变成死胡同,所以运行时流程同样会跳过它 |
规则(PwaLanding::normalizeFunnel() 是白名单,编辑器只会产出它能接受的形状):
- id 须匹配
^[a-z0-9_]{1,32}$、唯一、且不与内置 id 冲突;非法 id 会在服务端重新生成; - 每条漏斗只能有一个
store/ 一个instructions/ 一个push(重复的会被丢弃); screen步骤最多 5 个;funnel缺失或非法 →[store]。每一份旧配置渲染出来的画面都与升级前完全一致 — 商店页仍是第一屏,ios_flow仍控制安装点击时的覆盖层,push 卡片仍属于已安装的应用。
流程语义(页面 JS)
- 冷访问时显示第一个启用的步骤;如果第一步不是商店页,商店布局从首次绘制起就被隐藏(
data-flow-first,由<head>脚本在 body 存在之前设置)。 - 流程内任何
.install-triggerCTA 都会推进到下一个启用的步骤;流程走完之后,CTA 回落到旧版的安装尝试(按配置执行原生提示 / iOS 覆盖层 / 重定向)。安装提示在哪一步触发,由你排列漏斗的顺序决定。 - 流程中的 push 卡片:Allow 走标准授权流程(与 sw.js 的交接保持不变),Not now 回应该步骤并继续前进。push 回答之后流程若已走完,访客前往 offer(
flowExhausted);app_action = screen时则改为显示已安装应用的屏幕。 - 已安装的应用(standalone 打开)不属于这条流程:standalone 分支 — 打开 beacon、iOS 安装确认、push 同步、然后执行
app_action— 行为与之前完全一致。 auto_redirect/decline_redirect/install_redirect定时器保持全局含义,无论当前显示哪一步,都会跳向 offer。
逐屏追踪
流程屏幕每次激活都会上报 beacon /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click>:
clicks.pwa_entry_screen— 该点击看过的第一块屏幕(带 NULL 保护;与所有pwa_*列一样,以点击行为去重闸门);clicks.pwa_last_screen— 点击最后停留的步骤(最后写入者生效);pwa_screen_views— 原始的 1:N 事件日志(click_id, landing_id, screen, created_at),每个点击上限 100 行,免得一个挂在后台不停轮播屏幕的标签页把表灌爆。migration 51 创建该表;常驻的自愈 DDL 保证它在每个 schema 版本上都存在,因为报表 SQL 无条件引用它。
每个 screen 步骤还可以携带 custom_js(编辑器里的 "Screen tracking script" 字段)。它在屏幕首次激活时执行,而不是页面解析时 — 广告像素绝不能在访客从未到达的屏幕上触发。模板的交互引擎(老虎机滚轮、红利转盘)被重构为按容器隔离的工厂,同一模板的多份副本因此能共存在一个页面上;元素 id 按步骤加前缀(fs<id>_…)。自定义脚本可用的辅助函数:window.orbitraFlow.next()、window.orbitraFlow.goto(id),以及原有的 orbitraRedirect / orbitraBeacon。
统计
pwa_screen_views指标 — 流程屏幕的浏览总量,聚合进仪表盘卡片、活动列表、campaign_report,以及 Landings 和 Offers 表格(报表与活动列表口径一致)。一个点击贡献多条浏览属正常;上面没有派生比率指标。pwa_entry_screen/pwa_last_screen维度 — clicks 表中的普通列,已注册进$allowed_dimensions(api.php、campaign_report),既可作 Group By 维度、也可作过滤器。NULL(功能上线前的旧行、非 PWA 流量)归入 Unknown 组。pwa_funnel_stats接口 — Landings 页面上每个 PWA 的漏斗卡片(PWA 行上的柱状图按钮):每屏的浏览量/独立访客数、进入与离开分布(离开 = 点击的最后一屏且未跳 offer),以及按有序事件日志走出来的屏幕→屏幕转移矩阵。屏幕顺序优先遵循漏斗配置。
编辑器与预览
PWA 构建器的第 1 步新增 Visit funnel 区块:可重新排序的步骤列表(手柄拖动、↑/↓ 按钮)、启用开关、首屏角标、逐屏编辑器(模板、标题/文本/按钮、经 MediaPicker 选择的主图、自定义 HTML + 追踪 JS),以及容量表(0/5)。实时预览可以从任意启用的步骤打开漏斗 — pwa_preview 接受步骤 id 作为 view 参数,并通过 window.__PWA_FORCE_SCREEN 强制指定。
渲染器版本与自愈
RENDERER_VERSION 从 15 升到 16:落地页路由和域名根目录服务会在下一次访问时重新生成旧渲染器写出的静态文件,已创建的 PWA 因此无需重新保存即可获得流程启动逻辑(以及商店屏的浏览 beacon)。旧配置按 [store] 漏斗重新生成,外观保持不变。
测试
tests/pwa_funnel_http_test.php— 漏斗配置模型、流程标记、beacon 去重/上限/归因,以及漏斗统计接口(HTTP,harness 沙箱)。tests/report_metrics_test.php— 仪表盘、落地页和 offer SQL 中pwa_screen_views的手算基准值(1:N 浏览:一个点击为它看过的每块屏幕各贡献一条记录,回访也计入)。
快速上手
从裸机服务器到第一条转化的九个步骤:安装、首次登录、域名、联盟与 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 密钥安全。
阅读教程 →