PWA-воронка
Рендерер v16 · миграция 51. Визит в браузере на PWA-лендинг теперь — настраиваемая воронка: упорядоченный список экранов, где первый включённый шаг — то, что холодный посетитель видит первым; каждая активация экрана отправляется beacon'ом и попадает в отчёты, а каждый экран может нести свой собственный трекинг-скрипт.
Модель воронки
У 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 | Полноэкранный шаг с инструкцией по установке. Рендерятся оба списка платформ; CSS по ключу data-store (сниффинг UA в <head>) показывает шаги Safari на iOS и шаги из меню Chrome на остальных |
push | Карточка подписки на пуш внутри браузерной воронки. Только при Push enabled — без VAPID-ключа или поддержки браузера шаг стал бы тупиком, поэтому в рантайме воронка его тоже пропускает |
Правила (PwaLanding::normalizeFunnel() — белый список, редактор порождает только формы, которые он принимает):
- id совпадают с
^[a-z0-9_]{1,32}$, уникальны и никогда не конфликтуют со
встроенными id; невалидные перегенерируются на сервере;
- одна
store/ однаinstructions/ одинpushна воронку (дубли
отбрасываются);
- максимум 5 шагов
screen; - отсутствующий или невалидный
funnel→[store]. **Каждый конфиг до
появления воронки рендерит ровно то же, что и раньше** — витрина по-прежнему первый экран, ios_flow по-прежнему управляет оверлеем клика по установке, карточка пуша по-прежнему принадлежит установленному приложению.
Семантика воронки (JS страницы)
- На холодном визите показывается первый включённый шаг; первый шаг
не-store прячет вёрстку витрины с самой первой отрисовки (data-flow-first, ставится скриптом в <head> до появления body).
- Любой CTA с
.install-triggerвнутри воронки **переводит на следующий
включённый шаг**; когда шаги кончились, CTA откатывается к прежней попытке установки (нативный промпт / iOS-оверлей / редирект по конфигу). Оператор решает, где сработает промпт установки, порядком шагов воронки.
- Карточка пуша в воронке: Allow запускает штатный механизм запроса
разрешения (передача в sw.js не тронута), Not now закрывает шаг и двигает воронку дальше. Если после ответа на пуш шаги кончились, посетитель уходит на оффер (flowExhausted); при app_action = screen вместо этого показывается экран установленного приложения.
- Установленное приложение (открытие в standalone) — не часть воронки:
standalone-ветка — beacon открытия, подтверждение установки на iOS, синхронизация пуша, затем app_action — ведёт себя ровно как прежде.
- Таймеры
auto_redirect/decline_redirect/install_redirectсохраняют
глобальный смысл и срабатывают на оффер независимо от видимого шага.
Трекинг по экранам
Каждая активация экрана воронки отправляет beacon /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click>:
clicks.pwa_entry_screen— первый экран, который когда-либо видел клик
(NULL-guarded; строка клика — гейт дедупликации, как у всякой колонки pwa_*);
clicks.pwa_last_screen— шаг, на котором клик был последним
(last-write-wins);
pwa_screen_views— «сырой» журнал событий 1:N
(click_id, landing_id, screen, created_at) с потолком 100 строк на клик, чтобы забытая вкладка, гоняющая экраны по кругу, не накачивала таблицу. Создаёт его миграция 51; всегда включённый self-heal DDL гарантирует его наличие на каждой версии схемы — 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— обычные колонки
кликов, зарегистрированные в $allowed_dimensions (api.php, campaign_report), поэтому работают и как слои Group By, и как фильтры. NULL (строки до появления фичи, не-PWA трафик) группируется как Unknown.
- Эндпоинт
pwa_funnel_stats— карточка воронки по каждому лендингу на
странице Landings (кнопка с диаграммой на PWA-строках): просмотры/уники по экранам, распределения входов и выходов (выход = последний экран клика без перехода на оффер) и матрица переходов экран → экран, собранная по упорядоченному журналу событий. Порядок экранов в первую очередь повторяет конфиг воронки.
Редактор и превью
На шаге 1 конструктора PWA появился раздел Visit funnel: список шагов с переупорядочиванием (перетаскивание за grip, кнопки ↑/↓), переключатели включения, бейдж первого экрана, редакторы по экранам (шаблон, заголовок/текст/кнопка, hero-картинка через MediaPicker, свой HTML + трекинг-JS) и индикатор лимита (0/5). Живое превью может открыть воронку на любом включённом шаге — pwa_preview принимает id шага в view и форсирует его через window.__PWA_FORCE_SCREEN.
Версия рендерера и self-heal
RENDERER_VERSION бампнут 15 → 16: роут лендера и сервер корня домена на следующем просмотре перегенерируют статику, написанную старым рендерером, поэтому уже созданные PWA получают загрузку воронки (и beacon просмотра витрины) без пересохранения. Легаси-конфиги перегенерируются с воронкой [store] и остаются визуально идентичными.
Тесты
tests/pwa_funnel_http_test.php— модель конфига воронки, разметка потока,
дедуп/лимит/атрибуция beacon'ов и эндпоинт funnel-stats (HTTP, sandbox харнесса).
tests/report_metrics_test.php— вручную посчитанные контрольные значения
для pwa_screen_views в SQL дашборда, лендингов и офферов (просмотры 1:N: клик даёт каждый виденный им экран, включая повторные заходы).
Быстрый старт: первая кампания
Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.
Читать гайд →ДокументацияУстановка и обновление
Установите Orbitra на чистый сервер Ubuntu или Debian одной командой и безопасно обновляйтесь до новых версий.
Читать гайд →ДокументацияМиграция из Keitaro
Перенесите кампании, офферы, источники и домены из Keitaro в Orbitra в один клик — что переносится и что проверить.
Читать гайд →ДокументацияМиграция из Binom
Перенесите кампании и потоки из Binom в Orbitra: что переносится автоматически, а что настроить вручную.
Читать гайд →ДокументацияВозможности Orbitra
Всё, что умеет Orbitra: кампании и потоки, клоакинг, лендинги, PWA, постбеки, расходы, отчёты и интеграции.
Читать гайд →ДокументацияКампании и потоки
Полный справочник: настройки кампаний, типы потоков, схемы, ротация, фильтры, тестовые ссылки и каждый параметр.
Читать гайд →ДокументацияКлоакинг
Полный справочник по клоакингу: уровни детекции, глобальные настройки, фильтры потоков, вердикты и отчёты.
Читать гайд →ДокументацияПроверка браузера
Как JS-проверка ловит ботов, виртуальные машины и эмуляторы через противоречия в окружении браузера.
Читать гайд →ДокументацияЛендинги
Типы лендингов, макрос {offer}, JS-адаптер, LeadForge и мульти-оффер лендинги — полный справочник.
Читать гайд →ДокументацияPWA-лендинги и Web Push
Собирайте устанавливаемые PWA-приложения и собирайте push-подписчиков: настройки, иконки, события и уведомления.
Читать гайд →ДокументацияPWA-воронка
Многошаговая PWA-воронка: приглашения к установке, отслеживание событий и возвратные уведомления.
Читать гайд →ДокументацияКонверсионные попапы
Показывайте реальные конверсии как попапы на странице: настройка, триггеры и размещение.
Читать гайд →ДокументацияЗаписи сессий и карта кликов
Воспроизводите реальные визиты, смотрите карты кликов и скроллов. Лимиты хранения и приватность.
Читать гайд →ДокументацияГалерея контента
Центральное хранилище иконок, скриншотов и креативов для PWA и лендингов.
Читать гайд →ДокументацияБиблиотека креативов
Храните креативы с отслеживанием по subid и тестируйте их в разных кампаниях.
Читать гайд →ДокументацияВнешние PWA и Telegram-каналы
Публикуйте PWA на внешних доменах и используйте Telegram-каналы как источник трафика.
Читать гайд →ДокументацияПостбеки и конверсии
Входящие постбеки, статусы и типы конверсий, исходящие S2S-постбеки в источник трафика.
Читать гайд →ДокументацияРасходы: импорт из рекламных кабинетов
Импорт расходов из Facebook, TikTok и Google Ads, обновление через API и крон — и как работает агрегатор доходов.
Читать гайд →ДокументацияPush и pop сети
Работа с пуш и поп источниками трафика: фиды, оптимизация зон и zone killer.
Читать гайд →ДокументацияFacebook / Meta integration
Импорт расходов из Meta Ads и Conversions API: серверные события с дедупликацией.
Читать гайд →ДокументацияDolphin / Fbtool — приём расходов (Keitaro Admin API)
Получайте расходы Facebook через API Dolphin (Fbtool) в реальном времени.
Читать гайд →ДокументацияЧистилка комментариев FB
Массовая модерация комментариев под рекламой Meta: скрывать, удалять и фильтровать по ключевым словам.
Читать гайд →ДокументацияИсточники трафика и партнёрские сети
Каталог 50+ источников трафика и 440+ сетей: шаблоны, параметры и адреса постбеков.
Читать гайд →ДокументацияОтчёты, логи и метрики
Конструктор отчётов, сохранённые отчёты, логи кликов и каждая метрика с пояснением.
Читать гайд →ДокументацияДомены и SSL
Добавление доменов, DNS, бесплатные сертификаты Let's Encrypt, редиректы, парковка и каждый переключатель на странице.
Читать гайд →ДокументацияCloudflare — DNS и SSL доменов
Как запускать домены кампаний через Cloudflare: DNS, режимы SSL и что отключить.
Читать гайд →ДокументацияАдминистрирование
Пользователи, роли и права, настройки безопасности, гео-базы, обновления и состояние системы.
Читать гайд →ДокументацияTelegram-бот
Управляйте трекером из Telegram: статистика, конверсии и алерты в чате.
Читать гайд →ДокументацияMCP-сервер: работа с трекером через нейросеть
Подключите Claude или любой MCP-клиент к Orbitra и управляйте кампаниями обычными словами.
Читать гайд →