Migration vers OneSignal

• Les développeurs implémentant le SDK OneSignal
• Les spécialistes du marketing gérant les campagnes et l’analytique

​

Prérequis

• Créez un compte sur OneSignal
• Invitez votre équipe

​

Étapes de migration

​

1. Auditez votre configuration de messagerie actuelle

• Les plateformes que vous prenez en charge : iOS, Android, Web, email, SMS, etc.
• Le code gérant les événements de notifications push et de messages in-app :
  • Affichage en premier plan et gestion des clics
  • Utilisation des liens profonds pour le push, l’email, etc.
  • Gestion des tokens push et des charges utiles
• Comment vous collectez les adresses email, les numéros de téléphone, les tokens push, etc.
• Les domaines email et la propriété DNS
• Les expéditeurs SMS et les mécanismes d’opt-in

• Les types de messages que vous envoyez : (transactionnels, marketing, etc.)
  • Modèles pour ces messages
• Comment vous segmentez et ciblez les utilisateurs.
• Les métriques d’analytique ou de conversion que vous suivez.

​

2. Concepts de base de OneSignal

• Utilisateurs - Identifiés via l’ID externe. Les utilisateurs sont composés de propriétés (tags, données de session, etc.) et d’abonnements (push, email, SMS).
• Abonnements - Fait référence à la façon dont un utilisateur peut recevoir des messages. Il existe 4 types d’abonnements :
  • Mobile : Peut recevoir des notifications push, des messages in-app et des Live Activities.
  • Push web : Peut recevoir des notifications push web.
  • Email : Peut recevoir des notifications par email.
  • SMS : Peut recevoir des notifications SMS.
• Segments - Un groupe d’utilisateurs partageant des propriétés communes.
• Tags - Une propriété utilisateur personnalisée.
• Événements personnalisés - Une action effectuée par un utilisateur.

​

3. Ajoutez le SDK OneSignal (développeurs)

​

Identifier les utilisateurs avec l’ID externe

• SDK mobile
• SDK web

​

Collecter de nouveaux emails et numéros de téléphone

• Abonnements email : utilisez la méthode addEmail dans notre SDK mobile et SDK web
• Abonnements SMS : utilisez la méthode addSms dans notre SDK mobile et SDK web

​

4. Supprimez votre implémentation héritée

​

Conflits et format des tokens push

• Obtenez l’identifiant du token push de l’appareil en utilisant notre SDK mobile Frontend
• Obtenez l’identifiant de l’appareil en utilisant notre API Voir l’utilisateur

• Format du token iOS Push APNS : 64 caractères, caractères hexadécimaux uniquement (0-9,a-f). deviceToken.map {String(format: "%02x", $0)}.joined()
• Format du token Android Push FCM : Généralement 163 caractères, caractères alphanumériques, peut contenir des tirets, des deux-points et des traits de soulignement.

​

Gestion des charges utiles push

​

Migration progressive (applications mobiles uniquement)

• Ne laissez pas plusieurs SDK générer des tokens push. Laissez OneSignal s’en charger et partagez le token avec votre ancien système si nécessaire.
  • Utilisez le SDK Frontend ou l’API Voir l’utilisateur
• Mettez à jour les filtres de charge utile pour que votre SDK hérité ne traite pas les pushs OneSignal.
  • OneSignal utilise une clé "custom" dans son rawPayload (docs).
  • Vérifiez cette clé dans NotificationCompat (Android).
• Décidez quel fournisseur gère quels types de notifications.
• Fixez une date limite claire et construisez un plan d’élimination progressive pour les systèmes hérités.
  • Créez un modèle de notification pour chaque type de notification que vous envoyez.
  • Configurez votre ancien fournisseur pour envoyer des messages aux utilisateurs sur l’ancienne version de votre application et OneSignal pour envoyer des messages aux utilisateurs sur la nouvelle version de votre application.
  • Créez des segments pour cibler des groupes d’utilisateurs spécifiques.

​

5. Migration du push web

• Vous ne pouvez pas importer les abonnements push web en raison des limites de sécurité du navigateur. OneSignal enregistrera les utilisateurs lorsqu’ils reviendront.
• Vous devez désenregistrer vos anciens service workers push avant que OneSignal puisse prendre le relais.

1. Supprimez le SDK hérité : Code sur le site web et fichiers Service Worker.
2. Ajoutez ce code pour vous assurer que le Service Worker est désenregistré.
3. Remplacez sw.js par le nom du fichier Service Worker tiers.

