Часті запитання (FAQ)

Короткі відповіді на найпопулярніші запитання щодо роботи в PWA Hub. Тут зібрано те, що найчастіше потрібно в повсякденних задачах: як створити та запустити PWA, прив'язати домен, налаштувати спліт, завантажити лендінг, де дивитися статистику та що робити в нестандартних ситуаціях.

У бічному меню вам доступні розділи Dashboard, PWA, Splits та Landing pages - майже всі відповіді нижче стосуються саме їх.

Панель не відкривається за доменом? Перевірте DNS-запис у Cloudflare

Це найчастіша причина «немає доступу до адмінки». Після активації ліцензії панель працює лише на домені, який ви вказали на екрані ліцензії (наприклад, admin.<ваш-домен>), через Cloudflare. Якщо адреса взагалі не завантажується - майже напевно не створено DNS-запис цього хоста, і він просто не резолвиться.

Що перевірити в Cloudflare (ваш домен → DNS → Records):

1. Є запис: тип A, ім'я - хост панелі (наприклад, admin), значення - IP вашого сервера.
2. Проксіювання увімкнено - помаранчева хмара (Proxied).
3. Запису немає - додайте його кнопкою Add record і зачекайте хвилину, доки застосується.

За IP після активації - 403

До активації ліцензії панель відкривається за IP сервера, після - лише за доменом; захід за IP відповідає 403, і це не помилка. Покроково - у розділах «Встановлення» та «Домени і Cloudflare».

Як створити нове PWA?

Відкрийте розділ PWA у бічному меню та натисніть кнопку Add у шапці списку - відкриється форма створення застосунку.

Почніть із вкладки General. Мінімум, який потрібно заповнити:

• Name - назва застосунку (за нею ви будете знаходити його в списку).
• iOS template та Android template - зовнішній вигляд вітрини для кожної платформи: Native Store для iOS, Native Store Green або Web Store для Android.
• Cloudflare та Filter Account - службові акаунти, які вже підготовлені для вас. Просто виберіть потрібний із випадного списку; зазвичай основний акаунт підставляється автоматично.
• Landing page type - що показувати «випадковим» відвідувачам (біла/безпечна сторінка). Докладніше - у питанні про білу сторінку нижче.

Решта вкладок (Domains, Description та інші) відповідають за вміст і адреси застосунку. Коли все готово, натисніть Create - застосунок з'явиться в списку. Далі його можна запустити та прив'язати до нього домени.

TIP

Не обов'язково заповнювати все одразу. Створіть PWA з базовими налаштуваннями, а домени, опис і лендінг додайте пізніше - форма завжди відкривається на редагування через меню рядка.

Як запустити або зупинити PWA?

Є два способи, обидва - з розділу PWA:

• Клік по статусу. У стовпці Status мітка клікабельна. У запущеного застосунку при наведенні показується підказка Deactivate PWA - натискання зупиняє його. У зупиненого - підказка Activate PWA, натискання запускає.
• Через меню рядка. Натисніть кнопку з трьома крапками у стовпці Actions та виберіть Start або Stop (пункт залежить від поточного стану).

Статус змінюється одразу. Якщо операцію не вдалося виконати, стан повернеться до попереднього.

Що означає «зупинено»

Зупинене PWA не приймає трафік - відвідувачі на його домени не потрапляють на застосунок. Запустіть його, коли будете готові приймати встановлення.

Як клонувати PWA?

Клонування створює копію застосунку з усіма налаштуваннями - зручно, щоб не збирати схоже PWA з нуля.

1. У розділі PWA натисніть кнопку з трьома крапками у стовпці Actions та виберіть Clone.
2. У діалозі Clone, що відкриється, вкажіть імена майбутніх копій. Перше поле вже заповнене іменем вихідного застосунку з додаванням Clone.
3. Кнопкою з іконкою + можна додати ще поля та створити одразу кілька копій за один раз. Порожні поля пропускаються.
4. Натисніть Yes - копії з'являться в списку.

Як заархівувати PWA та де потім його знайти?

Щоб прибрати застосунок з основного списку, відкрийте меню рядка (три крапки) та виберіть Archive. З'явиться запит на підтвердження «Ви впевнені, що хочете заархівувати це PWA ?» - натисніть Yes.

