Documentation Experience Platform Mapping d’identités

Mapping d’identités

Dernière mise à jour : 5 mai 2025

Rubriques :

Créé pour :

Débutant
Intermédiaire
Développeur

Dans cette leçon, nous allons créer des espaces de noms d’identité et ajouter des champs d’identité à nos schémas. Après cela, nous serons également en mesure d’établir les relations de schéma de la leçon précédente.

Adobe Experience Platform Identity Service vous permet de mieux connaître vos clients et leurs comportements, en établissant un lien entre les identités des différents appareils et systèmes, ce qui vous permet de proposer des expériences digitales personnelles et percutantes en temps réel. Les champs d’identité et les espaces de noms sont le ciment qui relie différentes sources de données pour créer le profil client en temps réel à 360 degrés.

Architectes de données devront mapper les identités en dehors de ce tutoriel.

Avant de commencer les exercices, regardez cette courte vidéo pour en savoir plus sur l’identité dans Adobe Experience Platform :

NOTE

Les champs d’identité ne sont obligatoires que si vous créez des profils clients en temps réel. Elles ne sont pas requises si vous ingérez uniquement des données dans le lac de données.

Autorisations requises

Dans la leçon Configurer les autorisations, vous allez configurer tous les contrôles d’accès requis pour suivre cette leçon.

Créer un espace de noms identité

Dans cet exercice, nous allons créer des espaces de noms d’identité pour les champs d’identité personnalisés, loyaltyId, crmId et productSku de Luma. Les espaces de noms d’identité jouent un rôle essentiel dans la création de profils clients en temps réel, car deux valeurs correspondantes dans le même espace de noms permettent à deux sources de données de former un graphique d’identité.

Création d’espaces de noms dans l’interface utilisateur

Commençons par créer un espace de noms pour le schéma de fidélité Luma :

Dans l’interface utilisateur de Platform, accédez à Identités dans le volet de navigation de gauche
Vous remarquerez qu’il existe plusieurs espaces de noms d’identité d’usine disponibles. Sélectionnez le bouton Créer un espace de noms d’identité
Fournissez les détails suivants :

Champ Valeur
Nom d’affichage Identifiant de fidélité Luma
Symbole d’identité lumaLoyaltyId
Type Multi-appareils
Sélectionnez Créer

Champ	Valeur
Nom d’affichage	Identifiant de fidélité Luma
Symbole d’identité	lumaLoyaltyId
Type	Multi-appareils

Configurez maintenant un autre espace de noms pour le schéma de catalogue de produits Luma avec les détails suivants :

Champ	Valeur
Nom d’affichage	SKU du produit Luma
Symbole d’identité	lumaProductSKU
Type	Identifiant non personnel

Créer un espace de noms d’identité à l’aide de l’API

Nous allons créer notre espace de noms CRM via l'API.

NOTE

Si vous préférez ignorer les exercices d’API, n’hésitez pas à créer l’espace de noms CRM par le biais de la méthode de l’interface utilisateur que vous avez utilisée avec les détails suivants :

Comme Nom d’affichage, utilisez Luma CRM Id
Comme symbole d’identité, utilisez lumaCrmId
Comme Type, utilisez l’option sur plusieurs appareils

Créons l’espace de noms d’identité Luma CRM Id :

Téléchargez Identity Service.postman_collection.json dans votre dossier Luma Tutorial Assets
Importer la collection dans Postman
Si vous ne disposez pas d’un jeton d’accès, ouvrez le OAuth: Request Access Token de requête et sélectionnez Envoyer pour demander un nouveau jeton d’accès.
Sélectionnez la requête Service d’identités > Espace de noms d’identité > Créer un espace de noms d’identité.

Collez les éléments suivants en tant que Body de la requête :

{
    "name": "Luma CRM Id",
    "code": "lumaCrmId",
    "idType": "Cross_device"
}

Appuyez sur le bouton Envoyer pour obtenir une réponse 200 OK :

Si vous revenez à l’interface utilisateur, vous devriez maintenant voir vos trois nouveaux espaces de noms personnalisés :
Espace de noms d’identité

Champs d’identité des libellés dans les schémas