if ('serviceWorker' in navigator) {
  navigator.serviceWorker.getRegistrations().then(function(registrations) {
    for (let registration of registrations) {
      if (registration.active.scriptURL.includes("sw.js")) {
        registration.unregister();
      }
    }
  });
}

​

Migration entre applications OneSignal

• Les abonnements push web ne peuvent pas être transférés directement entre les applications. Chaque abonnement est lié à la fois au domaine (origine) de votre site et à l’ID d’application OneSignal.
• Pour migrer, mettez à jour le code d’initialisation OneSignal de votre site pour utiliser l’appId de l’App B :

OneSignal.init({
  appId: "YOUR_APP_B_ID",
});

• Lorsqu’un utilisateur revisite votre site, l’autorisation push existante du navigateur permettra à OneSignal de l’enregistrer silencieusement dans l’App B.
• Aucune nouvelle invite d’autorisation n’apparaîtra, mais les utilisateurs doivent visiter votre site au moins une fois pour que l’abonnement soit créé dans l’App B.
• Les abonnés continueront à apparaître dans l’App A jusqu’à ce qu’ils deviennent inactifs.

​

6. Configuration des emails et SMS

​

Le réchauffement des emails est-il requis ?

​

Puis-je obtenir une adresse IP dédiée ?

​

7. Importer les utilisateurs existants (optionnel)

​

Considérations par plateforme

• Les adresses email doivent provenir d’utilisateurs actifs et valides. N’importez pas les adresses email qui n’ont jamais cliqué ou ouvert d’emails auparavant.
• Les numéros de téléphone doivent être dans un format spécifique et les utilisateurs doivent avoir consenti à recevoir des SMS.
• Les abonnements iOS peuvent commencer à recevoir des notifications push immédiatement après l’importation. Les fonctionnalités comme le suivi des clics de notification et les livraisons confirmées nécessitent que notre SDK soit actif sur l’appareil.
• Les abonnements Android/Huawei/Amazon doivent avoir notre SDK actif sur l’appareil pour recevoir des notifications, soit par une mise à jour automatique, soit par une mise à jour manuelle.
• Les abonnements web ne peuvent pas être importés. Si vous suivez ce qui précède dans Migration du push web, l’abonnement push web sera créé et le token push récupéré via notre SDK lorsque l’utilisateur reviendra sur le site.

​

Étapes d’importation

1. Consultez les documents Utilisateurs et Abonnements pour comprendre.
2. Exportez les données des utilisateurs de test depuis l’ancien système.
3. Formatez les données pour l’API Créer un utilisateur de OneSignal.
4. Importez les utilisateurs de test et, après un test réussi, conservez le processus pour le répéter dans la liste de vérification pré-lancement.

• token - Le token push, l’adresse email ou le numéro de téléphone
• type - Le type d’abonnement : iOSPush, AndroidPush, WebPush, Email, SMS
• external_id - Un identifiant unique pour l’utilisateur. Il est recommandé de l’utiliser pour le suivi et l’analytique.

  {
    "identity": {
      "external_id": "user_12345"
    },
    "subscriptions": [
      {
        "type": "iOSPush",
        "token": "7abcd49d0affb7426a8f1202420e8f4e2fc4df58e49501adc383f3bd66df8636"
      },
      {
        "type": "AndroidPush",
        "token": "dQGm89TZQXiTvLsRIj_GBo:APA91bpgqFgqkP2qYvV1uW2kdK5Z3TjgCXB_1jkL6VJrgH3hoYn16MvFY19tzDE4OuSgKjYC7itbFpSJYHBfKLWt-xZYBpgCVhYn9K5neV_9-Zj7s9mOSjRUJ2IwEwVSYhR-j5ICF9WB"
      },
      {
        "type": "Email",
        "email": "test@example.com"
      },
      {
        "type": "SMS",
        "phone_number": "+1234567890"
      }
    ]
  }

​

7. Testez la migration

1. Activez la journalisation de débogage dans le SDK OneSignal.
2. Testez sur de vrais appareils pour toutes les plateformes (Android, iOS, Web, etc.).
3. Vérifiez la gestion des notifications en premier plan et en arrière-plan.

