PWA-воронка
Renderer 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 }
]
Типи кроків:
| Тип | Що рендерить |
|---|---|
store | Листинг Google Play / App Store (існуюча розмітка; макет обирає UA) |
screen | Екран оператора: шаблон lobby / slot / wheel / custom HTML — ті самі шаблони, що використовує екран встановленого застосунку. До 5 на воронку |
instructions | Повноекранна сторінка інструкцій зі встановлення. Рендеряться обидва списки платформ; CSS із ключем data-store (UA-сніфінг у <head>) показує кроки Safari на iOS і кроки з меню Chrome в решті випадків |
push | Картка opt-in на push, розміщена в браузерному флоу. Лише коли ввімкнено Push enabled — без VAPID-ключа чи підтримки з боку браузера крок був би тупиком, тож флоу пропускає його й під час виконання |
Правила (PwaLanding::normalizeFunnel() — це білий список, редактор генерує лише форми, які він приймає):
- id відповідають
^[a-z0-9_]{1,32}$, унікальні й ніколи не перетинаються зі вбудованими id; некоректні перегенеровуються на сервері; - один
store/ одинinstructions/ одинpushна воронку (дублікати відкидаються); - максимум 5 кроків
screen; - відсутній або некоректний
funnel→[store]. Кожна конфігурація часів до воронки рендерить рівно те, що й рендерила раніше — магазин досі перший екран,ios_flowдосі керує оверлеєм кліка «Встановити», картка push досі належить встановленому застосунку.
Семантика флоу (JS сторінки)
- Перший увімкнений крок показується при холодному візиті; якщо перший крок — не магазин, макети магазину ховаються ще з першої відмальовки (
data-flow-first, встановлюється скриптом у<head>до появи body). - Будь-який CTA
.install-triggerу флоу переміщує на наступний увімкнений крок; коли кроки вичерпалися, CTA переходить до звичайної спроби встановлення (нативний prompt / iOS-оверлей / редирект за конфігом). Оператор вирішує, де спрацює запит на встановлення, порядком кроків у воронці. - Картка push у флоу: Allow запускає стандартний механізм запиту дозволу (передача в sw.js не змінена), Not now закриває крок і веде далі. Коли після відповіді на push кроки вичерпалися, відвідувач іде на оффер (
flowExhausted); приapp_action = screenнатомість показується екран встановленого застосунку. - Встановлений застосунок (відкриття в standalone) — не частина флоу: standalone-гілка — beacon відкриття, підтвердження встановлення на iOS, синк push, потім
app_action— поводиться точно як раніше. - Таймери
auto_redirect/decline_redirect/install_redirectзберігають глобальне значення і ведуть на оффер незалежно від видимого кроку.
Трекінг кожного екрана
Кожна активація екрана флоу надсилає 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 рядками на клік, щоб вкладка, що циклічно гортає екрани, не роздувала таблицю. Її створює міграція 51; постійний самовідновлюваний 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: список кроків із переставлянням (перетягування за «ручку», кнопки ↑/↓), перемикачі увімкнення, бейдж першого екрана, редактори кожного екрана (шаблон, заголовок/текст/кнопка, hero-зображення через 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 і ендпоінт funnel-stats (HTTP, пісочниця harness).tests/report_metrics_test.php— вручну розраховані піни дляpwa_screen_viewsу SQL дашборда, лендингів і офферів (покази 1:N: клік дає кожен екран, який бачив, включно з повторними візитами).
Швидкий старт: ваша перша кампанія
Короткий шлях: встановіть трекер, створіть кампанію та отримайте перші кліки й конверсії менш ніж за годину.
Читати гайд →ДокументаціяВстановлення та оновлення
Встановіть Orbitra на чистий сервер Ubuntu або Debian однією командою та безпечно оновлюйтеся до нових версій.
Читати гайд →ДокументаціяМіграція з Keitaro
Перенесіть кампанії, оффери, джерела та домени з Keitaro в Orbitra одним імпортом — що переноситься і що перевірити після нього.
Читати гайд →ДокументаціяМіграція з Binom
Перенесіть кампанії та потоки з Binom у Orbitra через Public API: що переноситься автоматично, а що налаштувати вручну.
Читати гайд →ДокументаціяОгляд можливостей
Усе, що вміє Orbitra: кампанії та потоки, клоакинг, лендинги, PWA, постбеки, витрати, звіти та інтеграції.
Читати гайд →ДокументаціяКампанії та потоки
Повна довідка: налаштування кампаній, типи потоків, схеми, ротація, фільтри, тестові посилання та кожна опція з поясненням.
Читати гайд →ДокументаціяКлоакинг
Повна довідка з клоакингу: шари детекції, глобальні налаштування, фільтри потоку, вердикти та звіти.
Читати гайд →ДокументаціяПеревірка браузера
Як JS-перевірка ловить ботів, віртуальні машини та емулятори за суперечностями в браузерному оточенні.
Читати гайд →ДокументаціяЛендинги
Типи лендингів, макрос {offer}, JS-адаптер, LeadForge та мультиофферні лендинги — повна довідка.
Читати гайд →ДокументаціяPWA та Web Push
Створюйте встановлювані PWA-застосунки та збирайте push-підписників: налаштування, іконки, події та сповіщення.
Читати гайд →ДокументаціяPWA-воронка
Воронка візиту на PWA-лендинг: екрани до встановлення, трекінг кожного екрана, статистика показів і матриця переходів.
Читати гайд →ДокументаціяКонверсійні попапи
Попап із кнопкою оффера на лендингах: вкладка Popup, вертикальні шаблони, тригери показу і метрики показів та CTR.
Читати гайд →ДокументаціяЗаписи сесій і теплові карти
Реплеї реальних візитів, теплові карти кліків і скролу, ліміти сховища, приватність і запис цілих сайтів.
Читати гайд →ДокументаціяГалерея контенту
Повна довідка Галереї: папки, завантаження, MediaPicker у редакторах, контракти розміру, обмеження форматів і відео.
Читати гайд →ДокументаціяБібліотека креативів
Креативи з витратами, доходом і ROI: синк файлів з Facebook і TikTok, дедуплікація, звіти і алерт вигорання креативів.
Читати гайд →ДокументаціяЗовнішні PWA та Telegram-канали
Сторонні PWA-сервіси як цілі потоків (/eflow) і Telegram-канали як оффери: funnel-бот, вступи-конверсії та атрибуція.
Читати гайд →ДокументаціяПостбеки та конверсії
Вхідні постбеки, статуси й типи конверсій, вихідні S2S-постбеки на джерело, черга доставки, тестер і імпорт конверсій.
Читати гайд →ДокументаціяВитрати
Імпорт витрат з Facebook, TikTok, Google Ads і push/pop-мереж, розподіл по кліках, агентські комісії та агрегатор доходу.
Читати гайд →ДокументаціяPush- і pop-мережі
Імпорт витрат із push/pop-мереж і Zone Killer: правила, що знаходять і блокують зони, які палять бюджет.
Читати гайд →ДокументаціяFacebook / Meta
Імпорт витрат з Meta Ads і Conversions API: токени, мапінг статусів, серверні події з дедуплікацією і діагностика.
Читати гайд →ДокументаціяDolphin / Fbtool
Отримуйте витрати Facebook у трекер через API Dolphin (Fbtool) у реальному часі: API-ключ, налаштування сервісів і розподіл витрат по кліках.
Читати гайд →ДокументаціяЧистильник коментарів FB
Масова модерація коментарів під рекламою Meta за розкладом: набори правил, винятки, сухий прогін, журнал дій і авто-пауза.
Читати гайд →ДокументаціяДжерела трафіку та партнерські мережі
Два довідники, що налаштовують «краї» воронки: шаблони джерел і мереж, параметри, постбек у джерело та офферні параметри.
Читати гайд →ДокументаціяЗвіти, логи та метрики
Дашборд, список кампаній, конструктор звітів, тренди й когорти, лог трафіку та картка кліка — і як рахується кожна метрика.
Читати гайд →ДокументаціяДомени та SSL
Додайте домени, наведіть DNS на сервер, отримайте безкоштовний сертифікат Let's Encrypt і розберіться з кожним перемикачем на сторінці Domains.
Читати гайд →ДокументаціяCloudflare
Інтеграція з Cloudflare через API: A-записи ставляться автоматично, а з проксі SSL роздає Cloudflare — без certbot і очікування валідації.
Читати гайд →ДокументаціяАдміністрування
Користувачі, ролі та права по ресурсах, налаштування безпеки, гео-бази, оновлення панелі й розширення Ads Manager.
Читати гайд →ДокументаціяTelegram-бот
Керуйте трекером із Telegram: статистика, конверсії та сповіщення в чаті, вебхук або поллінг і алерти в канали.
Читати гайд →ДокументаціяMCP: ШІ-асистент у трекері
Підключіть Claude або будь-який MCP-клієнт до Orbitra й керуйте кампаніями, офферами та доменами звичайними словами.
Читати гайд →