Быстрый старт

От нового аккаунта до первой рассылки уведомлений для Android.

1. Создайте проект

Создайте аккаунт или войдите. При регистрации создаётся первая организация. Выберите её в панели и создайте проект.

2. Подключите Firebase и создайте клиентский ключ

Откройте раздел подключения проекта и выберите Android / Firebase. Добавьте JSON сервисного аккаунта Firebase и убедитесь, что учётные данные FCM активны. Храните этот JSON на сервере, а не в игре.

Создайте ключ SDK / Client в разделе «Ключи API». Для регистрации нужен devices:write, для передачи открытий и нажатий — events:write. Скопируйте полный ключ: он показывается один раз.

Инструкция по FCM · Ключи API

3. Зарегистрируйте устройство

Добавьте вызов регистрации SDK в приложение или игру. Получите актуальный токен FCM из Android-плагина уведомлений. Используйте постоянный anonymousId, чтобы повторные запуски обновляли то же устройство.

curl -X POST "https://api.push-dk.ru/api/v1/projects/PROJECT_ID/devices" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SDK_KEY" \
  -d '{"anonymousId":"player-123","platform":"ANDROID","pushToken":{"provider":"FCM","token":"FCM_TOKEN"}}'

Запустите собранное приложение, разрешите уведомления при запросе и проверьте раздел «Устройства» проекта. Сохраните полученный ID устройства для событий активности и уведомлений.

4. Проверьте и отправьте

Откройте «Тестовое уведомление», выберите зарегистрированное устройство и отправьте одно уведомление. Подтверждение провайдера не означает, что устройство его показало — проверьте на устройстве.

Создайте кампанию, напишите сообщение, выберите все подписанные устройства или сегмент, затем отправьте сейчас или задайте расписание. После отправки проверьте аналитику кампании.

Для Android-сборок Construct 3 с OneSignal скопируйте пример из раздела «Настройка SDK» проекта и добавьте его в существующий основной скрипт.

← Документация REST API →