Maintenant que nous avons nos espaces de noms, l’étape suivante consiste à mettre à jour nos schémas pour libeller nos champs d’identité.

Étiqueter les champs XDM pour l’identité du Principal

Chaque schéma utilisé avec le profil client en temps réel est requis pour qu’une identité principale soit spécifiée. Et chaque enregistrement ingéré doit avoir une valeur pour ce champ.

Ajoutons une identité principale au Luma Loyalty Schema :

Ouvrir le Luma Loyalty Schema
Sélectionner le Luma Identity profile field group
Sélectionner le champ loyaltyId
Cochez la case Identité
Cochez également la case Identité du Principal
Sélectionnez l’espace de noms Luma Loyalty Id dans le menu déroulant Espaces de noms d’identité
Sélectionnez Appliquer
Sélectionnez Enregistrer

d’identité de Principal

Répétez le processus pour certains de vos autres schémas :

Dans la Luma CRM Schema, libellez le champ crmId comme identité principale à l’aide de l’espace de noms Luma CRM Id
Dans la Luma Offline Purchase Events Schema, libellez le champ loyaltyId comme identité principale à l’aide de l’espace de noms Luma Loyalty Id
Dans la Luma Product Catalog Schema, libellez le champ productSku comme identité principale à l’aide de l’espace de noms Luma Product SKU

NOTE

Les données collectées avec le SDK Web constituent une exception à la pratique courante consistant à libeller les champs d’identité dans le schéma . Web SDK utilise le mappage d’identités pour libeller les identités côté implémentation et ainsi nous déterminerons les identités de l’Luma Web Events Schema lorsque nous implémentons Web SDK sur le site Web Luma. Dans cette leçon ultérieure, nous allons collecter l’identifiant visiteur Experience Cloud (ECID) en tant qu’identifiant principal et crmId en tant qu’identifiant secondaire.

Avec notre sélection d’identités principales, il est clair que Luma Loyalty Schema pouvez vous connecter à l’Luma Offline Purchase Events Schema, car ils utilisent tous deux loyaltyId comme identifiant. Mais comment le CRM peut-il se connecter aux événements d’achat hors ligne ? Comment relier nos achats hors ligne au comportement en ligne ? Et comment classer les produits achetés avec notre catalogue de produits ? Nous utiliserons d’autres champs d’identité et relations de schéma.

Étiqueter les champs XDM pour l’identité Secondaire

Plusieurs champs d’identité peuvent être ajoutés à un schéma. Les identités non principales sont souvent appelées identités secondaires. Pour connecter les achats hors ligne au comportement en ligne, nous ajouterons le crmId en tant qu’identifiant secondaire à notre Luma Loyalty Schema et ultérieurement dans nos données d’événements web. Mettons à jour le Luma Loyalty Schema :

Ouvrir le Luma Loyalty Schema
Sélectionner un Luma Identity Profile Field group
Sélectionner crmId champ
Cochez la case Identité
Sélectionnez l’espace de noms Luma CRM Id dans le menu déroulant Espaces de noms d’identité
Sélectionnez Appliquer puis cliquez sur le bouton Enregistrer pour enregistrer vos modifications

Compléter les relations de schéma

Maintenant que nos champs d’identité sont étiquetés, nous pouvons terminer la configuration des relations de schéma entre le catalogue de produits de Luma et les schémas d’événement :

Ouvrir le Luma Offline Purchase Events Schema
Sélectionner le groupe de champs Détails Commerce
Sélectionnez le champ productListItems > SKU
Cochez la case Relation
Sélectionnez Luma Product Catalog Schema comme Schéma de référence
Luma Product SKU doit automatiquement être renseigné comme espace de noms d’identité de référence
Sélectionnez Appliquer
Sélectionnez Enregistrer

Répétez ce processus pour créer une relation entre le Luma Web Events Schema et le Luma Product Catalog Schema.

Notez qu’après avoir défini la relation, elle est indiquée à la fois dans les sections Composition et Structure de l’éditeur de schéma.

Visualisation des relations dans l’éditeur de schémas

Ressources supplémentaires

Maintenant que nos identités sont en place, nous pouvons créer nos jeux de données !

recommendation-more-help