Архівування не видаляє застосунок назавжди. Щоб знову побачити архівні PWA, увімкніть фільтр Archived у шапці списку (на мобільному він захований за кнопкою з іконкою фільтра).

WARNING

Поки застосунок в архіві, він не показується у звичайному списку. Якщо не можете знайти потрібне PWA - перевірте, чи не увімкнено фільтр Archived, і чи не заархівоване воно.

Як додати домен до PWA?

Домени прив'язуються до застосунку на вкладці Domains у формі PWA.

1. Натисніть Add new Domain - відкриється діалог New PWA Domain.
2. У полі Type of domain виберіть:
   • System - готовий домен із тих, що вже доступні вам. Нічого додатково налаштовувати не потрібно.
   • My domain - ваш власний домен.
   • Buy new - купити домен через Namecheap прямо з панелі: вона перевірить, чи вільна адреса, покаже ціну та оформить покупку. Потрібен підключений акаунт Namecheap.
3. Subdomain - необов'язкова приставка перед доменом (наприклад, app).
4. У полі Domain виберіть конкретну адресу зі списку - вона фільтрується за вибраним типом.
5. Натисніть Save.

Прив'язані домени показані в таблиці; поряд із кожним є кнопка переходу - вона відкриває адресу в новій вкладці браузера. У списку PWA домени також видно у стовпці Domains, де їх можна швидко скопіювати кнопкою Copy.

У чому різниця

Системний домен - найшвидший варіант: він уже готовий до роботи. Свій домен підійде, якщо потрібна адреса у вас уже є; Buy new - якщо її хочеться зареєструвати просто зараз через Namecheap. Докладніше про покупку - у розділі «Акаунти Namecheap».

Що таке «Landing page type» (біла сторінка) у формі PWA?

На вкладці General поле Landing page type задає, що побачать відвідувачі, яким не потрібно показувати основний застосунок (так звана біла, або безпечна, сторінка). Варіанти:

• Landing page redirect URL - перенаправляти на зовнішню адресу. Після вибору з'явиться поле Landing page URL, куди потрібно вписати коректне посилання.
• Load Landing page - показати один із ваших лендінгів, завантажених у розділі Landing pages. Після вибору з'явиться поле для вибору потрібного лендінгу.
• Off Landing page - не використовувати білу сторінку.
• Blank page - показувати порожню заглушку.

Що таке спліт і як між PWA розподіляється трафік?

Split - це розподільник трафіку. Він приймає відвідувачів на свої домени та розкидає їх між кількома вашими PWA. Кожна зв'язка «спліт → PWA» називається потоком, а частка трафіку потоку задається числом - вагою.

Вага - це пропорція, а не відсотки. Що більша вага потоку відносно інших, то більше відвідувачів потрапить на цей застосунок.

Робота зі сплітами - у розділі Splits:

1. Натисніть Add, задайте Name та натисніть Create.
2. У картці Domain прив'яжіть адреси, на які надходитиме трафік (так само, як домени до PWA: System або My domain).
3. У картці Flows через поле Search PWA... додайте застосунки та вкажіть кожному Вагу.
4. Натисніть Save та запустіть спліт кнопкою Start.

Приклад розподілу

Два PWA з вагами 1 і 1 отримають трафік порівну. Ваги 3 і 1 дадуть приблизно 75% першому застосунку і 25% другому. Змінені ваги зберігаються кнопкою Save у шапці форми.

Спочатку збережіть спліт

Картки Domain і Flows стають доступними лише після збереження спліта. Поки спліт не збережено, у них показана підказка «Спочатку збережіть спліт, щоб додати потоки та домени».

Як завантажити свій лендінг?

Лендінги зберігаються в розділі Landing pages та потім підключаються до PWA як біла сторінка (варіант Load Landing page у полі Landing page type).

1. Відкрийте розділ Landing pages та натисніть Add.
2. Вкажіть Name лендінгу.
3. Завантажте ZIP-архів. Підказка в діалозі нагадує: «Завантажте ZIP-архів, що містить файли з розширеннями .php, .html, .css, .js».
4. Натисніть Save.

Щоб відкрити завантажений лендінг, викличте меню рядка (три крапки) та виберіть Open - він відкриється в новій вкладці.

Розмір архіву

Максимальний розмір ZIP-архіву - 20 МБ. Переконайтеся, що всередині лежать саме файли лендінгу, а не зайва вкладена папка.

