Как отправить тестовое push-уведомление в RuStore
В консоли разработчика RuStore доступен специальный механизм отправки тестовых push-уведомлений. Он позволяет проверить, корректно ли настроено приложение и бэкенд для приема уведомлений, без необходимости развертывать полный боевой цикл рассылки.
Ниже описана пошаговая инструкция: как создать проект для push в консоли, получить push-токен на устройстве и отправить тестовое уведомление.
Общая схема работы push-уведомлений в RuStore
-
Серверная часть RuStore
Принимает запрос на отправку push-уведомления от бэкенда разработчика (или из консоли разработчика) и перенаправляет его на устройство. Для этого используется push-токен. -
Push-токен
Это уникальный идентификатор устройства и установленного приложения, по которому RuStore определяет, куда доставлять уведомление. -
Приложение RuStore
На устройстве должна быть установлена актуальная версия. -
Мобильное приложение разработчика
Содержит интегрированный SDK, который умеет принимать и обрабатывать входящие push-уведомления, поступающие через RuStore.
Создание проекта для push в консоли
Чтобы пользоваться push-уведомлениями, в RuStore консоли необходимо создать проект:
- Зайдите в консоль разработчика RuStore под вашей учетной записью.
- Перейдите в раздел Инструменты → push-уведомления → Проекты.
- Нажмите Создать проект и заполните поля:
- Название проекта: любое удобное имя (например,
PushProjectTest
); - Package name: укажите пакет приложения (например,
com.example.app
). Обычно это должен быть тот же package name, который реально используется в вашем Android-приложении; - Отпечаток подписи SHA-256.
- Сохраните изменения. После сохранения система сгенерирует:
- ID проекта — уникальный идентификатор, который понадобится при отправке уведомлений.
- Сервисный токен (S2S-токен) — ключ авторизации, с помощью которого вы подтверждаете право отправлять уведомления для данного проекта.
В одном проекте вы можете создавать до пяти сервисных токенов.
Не забудьте отметить «звездочкой» (*
) тот токен, который хотите использовать по умолчанию для тестовых отправок.
Получение push-токена на устройстве
Чтобы тестовое уведомление дошло до нужного устройства, необходимо знать его push-токен (уникальный идентификатор в системе RuStore).
- Установите тестовую (или реальную) сборку вашего Android-приложения, в которую уже интегрирована SDK RuStore для push-уведомлений.
- После интеграции RuStore Push SDK в ваше приложение, необходимо вызвать метод:
RuStorePushClient.getToken()
Отправка тестового push-уведомления из консоли
Переход в раздел тестовых уведомлений
- Откройте в консоли разработчика RuStore нужный проект в разделе push-уведомления → Проекты.
- Выберите проект, для которого хотите сделать тестовую отправку.
- Во вкладке Тестовые уведомления отображаются поля для ввода push-токена и текста уведомления.
Заполнение полей
-
Заголовок push
Обязательное поле. -
Сервисный токен
Автоматически подставится тот, который помечен звездочкой. Если нужно, выберите другой токен, соответствующий проекту. -
push-токен
Вставьте строку, которую вы скопировали с тестового устройства. -
Текст уведомления
Введите любую проверочную фразу, например: Test push.
Отправка и проверка результата
- Нажмите кнопку Отправить.
- Дождитесь уведомления в консоли об успешной отправке.
- Откройте тестовое устройство:
- Убедитесь, что система показала push-уведо мление (например, в шторке уведомлений Android).
- Если приложение запущено и обрабатывает уведомление, проверьте логи приложения или соответствующий UI.
Частые ошибки и их причины
Not Found / entity was not found
- Указывает, что введенный push-токен не найден в системе (например, токен устарел или скопирован неверно).
- Решение: перепроверьте токен (получите его заново и подставьте в поле).
Permission Denied / недопустимый сервисный токен
- Сервисный токен (S2S-токен) не соответствует указан ному проекту или введён неверно.
- Решение: проверьте, что берёте сервисный токен именно из этого проекта, и он активен (отмечен звездочкой).
Что-то пошло не так
- Может означать любую нестандартную ошибку.
- Решение: проверьте Network-трафик (через инструменты разработчика в браузере) или повторите запрос. Убедитесь, что проект не удалён, а токены корректны.
Не приходит push-уведомление
- Проверьте, что RuStore установлен, запущен, и системе разрешена работа RuStore в фоновом режиме.
- Убедитесь, что уведомления разрешены в настройках устройства.
При возникновении вопросов или сложностей обращайтесь в службу поддержки RuStore.