Passer au contenu principal
Les alias personnalisés vous permettent d’attribuer des identifiants clé-valeur personnalisés aux utilisateurs dans OneSignal, permettant le suivi et l’identification des utilisateurs multiplateformes en utilisant vos propres ID internes.
Important : Vous devez définir un ID externe avant d’utiliser des alias personnalisés.OneSignal utilise un onesignal_id unique pour identifier les utilisateurs. Cet ID reste cohérent entre les abonnements uniquement s’ils ont le même external_id.Les alias personnalisés ne relient pas les abonnements ensemble—ils dépendent de l’external_id pour fonctionner correctement. Sans lui, les alias ne s’associeront pas au même utilisateur sur différents appareils ou plateformes.

​
Qu’est-ce qu’un alias personnalisé ?

Un alias personnalisé est une paire clé : valeur où :
  • Le alias_label (clé) est un identifiant cohérent et statique pour tous les utilisateurs (par exemple, facebook_id, firebase_id, crm_user_id).
  • L’alias_id (valeur) est l’ID spécifique de l’utilisateur pour ce libellé (par exemple, facebook_id: 3453443, firebase_id: test3555).
Cela vous permet de lier les enregistrements utilisateur OneSignal aux identifiants de vos autres plateformes ou bases de données.

​
Pourquoi utiliser des alias ?

  1. Identifier les utilisateurs sur plusieurs plateformes et bases de données.
  2. Envoyer des messages transactionnels ciblés en utilisant l’API REST Create Message.
  3. Récupérer, mettre à jour ou supprimer des utilisateurs via les API REST utilisateur.

​
Comment définir des alias

Vous pouvez définir des alias soit en utilisant le SDK OneSignal soit via l’API REST.

​
Utilisation du SDK

Suivez ces étapes dans votre application :
  1. Définir l’ID externe Appelez OneSignal.login(externalId) pour associer l’enregistrement utilisateur.
  2. Définir des alias personnalisés Utilisez OneSignal.User.addAlias(label, id) pour ajouter un seul alias, ou OneSignal.User.addAliases({ label1: id1, label2: id2 }) pour en définir plusieurs.
  3. Déconnexion (optionnel) Utilisez OneSignal.logout() pour supprimer l’ID externe et tous les alias associés pour cet appareil ou cette session.
Exemple : 
OneSignal.login("user_123");

OneSignal.User.addAliases({
  facebook_id: "3453443",
  firebase_id: "test3555"
});

// Plus tard, lorsque l'utilisateur se déconnecte
OneSignal.logout();

​
Utilisation de l’API REST

Pour définir des alias personnalisés via l’API, utilisez le point de terminaison Create Alias. Cette méthode est généralement utilisée dans les systèmes backend pour la gestion des utilisateurs côté serveur. Exemple de requête : 
POST /aliases
{
  "subscription_id": "abc123",
  "aliases": {
    "facebook_id": "3453443",
    "crm_user_id": "XYZ789"
  }
}

​
Bonnes pratiques

  • Définissez toujours l’external_id avant d’attribuer des alias.
  • Utilisez des libellés stables et descriptifs (par exemple, crm_user_id, legacy_user_id) pour éviter toute confusion entre les équipes.
  • Évitez d’utiliser des informations sensibles telles que des adresses e-mail ou des numéros de téléphone comme valeurs d’alias.
  • Utilisez logout() pour nettoyer les alias lors de la déconnexion de l’appareil ou des événements de changement d’utilisateur.
Tutoriel sur les alias personnalisés terminé ! Prochaines étapes :
  • Consultez notre documentation sur les utilisateurs et les abonnements si vous ne l’avez pas déjà fait.
  • Explorez notre documentation sur l’API REST pour plus de détails sur l’utilisation des alias via l’API.
  • Configurez les intégrations pour synchroniser les données utilisateur entre les systèmes.