Налаштування PWA
Вкладка «Налаштування PWA» — іконка, взаємодія на iOS, push prompt, webview-bypass, маніфест, зовнішній вигляд та схожі додатки.
Вкладка Налаштування PWA містить п'ять блоків (іконка на екрані, взаємодія на iOS, запит сповіщень, відкриття в браузері, маніфест), підвкладку Зовнішній вигляд і вкладку Схожі. Тексти push і webview мовозалежні.
Іконка на домашньому екрані
| Поле | Тип | За що відповідає | Дефолт |
|---|---|---|---|
| Використовувати окрему іконку | перемикач | Дозволяє задати іконку для «Add to Home Screen», відмінну від іконки сторінки PWA | вимкнено |
| Іконка | upload (кроп 1:1) | Файл кастомної іконки | — |
Якщо перемикач вимкнено або файл не завантажений, darkcore не додає іконки в manifest.json і <head>. Браузер або ОС використовує власний стандартний вигляд. Коли окрема іконка є, прев'ю показує її в трьох формах маскування: Коло (Pixel), Скруглений квадрат (Samsung), Округлений (iOS).
Взаємодія на iOS
Цей блок належить PWA. Stream лише обирає PWA як ціль правила і не змінює її iOS-сценарій.
| Режим iOS | Флоу |
|---|---|
| Лендінг | Показує PWA. У Safari користувач може додати її на головний екран. Закриття інструкції не веде на офер. |
| Прямий редірект | Одразу веде на офер, без показу PWA. |
| Гібрид | «Завантажити» → анімація → «Відкрити» → офер. Після анімації або закриття підказки автопереходу немає. |
Для режимів Прямий редірект і Гібрид доступна опція Слати Lead при редіректі без інсталу. У гібридному режимі клік Відкрити класифікується як редірект без інсталу.
Міграція старих налаштувань
Під час міграції старі stream-level значення переносилися в PWA лише тоді, коли всі потоки, що використовують цю PWA, мали однакові явні значення, а у PWA ще не було власного значення. В інших випадках зберігається безпечний дефолт PWA.
Запит сповіщень (push pre-prompt)
| Поле | Тип | За що відповідає | Дефолт |
|---|---|---|---|
| Увімкнено | перемикач | Показувати pre-prompt перед системним запитом | увімкнено |
| Стиль промпту | select | Модалка / Верхній банер / Нижній банер / Нативний (без pre-prompt) | Модалка |
| Тригер показу | select | При завантаженні / Із затримкою / Після кліку встановити / При кліку Install / Після скролу % / На вихід | Із затримкою |
| Затримка (секунди) | число 0–30 | Пауза перед показом (лише для тригера «Із затримкою») | 2 |
| Після відмови | select | Більше не показувати / Кожен візит / Нагадати ще раз / Кожні N днів | Більше не показувати |
| Інтервал (дні) | число 1–30 | Для стратегії «Кожні N днів» | 3 |
| Заголовок / Текст | текст (локаліз.) | Тексти промпту | плейсхолдери |
| Кнопка прийняти / відхилити | текст (локаліз.) | Тексти кнопок | «Дозволити» / «Пізніше» |
| Іконка промпту | upload (1:1) | Іконка в промпті (фолбек — іконка застосунку) | — |
| Затемнення фону | перемикач | Оверлей за модалкою (лише стиль «Модалка») | увімкнено |
| Закривати при кліку ззовні | перемикач | Дозвіл закрити кліком поза модалкою | увімкнено |
Стиль Нативний відкриває системний діалог браузера напряму — він вимагає жесту користувача, тож доступні лише тригери «Після кліку встановити» і «При кліку Install». Інші тригери браузер тихо заблокує.
Відкрити в браузері (webview-bypass)
In-app браузери Instagram, Facebook і TikTok не дають повноцінно встановити PWA. Webview-bypass розпізнає такий браузер і показує користувачу короткий шлях у Chrome або Safari. Тут налаштовується вигляд цього екрана.
| Поле | Тип | За що відповідає | Дефолт |
|---|---|---|---|
| Заголовок / Текст / Текст кнопки | текст (локаліз.) | Написи заглушки (порожньо = стандартні) | плейсхолдери |
| Затемнення фону | перемикач | Напівпрозоре тло за модалкою | увімкнено |
| Дозволити закриття модалки | перемикач | Чи можна закрити модалку, лишившись в in-app браузері | увімкнено |
Як працює вихід із webview
| Платформа | Основний сценарій | Якщо автоматичний вихід не спрацював |
|---|---|---|
| Android | Сторінка пробує відкрити поточний URL у Chrome через системний intent | Показує кнопку повторного відкриття, а потім URL, який можна скопіювати або відкрити вручну |
| iOS | Сторінка пробує відкрити Safari й копіює поточний URL | Показує готове посилання та інструкцію: скопіювати його, відкрити Safari й вставити в адресний рядок |
Автоматичний перехід може не спрацювати, коли in-app браузер блокує зовнішні схеми без жесту користувача, Chrome/Safari недоступний як очікуваний браузер, ОС заборонила доступ до буфера обміну або відкриття було заблоковане політикою самого застосунку. Саме тому модалка не покладається лише на редирект: вона лишає кнопку, видимий URL і ручний сценарій.
Ця модалка зберігає інстал навіть у жорстких webview, де звичайний автоматичний редирект просто зупиняється. У багатьох PWA-рішеннях користувач залишається всередині Facebook або Instagram без зрозумілого наступного кроку; darkcore одразу дає робочий fallback для Android та iOS.
PWA-маніфест
Пише manifest.json, який роздає traffic-engine.
| Поле | Тип | За що відповідає | Ліміт |
|---|---|---|---|
| Коротка назва | текст | Назва під іконкою, коли повна не влазить | до 12 символів |
| Колір теми | перемикач «За темою пристрою» + hex | Колір панелі браузера / перемикача задач | #RRGGBB |
| Колір тла | hex | Фон екрана заставки | #RRGGBB |
| Опис | textarea | description у маніфесті | до 300 символів |
За замовчуванням колір теми — «За темою пристрою» (авто, слідує світлій/темній темі). Вимкніть, щоб задати свої кольори.
Зовнішній вигляд
| Поле | Тип | За що відповідає | Дефолт |
|---|---|---|---|
| Колір дій | hex | Єдиний CTA-колір, який успадковують усі кнопки модалок (push, webview, install) | #1a73e8 |
| Тема | select | Світла / Темна / Авто — тема сторінки PWA | Авто |
Кнопка «Встановити» завжди лишається у стилі Play Market — «Колір дій» на неї не впливає.
Схожі додатки
Вкладка Схожі дозволяє звʼязати інші PWA цього воркспейсу — вони показуються у блоці «Схожі додатки» на інсталяційній сторінці. Пошук + додавання/видалення зі списку; поточний застосунок сам себе виключає.