Платформа приложений

PushEngage для React Native

Добавьте push-уведомления и внутриприложечные сообщения в приложение React Native на Android и iOS с помощью PushEngage React Native SDK. Один npm-пакет с поддержкой TypeScript и JavaScript охватывает обе платформы, а кампании запускаются из панели управления PushEngage.

Что можно делать с React Native

Один пакет для Android и iOS

Единый JavaScript API работает поверх нативного кода Swift и Kotlin, доставляя уведомления через Firebase Cloud Messaging на Android и Apple Push Notification service на iOS.

Глубокие ссылки и нажатия при холодном запуске

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

Разрешение и подписка одним вызовом

Запрос разрешения на уведомления также подписывает пользователя, когда он его предоставляет, поэтому отдельного шага подписки нет.

Сегменты, атрибуты и триггерные кампании

Добавляйте подписчиков в статические или динамические сегменты, устанавливайте пользовательские атрибуты и отправляйте триггерные события, цели и оповещения о снижении цен или наличии товаров из JavaScript.

Внутриприложенийные сообщения

Отображайте баннеры, модальные окна и полноэкранные сообщения, разработанные в панели управления. Настройка на стороне JavaScript не требуется после того, как SDK получит ваш App ID.

Bare workflow и сборки для разработки Expo

Полностью поддерживаются проекты Bare React Native. Проекты Expo работают через сборку для разработки, описанную на странице Expo в этом каталоге.

Как настроить

  1. Установите @pushengage/pushengage-react-native с помощью npm или yarn.
  2. Для Android настройте Firebase Cloud Messaging и введите ваш Sender ID и JSON Service Account в PushEngage в разделе Site Settings > Installation > Android SDK.
  3. Для iOS добавьте Push Notifications и Background Modes в Xcode и загрузите ваш APNs-сертификат во вкладке iOS SDK в PushEngage.
  4. Добавьте Notification Service Extension в проект iOS. Notification Content Extension является необязательным.
  5. Добавьте возможность App Groups к основной целевой группе приложения и расширению.
  6. Инициализируйте SDK с вашим App ID в корневом файле index.js перед регистрацией приложения и добавьте строки PushEngage в AppDelegate.mm для iOS.
  7. Запустите на физическом устройстве и отправьте тест из Campaign > Push Broadcasts.

Полное руководство: Быстрая настройка React Native

Хорошо знать

  • App push и этот SDK включены во все тарифы PushEngage, включая бесплатный. Отслеживание целей, пользовательские триггерные кампании и внутриприложечные сообщения требуют платного тарифа.
  • Текущий SDK требует React Native 0.78 или новее с New Architecture (Turbo Modules). В документации для более старых версий React Native указан предыдущий выпуск SDK.
  • Для Android нужен проект Firebase, а для iOS — учетная запись разработчика Apple с идентификатором приложения и сертификатом APNs.
  • SDK включает нативный код, поэтому он не работает в Expo Go. Используйте чистый проект или сборку для разработки Expo.
  • Нативная настройка по-прежнему требуется с обеих сторон: Gradle и Firebase для Android, возможности Xcode и расширение службы уведомлений для iOS.
  • Если сборка iOS завершается ошибкой при @import с отключенными модулями C++, добавьте -fcxx-modules в Other C++ Flags в Xcode.

Об этом подключении

  • PushEngage создает и поддерживает этот SDK. Это не партнерство с Meta или проектом React Native.
  • Исходный код находится в открытом доступе на GitHub в репозитории awesomemotive/pushengage-react-native под лицензией MIT.
  • Пакет опубликован на npm под областью видимости @pushengage.
  • PushEngage также публикует Agent Skills с открытым исходным кодом, поэтому ИИ-агент для кодирования, такой как Claude Code или Cursor, может выполнить интеграцию и диагностировать неисправную настройку.

Каталог партнеров PushEngage

Готовы добавить push-уведомления в ваше приложение React Native? Начните с руководства по настройке.

У PushEngage есть бесплатный тариф, поэтому вы можете установить его и отправить свою первую кампанию до того, как заплатите.