Remarque : Il n'y a pas de documentation héritée disponible pour cet élément, vous voyez donc la documentation actuelle.
Vous pouvez déplacer vos abonnés aux notifications push d'applications iOS et Android de OneSignal vers PushEngage en réutilisant les mêmes identifiants Apple et Firebase que votre application utilise déjà. Comme les jetons d'appareil sont émis par Apple et Google plutôt que par OneSignal, la conservation de ces identifiants permet à vos jetons de continuer à fonctionner après le changement. Ce guide explique comment la migration fonctionne et les étapes pour la configurer. La migration est un processus backend géré conjointement avec notre équipe.
Avant de commencer
- Créez un compte avec PushEngage.
- Préparez vos identifiants de notification push Apple, en particulier votre identifiant de notification push d'application et le certificat p12 de votre compte développeur Apple, les mêmes que ceux utilisés dans OneSignal.
- Préparez votre ID d'expéditeur Firebase Android, le même que celui utilisé dans OneSignal.
- Ayez accès à votre compte OneSignal pour exporter les données des abonnés.
Comment fonctionne la migration d'applications
Les jetons d'appareil pour les notifications push d'applications proviennent du service de notification push Apple (APNs) et de Firebase Cloud Messaging (FCM), pas de OneSignal. Si vous configurez PushEngage avec les mêmes identifiants APNs et FCM, vos jetons restent valides et la migration s'effectue côté serveur. L'autorisation de notification est également conservée, de sorte qu'un utilisateur qui a déjà accordé l'autorisation n'a pas besoin de la réaccorder.
Étapes pour migrer
Étape 1 : Exportez vos abonnés de OneSignal
Exportez vos données d'abonné en utilisant l'une ou l'autre méthode :
- Exportation par API, en utilisant votre ID d'application OneSignal et votre clé API d'application.
- Exportation CSV, avec un fichier incluant
identifier,device_type,language, et tout autre champ pertinent.
Étape 2 : Configurez FCM Android dans PushEngage
- Connectez-vous au tableau de bord PushEngage.
- Allez dans Paramètres » Installation » SDK Android.
- Configurez les paramètres FCM Android de Google en utilisant le même ID d'expéditeur Firebase que celui que vous avez utilisé dans OneSignal.
Étape 3 : Configurez APNs iOS dans PushEngage
- Accédez à Paramètres » Installation » SDK iOS.
- Configurez les paramètres APNs iOS d'Apple en utilisant le même ID de notification push d'application que celui de votre configuration OneSignal.
- Téléchargez le certificat p12 de votre compte développeur Apple, le même que celui que vous avez utilisé dans OneSignal.
Notes importantes sur le passage à la nouvelle version de l'application
La migration des notifications push d'application dépend de la version de votre application qu'un abonné utilise, alors planifiez soigneusement votre passage à la nouvelle version.
- Anciennes versions d'applications avec le SDK OneSignal. Après la migration, les abonnés utilisant encore d'anciennes versions d'applications ne recevront pas les notifications envoyées par PushEngage, car la charge utile PushEngage ne peut pas être décodée par le SDK OneSignal.
- Nouvelles versions d'applications avec le SDK PushEngage. Si vous envoyez depuis le tableau de bord OneSignal après la migration, ces notifications n'apparaîtront pas sur les nouvelles versions d'applications, car la charge utile OneSignal ne peut pas être décodée par le SDK PushEngage.
Envoyez depuis PushEngage pour les utilisateurs de la nouvelle version de l'application, et attendez-vous à ce que les utilisateurs qui n'ont pas mis à jour migrent au fur et à mesure qu'ils mettent à jour l'application.
Questions fréquemment posées
Mes utilisateurs d'applications doivent-ils à nouveau accorder l'autorisation de notification ?
Non. Si l'autorisation a déjà été accordée dans votre application, elle est conservée et n'a pas besoin d'être accordée à nouveau après la migration.
Tous les abonnés recevront-ils des notifications juste après la migration ?
Les utilisateurs de la nouvelle version de l'application avec le SDK PushEngage le feront. Les utilisateurs toujours sur une ancienne version de l'application avec le SDK OneSignal ne recevront pas les notifications PushEngage tant qu'ils n'auront pas mis à jour l'application.
Pourquoi réutiliser les mêmes identifiants APNs et Firebase ?
Parce que les jetons d'appareil sont liés à ces identifiants. La réutilisation du même identifiant d'application Push, du certificat p12 et de l'identifiant de l'expéditeur Firebase permet de conserver la validité de vos jetons existants, ce qui rend la migration possible sans demander aux utilisateurs de se réenregistrer.
Quelles données dois-je exporter de OneSignal ?
Soit une exportation API à l'aide de votre identifiant d'application OneSignal et de votre clé API d'application, soit un CSV qui inclut au moins identifier, device_type et language, ainsi que tout autre champ pertinent.
Si vous rencontrez des problèmes, n'hésitez pas à nous contacter en cliquant ici. Notre équipe d'assistance pourra vous aider.