Як надіслати пуш-сповіщення тим, хто встановив застосунок?

Спочатку дозвольте застосунку збирати підписки, потім створіть пуш:

1. Відкрийте PWA, вкладка Settings → увімкніть Collect subscriptions і збережіть. Підписки почнуть збиратися в усіх, хто встановить застосунок і дозволить сповіщення.
2. Перейдіть до розділу Pushes і натисніть Add.
3. На вкладці General вкажіть назву, команду, мову за замовчуванням і тип: Manual (лише за кнопкою), Scheduled (за розкладом) або Triggered (через N після встановлення, реєстрації чи депозиту).
4. На вкладці Messages додайте мову та напишіть Title і Text; Preview праворуч одразу покаже, який вигляд матиме повідомлення.
5. Натисніть Create, за потреби налаштуйте Schedule і Filter - та запустіть пуш кнопкою Start (ручну надсилайте кнопкою Send now).

Подробиці - у розділі «Пуш-сповіщення».

Сповіщення питають один раз

Системний запит браузера показується одноразово, і відмова остаточна. Перемикач Ask in-app first на вкладці Settings показує спочатку власний екран - так єдина спроба не витрачається на тих, хто поки не готовий.

Де дивитися статистику щодо візитів і встановлень?

Уся зведена статистика зібрана на Dashboard (перший пункт меню, стартовий екран після входу). Там ви знайдете:

• картки Visits, Installs і Conversion (середня конверсія) за вибраний період;
• графік Traffic Overview та воронку Visits → Installs;
• віджет PWA Applications - візити, встановлення та статус по кожному застосунку (з фільтром All / Running / Stopped);
• Top GEOs - країни з найбільшою кількістю встановлень.

Воронка за кроками, розбивка по днях, сплітах і саб-мітках - на сторінці Statistics (див. розділ «Статистика»).

Період задається у верхній частині екрана: Today, Yesterday, Last 7 days, Last 30 days, This month, Last month або Custom range.

TIP

Швидку воронку по кожному застосунку видно й прямо у списках - у колонці Stats розділів PWA та Splits.

Що робити, якщо з'явилося повідомлення License Expired?

Якщо ви бачите екран License Expired з текстом «No active license. Contact your administrator.» - це означає, що ліцензія на систему більше не діє.

Продовження ліцензії виконується на боці адміністратора, тому зі свого боку робити нічого не потрібно - просто зв'яжіться з адміністратором. Щойно ліцензію продовжать, доступ відновиться, і ви зможете продовжити роботу.

Чому не вдається додати користувача або домен?

Річ у лімітах плану: ліцензія обмежує максимальну кількість користувачів і доменів. Коли ліміт досягнуто, під час додавання ви побачите помилку виду Limit reached - зверніться до адміністратора, щоб розширити план. Докладніше про ліміти - у розділі «Ліцензія».

Як отримати API-ключ?

API-ключ потрібен, щоб звертатися до публічного API системи зі своїх інтеграцій. Він живе в розділі Profile (меню в правому верхньому куті → Profile), у картці API Key:

1. Натисніть Generate Key - система створить ключ і одразу покаже його.
2. Далі ключ можна показати, скопіювати, перевипустити (Regenerate) або видалити.

Докладніше про ключ і про те, як безпечно його зберігати, - у розділі «Профіль».

Якщо картки немає

Картка API Key видима лише адміністраторам і тим, кому увімкнено доступ до API. Якщо її немає, доступ до API для вашого акаунта поки не увімкнено - зверніться до адміністратора.

Як вимкнути спливні сповіщення?

Спливні повідомлення (тости) вимикаються перемикачем Silent notifications у розділі Profile (меню в правому верхньому куті → Profile, картка Notifications). Після цього нові події накопичуються лише в дзвіночку на верхній панелі. Докладніше - у розділах «Профіль» і «Сповіщення».

Як змінити мову інтерфейсу або тему?

І мова, і тема перемикаються у верхній панелі справа:

• Тема. Кнопка з іконкою місяця або сонця перемикає світлу та темну тему (підказки Dark mode / Light mode).
• Мова. Кнопка з кодом поточної мови (наприклад, RU) відкриває список: English, Polski, Українська, Русский, Română. Виберіть потрібну - інтерфейс перемкнеться одразу.

Вибрані мова та тема запам'ятовуються та зберігаються при наступному вході.