Aviso: Não existe documentação legada disponível para este item, pelo que está a ver a documentação atual.
Pode mover os seus subscritores de push de aplicações iOS e Android de OneSignal para PushEngage reutilizando as mesmas credenciais Apple e Firebase que a sua aplicação já utiliza. Como os tokens de dispositivo são emitidos pela Apple e Google em vez de pela OneSignal, manter essas credenciais permite que os seus tokens continuem a funcionar após a mudança. Este guia explica como funciona a migração e os passos para a configurar. A migração é um processo de backend gerido em conjunto com a nossa equipa.
Antes de Começar
- Crie uma conta com PushEngage.
- Tenha as suas credenciais de push Apple prontas, especificamente o seu ID de Push de Aplicação e o certificado p12 da sua conta de Desenvolvedor Apple, os mesmos utilizados na OneSignal.
- Tenha o ID do Remetente Firebase Android, o mesmo utilizado na OneSignal.
- Tenha acesso à sua conta OneSignal para exportar dados de subscritores.
Como Funciona a Migração de Aplicações
Os tokens de dispositivo para push de aplicações vêm do serviço de Notificação Push da Apple (APNs) e do Firebase Cloud Messaging (FCM), não da OneSignal. Se configurar o PushEngage com as mesmas credenciais APNs e FCM, os seus tokens permanecem válidos e a migração ocorre no backend. A permissão de notificação também é transferida, pelo que um utilizador que já concedeu permissão não precisa de a conceder novamente.
Passos para Migrar
Passo 1: Exporte os seus subscritores da OneSignal
Exporte os seus dados de subscritores utilizando um dos métodos:
- Exportação via API, utilizando o seu ID de Aplicação OneSignal e Chave API da Aplicação.
- Exportação CSV, com um ficheiro que inclua
identifier,device_type,languagee quaisquer outros campos relevantes.
Passo 2: Configurar o FCM para Android no PushEngage
- Inicie sessão no painel do PushEngage.
- Vá a Definições » Instalação » SDK para Android.
- Configure as definições FCM do Android Google utilizando o mesmo ID do Remetente Firebase que utilizou na OneSignal.
Passo 3: Configurar o APNs para iOS no PushEngage
- Vá a Definições » Instalação » SDK iOS.
- Configure as definições APNs do iOS Apple utilizando o mesmo ID de Push de Aplicação da sua configuração OneSignal.
- Carregue o certificado p12 da sua conta de Desenvolvedor Apple, o mesmo que utilizou na OneSignal.
Notas Importantes sobre a Transição da Versão da Aplicação
A migração de notificações push de aplicações depende da versão da sua aplicação que um subscritor está a utilizar, por isso planeie cuidadosamente a sua transição de lançamento.
- Versões de aplicação mais antigas com o SDK OneSignal. Após a migração, os subscritores que ainda utilizam versões de aplicação mais antigas não receberão notificações enviadas do PushEngage, porque o payload do PushEngage não pode ser decodificado pelo SDK OneSignal.
- Novas versões de aplicação com o SDK PushEngage. Se enviar a partir do painel OneSignal após a migração, essas notificações não aparecerão nas novas versões da aplicação, porque o payload OneSignal não pode ser decodificado pelo SDK PushEngage.
Envie a partir do PushEngage para utilizadores na nova versão da aplicação e espere que os utilizadores que não atualizaram migrem à medida que atualizam a aplicação.
Perguntas Frequentes
Os utilizadores da minha aplicação têm de conceder novamente permissão para notificações?
Não. Se a permissão já foi concedida na sua aplicação, esta é transferida e não precisa de ser concedida novamente após a migração.
Todos os subscritores receberão notificações logo após a migração?
Os utilizadores na nova versão da aplicação com o SDK PushEngage receberão. Os utilizadores que ainda se encontram numa versão mais antiga da aplicação com o SDK OneSignal não receberão notificações PushEngage até atualizarem a aplicação.
Por que reutilizo as mesmas credenciais APNs e Firebase?
Porque os tokens de dispositivo estão associados a essas credenciais. Reutilizar o mesmo ID Push da App, certificado p12 e ID do Remetente Firebase mantém os seus tokens existentes válidos, o que possibilita a migração sem pedir aos utilizadores que se registem novamente.
Que dados preciso de exportar do OneSignal?
Ou uma exportação de API usando o seu ID da App OneSignal e Chave de API da App, ou um CSV que inclua pelo menos identifier, device_type e language, mais quaisquer outros campos relevantes.
Se encontrar algum problema, n0o hesite em contactar-nos clicando aqui. A nossa equipa de suporte poder0 ajud0-lo.
