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