Частые вопросы (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... добавьте приложения и укажите каждому Weight.
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ă. Выберите нужный - интерфейс переключится сразу.

Выбранные язык и тема запоминаются и сохраняются при следующем входе.