Документация

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; невалидные перегенерируются на сервере;

отбрасываются);

появления воронки рендерит ровно то же, что и раньше** — витрина по-прежнему первый экран, ios_flow по-прежнему управляет оверлеем клика по установке, карточка пуша по-прежнему принадлежит установленному приложению.

Семантика воронки (JS страницы)

не-store прячет вёрстку витрины с самой первой отрисовки (data-flow-first, ставится скриптом в <head> до появления body).

включённый шаг**; когда шаги кончились, CTA откатывается к прежней попытке установки (нативный промпт / iOS-оверлей / редирект по конфигу). Оператор решает, где сработает промпт установки, порядком шагов воронки.

разрешения (передача в sw.js не тронута), Not now закрывает шаг и двигает воронку дальше. Если после ответа на пуш шаги кончились, посетитель уходит на оффер (flowExhausted); при app_action = screen вместо этого показывается экран установленного приложения.

standalone-ветка — beacon открытия, подтверждение установки на iOS, синхронизация пуша, затем app_action — ведёт себя ровно как прежде.

глобальный смысл и срабатывают на оффер независимо от видимого шага.

Трекинг по экранам

Каждая активация экрана воронки отправляет beacon /pixel.gif?action=pwa&kind=screen&screen=<id>&subid=<click>:

(NULL-guarded; строка клика — гейт дедупликации, как у всякой колонки pwa_*);

(last-write-wins);

(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.

Статистика

агрегируются в карточках дашборда, списке кампаний, campaign_report и таблицах Landings и Offers (паритет: отчёт == кампании). Один клик закономерно даёт несколько просмотров; производной метрики-отношения сверху нет.

кликов, зарегистрированные в $allowed_dimensions (api.php, campaign_report), поэтому работают и как слои Group By, и как фильтры. NULL (строки до появления фичи, не-PWA трафик) группируется как Unknown.

странице 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] и остаются визуально идентичными.

Тесты

дедуп/лимит/атрибуция beacon'ов и эндпоинт funnel-stats (HTTP, sandbox харнесса).

для pwa_screen_views в SQL дашборда, лендингов и офферов (просмотры 1:N: клик даёт каждый виденный им экран, включая повторные заходы).

← Назад
PWA-лендинги и Web Push
Вперёд →
Конверсионные попапы
Исходник на GitHub: github.com/fenjo26/Orbitra.link/wiki
Все гайды
Документация

Быстрый старт: первая кампания

Короткий путь: установите трекер, создайте кампанию и получите первые клики и конверсии меньше чем за час.

Читать гайд →
Документация

Установка и обновление

Установите 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 и управляйте кампаниями обычными словами.

Читать гайд →