Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt

Use this file to discover all available pages before exploring further.

OneSignal a migré d’un modèle centré sur l’appareil (Player ID) vers un modèle centré sur l’utilisateur basé sur le concept d’utilisateur unifié. Ce guide explique le nouveau modèle, comment il diffère de l’ancienne approche et comment migrer votre application de manière sûre et réussie.
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 :
Illustration multicanal du 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é
Ce modèle simplifie le ciblage d’audience, prend en charge la messagerie multicanal personnalisée et débloque des fonctionnalités avancées comme les Journeys, les analyses au niveau utilisateur et la résolution d’identité en temps réel.
Diagramme montrant la différence entre les modèles Player et utilisateur

​
Concepts clés

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 OneSignal
  • external_id : Défini via le SDK login() ou l’API (alias réservé)
  • Alias personnalisés : par ex. user_id, email, facebook, etc.
En savoir plus : Utilisateurs

​
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

Le modèle utilisateur n’est pas rétrocompatible. La migration est à sens unique du modèle Player vers le modèle utilisateur.Avant de migrer :
  • Testez minutieusement dans un environnement de préproduction
  • Migrez uniquement après la mise à jour de tous les SDK et services backend
1

Unifier les utilisateurs avec external_id

Utilisez les alias d’identité pour lier les enregistrements de joueurs existants en utilisateurs unifiés.Options :OneSignal fusionnera automatiquement les abonnements sous le même ID externe.
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

PlateformeSDKGuide de migration
Androidv5+Guide
iOSv5+Guide
Unityv5+Guide
Flutterv5+Guide
React Nativev5+Guide
.NET MAUIv5+Guide
Pour un mappage des anciennes méthodes du modèle Player vers les nouvelles méthodes du modèle utilisateur, voir Mappage du SDK mobile.

​
Référence API

Ancienne APIRemplacement
Add DeviceCreate User ou Create Subscription
Edit DeviceUpdate User ou Update Subscription
Delete PlayerDelete 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 !