Ce guide est destiné aux clients qui utilisent OneSignal depuis longtemps sur les versions 2, 3 ou 4 de nos SDK mobiles ou la v15 de notre SDK Web.Si vous êtes un nouveau client ou avez déjà migré vers la version 5 de nos SDK mobiles ou la v16 de notre SDK Web, vous pouvez ignorer ce guide et consulter :
Messagerie multicanal avec le modèle utilisateur
Qu’est-ce que le modèle utilisateur ?
Le modèle utilisateur vous permet de cibler des utilisateurs réels sur tous les canaux de messagerie auxquels ils sont abonnés (push mobile, push Web, e-mail, SMS et in-app) plutôt que de cibler des appareils individuels. Chaque utilisateur :- Possède un ou plusieurs alias d’identité (par ex. external_id, alias personnalisé)
- Peut avoir plusieurs abonnements, un pour chaque canal ou appareil
- Inclut des métadonnées comme les tags, la langue et l’historique d’activité
Modèle Player vs. Modèle utilisateur
Concepts clés
- Utilisateurs
- Abonnements
- Alias
Un utilisateur représente une personne réelle. Vous pouvez identifier un utilisateur à l’aide d’alias générés par le système ou personnalisés.
onesignal_id: Généré automatiquement par OneSignalexternal_id: Défini via le SDKlogin()ou l’API (alias réservé)- Alias personnalisés : par ex.
user_id,email,facebook, etc.
Avantages de la migration
- Identité unifiée : Un utilisateur sur tous les appareils et canaux
- Messagerie avancée : Fonctionnalités puissantes comme les Journeys, le suivi de connexion in-app et les campagnes de cycle de vie
- Segmentation claire : Groupez les utilisateurs par tags, statut d’abonnement, engagement par canal, et plus encore
- API simplifiée : Moins de points de terminaison, modèle de données plus cohérent
Étapes de migration
1
Unifier les utilisateurs avec external_id
Utilisez les alias d’identité pour lier les enregistrements de joueurs existants en utilisateurs unifiés.Options :
- SDK
login(externalId) - API : Créer un utilisateur, Mettre à jour un utilisateur
- CSV : Importer
2
Mettre à jour vos SDK OneSignal
Tous les SDK mobiles OneSignal v5+ et le SDK Web v16+ prennent en charge le modèle utilisateur.Déployez les mises à jour du SDK en utilisant des stratégies de déploiement progressif pour minimiser les risques :Voir le tableau de support des SDK ci-dessous.
3
Mettre à jour votre backend pour utiliser les nouvelles API utilisateur
Remplacez les appels API du modèle Player obsolètes par les équivalents du modèle utilisateur.Utilisez notre référence API et les tableaux ci-dessous pour mapper les anciens points de terminaison vers les nouveaux.
Support des SDK et guides de migration
- SDK mobiles
- SDK Web
- SDK backend
Référence API
- Modèle Player (Obsolète)
- Modèle utilisateur (Nouveau)
| Ancienne API | Remplacement |
|---|---|
| Add Device | Create User ou Create Subscription |
| Edit Device | Update User ou Update Subscription |
| Delete Player | Delete User ou Delete Subscription |
Prochaines étapes
- 📘 Consultez notre documentation sur les Utilisateurs et les Abonnements
- 🛠️ Mettez à jour les SDK et testez en préproduction avant de passer en production
- 💬 Besoin d’aide ? Contactez
support@onesignal.com
Vous êtes maintenant prêt à créer des expériences de messagerie multicanal personnalisées alimentées par le nouveau modèle utilisateur !