Aviso: Não existe documentação legada disponível para este item, pelo que está a ver a documentação atual.
Pode trazer os seus subscritores existentes de notificações push de aplicações iOS e Android para o 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 do seu fornecedor de notificações push, 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 a sua conta PushEngage.
- Tenha acesso às suas credenciais de notificações push da Apple, especificamente ao seu ID de Notificações Push da Aplicação e ao certificado p12 da sua conta de Desenvolvedor Apple.
- Tenha acesso às suas definições do Firebase para Android, especificamente ao seu ID de Remetente do Firebase.
- Tenha uma forma de exportar os seus dados de subscritores do seu fornecedor atual.
Como Funciona a Migração de Aplicações Móveis
Os tokens de dispositivo para notificações push de aplicações vêm do serviço de Notificações Push da Apple (APNs) e do Firebase Cloud Messaging (FCM), não do seu fornecedor atual. Se configurar o PushEngage com as mesmas credenciais APNs e FCM que já utiliza, esses tokens permanecem válidos e a migração ocorre no backend.
A permissão de notificação também é transferida. Se um utilizador já concedeu permissão de notificação na sua aplicação, não precisará de a conceder novamente após a migração.
Passos para Migrar
Passo 1: Exportar os seus subscritores do seu fornecedor atual
Exporte os seus dados de subscritores utilizando qualquer um dos métodos que o seu fornecedor oferece:
- Exportação via API, utilizando o ID da aplicação e a chave API do seu fornecedor atual.
- 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 do Google FCM para Android utilizando o mesmo ID de Remetente do Firebase que já utiliza.
Passo 3: Configurar o APNs para iOS no PushEngage
- No painel do PushEngage, vá a Definições » Instalação » SDK para iOS.
- Configure as definições do APNs para iOS da Apple utilizando o mesmo ID de Notificações Push da Aplicação da sua configuração atual.
- Carregue o certificado p12 da sua conta de Desenvolvedor Apple, o mesmo que já utiliza.

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 mais antigas da aplicação com o SDK do fornecedor anterior. Após a migração, os subscritores que ainda utilizam versões antigas da aplicação não receberão notificações enviadas pelo PushEngage, porque o payload do PushEngage não pode ser decodificado pelo SDK antigo.
- Novas versões da app com o SDK PushEngage. Se enviar a partir do painel do seu fornecedor anterior após a migração, essas notificações não aparecerão nas novas versões da app, porque o payload antigo não pode ser decodificado pelo SDK PushEngage.
Em resumo, envie a partir do PushEngage para utilizadores na nova versão da app e espere que os utilizadores que não atualizaram migrem à medida que atualizam a app.
Perguntas Frequentes
Os subscritores têm de conceder novamente permissão para notificações?
Não. Se a permissão já foi concedida na sua app, 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 app com o SDK PushEngage receberão. Os utilizadores que ainda estão numa versão mais antiga da app com o SDK do fornecedor anterior não receberão notificações PushEngage até atualizarem a app.
Porque é que tenho de reutilizar as mesmas credenciais APNs e Firebase?
Porque os tokens de dispositivo estão associados a essas credenciais. Reutilizar o mesmo ID de App Push, certificado p12 e ID de Remetente Firebase mantém os seus tokens existentes válidos, que é o que torna a migração possível sem pedir aos utilizadores para se registarem novamente.
Que dados preciso do meu fornecedor atual?
Ou uma exportação de API usando o ID da app e a chave de API do seu fornecedor, 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.