Aviso: Não há documentação legada disponível para este item, portanto, você está vendo a documentação atual.
Você pode mover seus assinantes de push de aplicativos iOS e Android de OneSignal para PushEngage reutilizando as mesmas credenciais Apple e Firebase que seu aplicativo já usa. Como os tokens de dispositivo são emitidos pela Apple e Google, e não pela OneSignal, manter essas credenciais permite que seus tokens continuem funcionando após a troca. Este guia explica como a migração funciona e as etapas para configurá-la. A migração é um processo de backend tratado em conjunto com nossa equipe.
Antes de Começar
- Crie uma conta com PushEngage.
- Tenha suas credenciais de push da Apple prontas, especificamente seu ID de Push de Aplicativo e o certificado p12 de sua conta de Desenvolvedor Apple, os mesmos usados no OneSignal.
- Tenha seu ID do Remetente do Firebase para Android, o mesmo usado no OneSignal.
- Tenha acesso à sua conta OneSignal para exportar dados de assinantes.
Como Funciona a Migração de Aplicativos
Os tokens de dispositivo para push de aplicativos vêm do serviço de Notificação Push da Apple (APNs) e do Firebase Cloud Messaging (FCM), não do OneSignal. Se você configurar o PushEngage com as mesmas credenciais APNs e FCM, seus tokens permanecerão válidos e a migração ocorrerá no backend. A permissão de notificação também é transferida, portanto, um usuário que já concedeu permissão não precisa concedê-la novamente.
Passos para Migrar
Etapa 1: Exporte seus assinantes do OneSignal
Exporte seus dados de assinante usando um dos métodos:
- Exportação via API, usando seu ID de Aplicativo OneSignal e Chave de API do Aplicativo.
- Exportação CSV, com um arquivo que inclui
identificador,tipo_dispositivo,idiomae quaisquer outros campos relevantes.
Etapa 2: Configure o FCM do Android no PushEngage
- Faça login no painel do PushEngage.
- Vá para Configurações » Instalação » SDK Android.
- Configure as configurações do FCM do Google Android usando o mesmo ID do Remetente do Firebase que você usou no OneSignal.
Etapa 3: Configure o APNs do iOS no PushEngage
- Vá para Configurações » Instalação » SDK iOS.
- Configure as configurações do APNs do Apple iOS usando o mesmo ID de Push de Aplicativo da sua configuração do OneSignal.
- Faça o upload do certificado p12 de sua conta de Desenvolvedor Apple, o mesmo que você usou no OneSignal.
[Captura de tela: a configuração do SDK Android e do SDK iOS em Configurações » Instalação.]
Observações Importantes sobre a Transição da Versão do Aplicativo
A migração de push de aplicativos depende da versão do seu aplicativo que um assinante está executando, portanto, planeje cuidadosamente a transição de lançamento.
- Versões mais antigas do aplicativo com o SDK OneSignal. Após a migração, os assinantes que ainda estiverem em versões antigas do aplicativo não receberão notificações enviadas do PushEngage, pois o payload do PushEngage não pode ser decodificado pelo SDK OneSignal.
- Novas versões do aplicativo com o SDK PushEngage. Se você enviar do painel OneSignal após a migração, essas notificações não aparecerão nas novas versões do aplicativo, pois o payload do OneSignal não pode ser decodificado pelo SDK PushEngage.
Envie do PushEngage para usuários na nova versão do aplicativo e espere que os usuários que não atualizaram sejam migrados à medida que atualizam o aplicativo.
Perguntas Frequentes
Meus usuários de aplicativo precisam conceder permissão de notificação novamente?
Não. Se a permissão já foi concedida em seu aplicativo, ela é transferida e não precisa ser concedida novamente após a migração.
Todo assinante receberá notificações logo após a migração?
Usuários na nova versão do aplicativo com o SDK do PushEngage receberão. Usuários ainda em uma versão mais antiga do aplicativo com o SDK do OneSignal não receberão notificações do PushEngage até que atualizem o aplicativo.
Por que reutilizo as mesmas credenciais APNs e Firebase?
Porque os tokens de dispositivo estão vinculados a essas credenciais. Reutilizar o mesmo ID de Push do aplicativo, certificado p12 e ID do remetente do Firebase mantém seus tokens existentes válidos, o que possibilita a migração sem pedir aos usuários que se registrem novamente.
Quais dados preciso exportar do OneSignal?
Ou uma exportação de API usando seu ID de aplicativo OneSignal e chave de API do aplicativo, ou um CSV que inclua pelo menos identifier, device_type e language, além de quaisquer outros campos relevantes.
Se você encontrar algum problema, sinta-se à vontade para entrar em contato conosco clicando aqui. Nossa equipe de suporte poderá ajudá-lo.
