Plataforma de apps

PushEngage para React Native

Adicione notificações push e mensagens in-app a uma aplicação React Native no Android e iOS com o SDK PushEngage React Native. Um pacote npm com suporte TypeScript e JavaScript abrange ambas as plataformas, e as campanhas são executadas a partir do painel PushEngage.

O que pode fazer com React Native

Um pacote para Android e iOS

Uma única API JavaScript assenta sobre código nativo Swift e Kotlin, entregando através do Firebase Cloud Messaging no Android e do serviço Apple Push Notification no iOS.

Deep links e toques em cold-start

Um listener recebe o deep link e os dados da notificação quando uma notificação é tocada, e uma chamada separada retorna a notificação que iniciou a aplicação.

Permissão e subscrição numa única chamada

Solicitar permissão de notificação também subscreve o utilizador quando ele a permite, pelo que não há um passo de subscrição separado.

Segmentos, atributos e campanhas acionadas

Adicione subscritores a segmentos estáticos ou dinâmicos, defina atributos personalizados e envie eventos de gatilho, metas e alertas de queda de preço ou de inventário a partir de JavaScript.

Mensagens na aplicação

Mostre banners, modais e mensagens a ecrã inteiro desenhadas no painel. Não é necessária configuração no lado JavaScript depois de o SDK ter o seu App ID.

Fluxo de trabalho bare e builds de desenvolvimento Expo

Projetos React Native bare são totalmente suportados. Projetos Expo funcionam através de um build de desenvolvimento, abordado na página Expo deste diretório.

Como configurar

  1. Instale @pushengage/pushengage-react-native com npm ou yarn.
  2. Para Android, configure o Firebase Cloud Messaging e insira o seu Sender ID e Service Account JSON no PushEngage em Site Settings > Installation > Android SDK.
  3. Para iOS, adicione Push Notifications e Background Modes no Xcode, e carregue o seu certificado APNs no separador iOS SDK no PushEngage.
  4. Adicionar uma Extensão de Serviço de Notificação ao projeto iOS. Uma Extensão de Conteúdo de Notificação é opcional.
  5. Adicione a capacidade App Groups ao target principal da aplicação e à extensão.
  6. Inicialize o SDK com o seu App ID no índice root.js antes de a aplicação ser registada, e adicione as linhas PushEngage a AppDelegate.mm para iOS.
  7. Execute num dispositivo físico e envie um teste de Campaign > Push Broadcasts.

Guia completo: quickstart do React Native

Bom saber

  • Push para aplicações e este SDK estão listados em todos os planos PushEngage, incluindo o plano gratuito. O rastreamento de objetivos, campanhas acionadas personalizadas e mensagens in-app necessitam de um plano pago.
  • O SDK atual necessita de React Native 0.78 ou posterior com a Nova Arquitetura (Turbo Modules). A documentação aponta versões mais antigas do React Native para uma versão anterior do SDK.
  • Android necessita de um projeto Firebase, e iOS necessita de uma conta de Desenvolvedor Apple com um ID de Aplicação e um certificado APNs.
  • O SDK inclui código nativo, pelo que não funciona no Expo Go. Use um projeto bare ou um build de desenvolvimento Expo.
  • A configuração nativa ainda é necessária em ambos os lados: Gradle e Firebase para Android, capacidades Xcode e uma Extensão de Serviço de Notificação para iOS.
  • Se o build iOS falhar em @import com módulos C++ desativados, adicione -fcxx-modules a Other C++ Flags no Xcode.

Sobre esta ligação

  • PushEngage constrói e mantém este SDK. Não é uma parceria com a Meta ou o projeto React Native.
  • O código fonte está público no GitHub no repositório awesomemotive/pushengage-react-native sob a licença MIT.
  • O pacote é publicado no npm sob o âmbito @pushengage.
  • A PushEngage também publica Agent Skills de código aberto, para que um agente de codificação de IA como Claude Code ou Cursor possa executar a integração e diagnosticar uma configuração com falha.

Diretório de Parceiros PushEngage

Pronto para adicionar notificações push à sua aplicação React Native? Comece com o guia de configuração.

A PushEngage tem um plano gratuito, pelo que pode instalá-la e enviar a sua primeira campanha antes de pagar nada.