• Envoyez des notifications de test depuis OneSignal aux utilisateurs importés avant d’ajouter le SDK OneSignal.
  • Vous devriez recevoir le push sur iOS mais vous n’obtiendrez pas de livraison confirmée ni d’analytique de clics.
  • Vous pouvez recevoir le push sur Android si vous avez un autre SDK push et n’avez pas encore implémenté les exigences de Gestion des charges utiles. La notification manque probablement de données et ne fonctionne pas comme prévu lorsqu’on clique dessus.
• Envoyez des notifications de test depuis OneSignal aux utilisateurs importés après avoir ajouté le SDK OneSignal.
  • Vous devriez recevoir le push sur Android et iOS avec une livraison confirmée et une analytique de clics.
• Testez le comportement des notifications avec l’application dans différents états.
• Vérifiez que les liens profonds et les actions personnalisées fonctionnent correctement.

• Envoyez depuis votre fournisseur actuel et OneSignal.
• Vérifiez les notifications en double
• Vérifiez que les notifications de chaque fournisseur s’affichent correctement
• Testez les scénarios de connexion/déconnexion des utilisateurs

​

Liste de vérification pré-lancement

• Élaborez un plan de messagerie pour inciter aux mises à jour de l’application
• Envisagez d’utiliser les notifications push et les messages in-app de votre ancien système pour rappeler gentiment aux utilisateurs de mettre à jour.

• Vérifiez que l’analytique des notifications push et des messages in-app fonctionne comme prévu.
  • Les événements de clic et la livraison confirmée sont suivis sur Android et iOS.
• Vérifiez que les événements de clic et les événements reçus en premier plan sont gérés correctement pour les messages envoyés depuis les deux fournisseurs.
• Si vous importez des utilisateurs, exportez les utilisateurs Android et iOS qui ont été actifs dans votre application au cours des 270 derniers jours pour éviter d’importer des tokens expirés. Consultez la FAQ sur les tokens FCM expirés pour plus de détails.

​

Lancez votre application/site

• La plupart des utilisateurs verront leur application se mettre à jour automatiquement vers la dernière version.
• Lorsque les utilisateurs ouvrent votre application mise à jour, ils ne seront pas invités à s’abonner aux notifications push si les autorisations ont déjà été accordées—soit via les invites d’autorisation requises, soit via les paramètres de notification de l’application.

• Les utilisateurs seront créés automatiquement dans OneSignal lorsqu’ils ouvriront la version mise à jour de l’application. Ils ne seront pas invités à s’abonner au push s’ils étaient précédemment abonnés.
• Vous devrez attendre qu’ils ouvrent l’application mise à jour avant de pouvoir leur envoyer des messages.
• Continuez à envoyer des notifications et des messages in-app depuis le fournisseur push précédent pendant quelques jours jusqu’à ce que suffisamment d’utilisateurs apparaissent dans OneSignal. Envoyez des alertes supplémentaires leur demandant de mettre à jour l’application vers la dernière version.

​

Surveillez les résultats

• Surveillez les taux d’erreur et les plantages après le déploiement.
• Surveillez les invalidations de tokens inattendues.
• Vérifiez l’analytique d’intégration du SDK.

• Notez la date de lancement de l’application.
• Communiquez avec vos développeurs sur :
  • Quelle voie de migration a été suivie (migration Propre ou Progressive).
  • Les utilisateurs ont-ils été importés ?
• Si vous suivez une migration Propre :
  • Dans la plateforme précédente, créez un segment ou une cohorte d’utilisateurs qui continuent à être actifs. Vérifiez leurs temps de session, les messages reçus et les événements de clic.
  • Seuls les utilisateurs qui n’ont pas mis à jour l’application devraient continuer à être actifs et contenus dans ce groupe.
  • Continuez à envoyer des notifications push et des messages in-app depuis votre fournisseur précédent à ces utilisateurs, en les incitant gentiment à mettre à jour.
  • Arrêtez d’envoyer depuis le fournisseur précédent jusqu’à ce que vous soyez prêt à passer complètement à OneSignal.
• Si vous suivez une migration Progressive :
  • Dans la plateforme précédente, créez un segment ou une cohorte d’utilisateurs qui ont l’ancienne version de l’application avant OneSignal.
  • Continuez à envoyer des notifications push et des messages in-app depuis votre fournisseur précédent à ces utilisateurs d’anciennes applications, en les incitant gentiment à mettre à jour.
  • Arrêtez d’envoyer depuis le fournisseur précédent jusqu’à ce que vous soyez prêt à passer complètement à OneSignal.
  • Supprimez le code du fournisseur push précédent lors de la prochaine version de l’application.