文档

外部 PWA 与 Telegram 频道

在 Orbitra 自带 PWA 构建器之外拓宽漏斗的两种方式:把第三方 PWA 服务用作流目标,以及把 Telegram 频道用作 offer 目的地并对订阅者做归因。

外部 PWA 构建器

第三方服务(PWA.Group、TSL.app 或其他任何一家)可以像落地页一样成为流目标:

  1. 创建构建器 — ⚙ → Integrations → External PWA。从目录(data/external_pwa_services.json:重定向 URL 模板、postback 模板、状态映射)里挑一个服务,或自己填写;你的值优先于目录值。内置目录条目只是模板 — 上量之前请对照该服务的最新文档逐项核实参数。
  2. 把服务指回追踪器:在其后台设置中,把安装完成后的重定向设为

https://<tracker-domain>/eflow/<campaign-alias>?subid={subid}&eid={eid} (页面会给出可直接复制的精确格式)。

  1. 把它加进流 — 在活动编辑器的落地页区块点 Add external PWA。外部构建器与落地页共用同一个加权池,因此这个分流能让你在一条漏斗里做 "自有 PWA vs 第三方" 的 A/B。

流量跑起来之后:点击带着 subid = 点击 id 前往该服务(clicks.external_pwa_id 记住是哪家服务)。当访客回到 /eflow/<alias>,追踪器标记安装时间(external_install_at)、保存服务的 eid(保留 7 天),然后按活动自身的选择继续前往 offer — 与安装后的"自有"PWA 完全一样。

这些点击上的转化通过与联盟 postback 同一条可靠 s2s 队列回传给服务,内容包括 subid + eid + 该服务的状态词(按服务映射)+ payout。活动报表新增 external installs(外部安装)。

Telegram 频道作为 offer

Telegram 频道类型的 offer 通过漏斗 bot 把广告访客送进 Telegram 频道,并把入频记为转化。漏斗 bot 与管理 bot 相互独立(Integrations → Telegram):管理 bot 只回复你连接的会话、只读你的统计数据,绝不能让广告来的陌生人碰到它。面板会拒绝把管理 bot 的 token 用作漏斗 bot。

配置步骤:

  1. 在 @BotFather 创建一个新 bot,把它的 token 填到 ⚙ → Integrations → Telegram funnel bots。
  2. 把该 bot 以管理员身份加进你的频道,并授予 Invite users via link(通过链接邀请用户)权限。频道会自动出现在 bot 的卡片上(也可以在那里用 @name、t.me/… 或 -100… 手动添加)。
  3. 创建一个 Telegram 类型的 offer,选择 bot 和频道,设置入频有效期(1–7 天),可选填欢迎语。
  4. 把 offer 放进活动流,用活动链接跑流量。绝不直接外发频道链接 — 那样的入频无法归因。

漏斗流程:

  1. 点击 → https://t.me/<funnel bot>?start=<subid> — /start 把 Telegram 用户绑定到点击(tg_start)。
  2. bot 回复欢迎语和一个需申请入频的邀请链接(creates_join_request=true,随 offer 的有效期一起过期)。
  3. chat_join_request → bot 只批准它在有效期内邀请过的用户,并在绑定的点击上写入一条 tg_join 转化(带活动和 offer)。其他任何人的申请都留给频道管理员处理。
  4. 联盟只掌握订阅者身份时,向常规 postback URL 发请求,用 tg_user_id 和 channel_id 代替 subid:

https://<domain>/<postback key>/postback?tg_user_id={tg_user_id}&channel_id=-100…&status=deposit&payout=50 — 系统会解析到该用户 30 天内最近一次加入该频道对应的点击。offer 编辑器的 Integration 标签页显示精确的 URL。

漏斗 bot 由 cli/tg_funnel_poll_cron.php 轮询(每分钟一次,所有 bot 并行,不用 webhook — 没有域名也能工作)。install.sh 会配置调度;轮询没在跑时,bots 页面会显示对应的 crontab 行。

← 上一篇
创意库
下一篇 →
Postback 与转化
在 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 密钥安全。

阅读教程 →