DocumentationExperience PlatformDonnées de modèle dans les schémas

Données de modèle dans les schémas

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Débutant
  • Intermédiaire
  • Développeur

Dans cette leçon, vous allez modéliser les données de Luma en schémas. C'est l'une des plus longues leçons du tutoriel, alors prenez un verre d'eau et bouclez-vous !

La normalisation et l’interopérabilité sont les concepts clés d’Adobe Experience Platform. Le modèle de données d’expérience (XDM) vise à normaliser les données d’expérience client et à définir des schémas pour la gestion de l’expérience client.

XDM est une spécification documentée publiquement conçue pour améliorer la puissance des expériences digitales. Elle fournit des structures et des définitions communes permettant à chaque application de communiquer avec les services Platform. L’adhésion aux normes XDM permet d’intégrer toutes les données d’expérience client dans une représentation commune afin de fournir des informations de manière plus rapide et intégrée. Vous pouvez obtenir des informations précieuses à partir des actions des clients, définir des audiences de clients par le biais de segments et utiliser les attributs du client à des fins de personnalisation.

XDM est le cadre de base qui permet à Adobe Experience Cloud, optimisé par Experience Platform, de transmettre le message approprié à la bonne personne, sur le bon canal et exactement au bon moment. La méthodologie sur laquelle Experience Platform repose, à savoir le système XDM, rend les schémas de modèles de données d’expérience opérationnels pour qu’ils soient utilisés par les services Platform.

Les architectes de données devront créer des schémas en dehors de ce tutoriel, mais les ingénieurs de données travailleront en étroite collaboration avec les schémas créés par l’architecte de données.

Avant de commencer les exercices, regardez cette courte vidéo pour en savoir plus sur les schémas et le modèle de données d’expérience (XDM) :

https://video.tv.adobe.com/v/38503?learn=on&captions=fre_fr

TIP
Pour approfondir la modélisation des données dans Experience Platform, nous vous recommandons de suivre le cours Modèle de vos données d’expérience client avec XDM, disponible gratuitement sur Experience League !

Autorisations requises

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

Créer un schéma de fidélité via l’interface utilisateur

Au cours de cet exercice, nous allons créer un schéma pour les données de fidélité de Luma.

  1. Accédez à l’interface utilisateur de Platform et vérifiez que votre environnement de test est sélectionné.

  2. Accédez à Schémas dans le volet de navigation de gauche.

  3. Sélectionnez le bouton Créer un schéma en haut à droite.
    Schéma avec groupe de champs prêt à l’emploi

  4. Dans le workflow Créer un schéma , sélectionnez Individual Profile comme classe de base pour votre schéma, puisque nous allons modéliser les attributs d’un client individuel (points, statut, etc.).

  5. Sélectionnez Suivant.
    Sélectionner la classe de base

  6. Saisissez Luma Loyalty Schema dans le champ de texte Nom d’affichage du schéma . Dans la zone de travail ci-dessous, vous pouvez également examiner et vérifier la structure du schéma de base fournie par la classe que vous avez choisie.

  7. Sélectionnez Terminer pour créer votre schéma.
    Terminer la création du schéma de fidélité

Ajouter des groupes de champs standard

Une fois le schéma créé, vous êtes redirigé vers l’éditeur de schémas dans lequel vous pouvez ajouter des champs au schéma. Vous pouvez ajouter des champs individuels directement au schéma ou utiliser des groupes de champs. Il est important de noter que tous les champs individuels sont toujours associés à une classe ou à un groupe de champs. Vous pouvez choisir parmi un grand ensemble de groupes de champs standard fournis par Adobe ou créer les vôtres. Lorsque vous commencez à modéliser vos propres données en Experience Platform, il est bon de vous familiariser avec les groupes de champs standard fournis par Adobe. Dans la mesure du possible, il est recommandé de les utiliser, car ils alimentent parfois des services en aval, tels que Customer AI, Attribution AI et Adobe Analytics.

Lorsque vous utilisez vos propres données, une étape importante consiste à déterminer celles qui doivent être capturées dans Platform et comment elles doivent être modélisées. Cette grande rubrique est abordée plus en détail dans le cours Modèle de vos données d’expérience client avec XDM. Dans ce tutoriel, je vous guiderai tout au long de la mise en oeuvre de certains schémas prédéterminés.

Pour ajouter des groupes de champs :

  1. Sélectionnez Ajouter sous l’en-tête Groupes de champs .
    Ajouter un nouveau groupe de champs

  2. Dans le modal Ajouter des groupes de champs , sélectionnez les groupes de champs suivants :

    1. Détails démographiques pour les données client de base telles que le nom et la date de naissance
    2. Détails de contact personnels pour obtenir des détails de contact de base tels que l’adresse électronique et le numéro de téléphone

  3. Vous pouvez prévisualiser les champs fournis dans le groupe de champs en sélectionnant l’icône située sur le côté droit de la ligne.
    Sélection de groupes de champs standards.

  4. Cochez la case Secteur > Vente au détail pour afficher les groupes de champs spécifiques à un secteur.

  5. Sélectionnez Loyalty Details pour ajouter les champs du programme de fidélité.

  6. Sélectionnez Ajouter des groupes de champs pour ajouter les trois groupes de champs au schéma.
    Ajouter des groupes de champs standard au schéma de fidélité

Maintenant, prenez du temps pour explorer l’état actuel du schéma. Les groupes de champs ont ajouté des champs standard liés à une personne, ses coordonnées et l’état du programme de fidélité. Ces deux groupes de champs peuvent s’avérer utiles lorsque vous créez des schémas pour les données de votre propre entreprise. Sélectionnez une ligne de groupe de champs spécifique ou cochez la case en regard du nom du groupe de champs pour voir comment la visualisation change.

Pour enregistrer le schéma, sélectionnez Enregistrer.
Enregistrement du schéma

NOTE
Cela ne vous dérange pas si un groupe de champs ajoute un champ pour un point de données que vous ne collectez pas. Par exemple, "faxPhone" peut être un champ pour lequel Luma ne collecte pas de données. Ça va. Ce n'est pas parce qu'un champ est défini dans le schéma que les données le concernant doivent être ingérées ultérieurement. Vous pouvez également supprimer le champ du schéma.

Ajouter un groupe de champs personnalisé

Maintenant, créons un groupe de champs personnalisé.

Bien que le groupe de champs de fidélité contienne un champ loyaltyID, Luma souhaite gérer tous ses identifiants système dans un seul groupe afin d’assurer la cohérence entre leurs schémas.

Les groupes de champs doivent être créés dans le workflow de schéma. Vous pouvez effectuer l’une des actions suivantes :

  • Ajoutez d’abord un nouveau champ personnalisé à votre schéma, puis créez un groupe de champs personnalisé, ou
  • Créez d’abord un groupe de champs personnalisé, puis ajoutez-y des champs.

Dans ce tutoriel, nous commençons par créer un groupe de champs personnalisé.

Pour créer le groupe de champs :

  1. Sélectionnez Ajouter sous l’en-tête Groupes de champs de schéma
    Ajouter un nouveau groupe de champs
  2. Sélectionnez Créer un groupe de champs
  3. Utilisez Luma Identity profile field group comme Nom d’affichage
  4. Utilisez system identifiers for XDM Individual Profile class comme Description
  5. Sélectionnez Ajouter des groupes de champs
    Ajouter un nouveau groupe de champs

Le nouveau groupe de champs vide est ajouté à votre schéma. Les boutons + peuvent être utilisés pour ajouter de nouveaux champs à n’importe quel emplacement de la hiérarchie. Dans notre cas, nous souhaitons ajouter des champs au niveau racine :

  1. Sélectionnez + en regard du nom du schéma. Un nouveau champ est alors ajouté sous l’espace de noms de l’identifiant du client pour gérer les conflits entre vos champs personnalisés et les champs standard.

  2. Dans la barre latérale Propriétés du champ, ajoutez les détails du nouveau champ :

    1. Nom du champ : systemIdentifier

    2. Nom d’affichage : System Identifier

    3. Type : Objet

    4. Dans la liste déroulante Groupe de champs, sélectionnez le groupe de champs de profil Luma Identity que nous avons créé.

      Ajouter un nouveau groupe de champs

    5. Sélectionnez Apply

      Appliquer les nouvelles propriétés de champ

Ajoutez maintenant deux champs sous l’objet systemIdentifier :

  1. Premier champ

    1. Nom du champ : loyaltyId
    2. Nom d’affichage : Loyalty Id
    3. Type : Chaîne

  2. Second champ

    1. Nom du champ : crmId
    2. Nom d’affichage : CRM Id
    3. Type : Chaîne

Votre nouveau groupe de champs devrait ressembler à ceci. Sélectionnez le bouton Enregistrer pour enregistrer votre schéma, mais laissez le schéma ouvert pour l’exercice suivant.
Groupe de champs de fidélité terminé

Création d’un type de données

Les groupes de champs, tels que votre nouveau Luma Identity profile field group, peuvent être réutilisés dans d’autres schémas, ce qui vous permet d’appliquer des définitions de données standard sur plusieurs systèmes. Mais elles ne peuvent être réutilisées que dans les schémas qui partagent une classe, dans ce cas la classe XDM Individual Profile.

Le type de données est un autre concept à champs multiples qui peut être réutilisé dans les schémas sur plusieurs classes. Convertissons notre nouvel objet systemIdentifier en un type de données :

Une fois Luma Loyalty Schema toujours ouvert, sélectionnez l’objet systemIdentifier et sélectionnez Convertir en un nouveau type de données.

Groupe de champs de fidélité Complète

Si vous Annuler hors du schéma et accédez à l’onglet Types de données, le type de données que vous venez de créer s’affiche. Nous utiliserons ce type de données plus loin dans la leçon.

Groupe de champs de fidélité Complète

Création d’un schéma CRM via l’API

Nous allons maintenant créer un schéma à l’aide de l’API.

TIP
Si vous préférez ignorer l’exercice d’API, vous pouvez créer le schéma suivant à l’aide de la méthode d’interface utilisateur :
  1. Utilisation de la classe Individual Profile
  2. Nommez-le Luma CRM Schema
  3. Utilisez les groupes de champs suivants : Détails démographiques, Détails des contacts personnels et Groupe de champs Identité Luma

Commencez par créer le schéma vide :

  1. Ouvrez Postman

  2. Si vous ne disposez pas d’un jeton d’accès, ouvrez la requête OAuth: Request Access Token et sélectionnez Envoyer pour demander un nouveau jeton d’accès.

  3. Ouvrez vos variables d'environnement et remplacez la valeur de CONTAINER_ID de global par tenant. N’oubliez pas que vous devez utiliser tenant lorsque vous souhaitez interagir avec vos propres éléments personnalisés dans Platform, comme la création d’un schéma.

  4. Sélectionnez Save
    Remplacez CONTAINER_ID par tenant

  5. Ouvrez la requête Schema Registry API > Schemas > Create a new custom schema.

  6. Ouvrez l’onglet Body et collez le code suivant et sélectionnez Send pour effectuer l’appel API. Cet appel crée un nouveau schéma à l’aide de la même classe de base XDM Individual Profile :

    code language-json 
    {
  "type": "object",
  "title": "Luma CRM Schema",
  "description": "Schema for CRM data of Luma Retail ",
  "allOf": [{
    "$ref": "https://ns.adobe.com/xdm/context/profile"
  }]
}
    note note
    NOTE
    Les références d’espace de noms dans cet exemple de code et les exemples de code suivants (par exemple https://ns.adobe.com/xdm/context/profile) peuvent être obtenues en utilisant les appels d’API de liste avec le CONTAINER_ID et accepter l’en-tête défini sur les valeurs correctes. Certaines sont également facilement accessibles dans l’interface utilisateur.

  7. Vous devriez obtenir une réponse 201 Created

  8. Copiez meta:altId du corps de la réponse. Nous l'utiliserons plus tard dans un autre exercice.
    Création du schéma CRM

  9. Le nouveau schéma doit être visible dans l’interface utilisateur, mais sans aucun groupe de champs.
    Création du schéma CRM

NOTE
Vous pouvez également obtenir l’ meta:altId ou l’ID de schéma en effectuant la requête d’API Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. avec l’ CONTAINER_ID défini sur tenant et un en-tête d’acceptation application/vnd.adobe.xdm+json.
TIP
Problèmes courants liés à cet appel et correctifs probables :
  • Aucun jeton d’authentification : exécutez la requête OAuth: Request Access Token pour générer un nouveau jeton
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/ : Mettez à jour la variable d'environnement CONTAINER_ID de global vers tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control : Vérifiez vos autorisations utilisateur dans l’Admin Console

Ajouter des groupes de champs standard

Il est maintenant temps d’ajouter les groupes de champs au schéma :

  1. Dans Postman, ouvrez la requête Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. Dans l’onglet Params , collez la valeur meta:altId de la réponse précédente en tant que SCHEMA_ID

  3. Ouvrez l’onglet Corps et collez le code suivant, puis sélectionnez Envoyer pour effectuer l’appel API. Cet appel ajoute les groupes de champs standard à votre Luma CRM Schema :

    code language-json 
    [{
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
    }
  },
  {
    "op": "add",
    "path": "/allOf/-",
    "value": {
      "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
    }
  }
]

  4. Vous devriez obtenir un état 200 OK pour la réponse et les groupes de champs doivent être visibles dans votre schéma dans l’interface utilisateur.

    Groupes de champs standard ajoutés

Ajouter un groupe de champs personnalisé

Ajoutons maintenant notre Luma Identity profile field group au schéma. Tout d’abord, nous devons trouver l’identifiant de notre nouveau groupe de champs à l’aide d’une API de liste :

  1. Ouvrez la requête Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Sélectionnez le bouton Envoyer pour récupérer une liste de tous les groupes de champs personnalisés de votre compte.

  3. Saisissez la valeur $id de Luma Identity profile field group (la valeur que vous aurez à l’écart de celle de cette capture d’écran).
    Récupérer la liste des groupes de champs

  4. Ouvrez à nouveau la requête Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID..

  5. L’onglet Params doit toujours comporter le $id de votre schéma

  6. Ouvrez l’onglet Body et collez le code suivant, en remplaçant la valeur $ref par le $id de votre propre Luma Identity profile field group :

    code language-json 
    [{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

  7. Sélectionnez Send
    Ajout du groupe de champs d’identité

Vérifiez que le groupe de champs a été ajouté au schéma en vérifiant la réponse de l’API et dans l’interface.

Créer un schéma d’événements d’achat hors ligne

Créez maintenant un schéma basé sur la classe Experience Event pour les données d’achat hors ligne de Luma. Comme vous vous familiarisez maintenant avec l’interface utilisateur de l’éditeur de schémas, je vais réduire le nombre de captures d’écran dans les instructions :

  1. Créez un schéma avec la classe Experience Event.
  2. Nommez votre schéma Luma Offline Purchase Events Schema.
  3. Ajoutez le groupe de champs standard Détails Commerce pour capturer les détails de commande courants. Passez quelques minutes à explorer les objets à l'intérieur.
  4. Recherchez Luma Identity profile field group. Elle n’est pas disponible ! N’oubliez pas que les groupes de champs sont liés à une classe. Comme nous utilisons une autre classe pour ce schéma, nous ne pouvons pas l’utiliser. Nous devons ajouter un nouveau groupe de champs pour la classe XDM ExperienceEvent contenant les champs d’identité. Notre type de données rendra cela vraiment facile !
  5. Bouton radio Créer un groupe de champs
  6. Saisissez le nom d'affichage Luma Identity ExperienceEvent field group et sélectionnez le bouton Ajouter des groupes de champs
  7. Sélectionnez + en regard du nom du schéma.
  8. En tant que Nom du champ, saisissez systemIdentifier.
  9. En tant que Nom d’affichage, saisissez System Identifier.
  10. En tant que Type, sélectionnez Identifiant système qui est le type de données personnalisé que vous avez créé précédemment.
  11. En tant que Groupe de champs, sélectionnez Groupe de champs Luma Identity ExperienceEvent.
  12. Sélectionnez le bouton Appliquer .
  13. Sélectionnez le bouton Enregistrer .

Notez comment le type de données a ajouté tous les champs.

Ajoutez le type de données au groupe de champs

Sélectionnez également XDM ExperienceEvent sous l’en-tête Class et examinez certains des champs fournis par cette classe. Notez que les champs _id et horodatage sont requis lors de l’utilisation de la classe XDM ExperienceEvent : ces champs doivent être renseignés pour chaque enregistrement que vous ingérez lors de l’utilisation de ce schéma :

Structure de base d’événement d’expérience

Création d’un schéma d’événements web

Nous allons maintenant créer un schéma supplémentaire pour les données du site web de Luma. A ce stade, vous devriez être un expert en création de schémas ! Créez le schéma suivant avec ces propriétés.

Propriété
Valeur
Classe
Événement d’expérience
Nom du schéma
Schéma des événements web Luma
Groupe de champs
ExperienceEvent du SDK Web AEP
Groupe de champs
Événement d’expérience du consommateur

Sélectionnez le groupe de champs Événement d’expérience client. Ce groupe de champs contient les objets commerce et productListItems qui se trouvaient également dans Commerce Details. En effet, Événement d’expérience client est une combinaison de plusieurs autres groupes de champs standard également disponibles séparément. Le groupe de champs ExperienceEvent du SDK Web AEP contient également d’autres groupes de champs, y compris certains des mêmes groupes dans l’ Événement d’expérience client. Heureusement, ils se fondent harmonieusement.

Notez que nous n’avons pas ajouté le Luma Identity ExperienceEvent field group à ce schéma. Cela est dû au fait que le SDK web dispose d’une autre manière de collecter les identités. Si vous sélectionnez la classe XDM ExperienceEvent dans la section Composition de l’éditeur de schéma, vous remarquerez que l’un des champs qu’il ajoute par défaut est appelé IdentityMap. IdentityMap est utilisé par différentes applications Adobe pour créer un lien vers Platform. Vous verrez comment les identités sont envoyées à Platform via identityMap dans la leçon sur l’ingestion par flux.

Création d’un schéma de catalogue de produits

En utilisant les groupes de champs Détails Commerce et Événement d’expérience client, Luma signale des détails sur les événements liés aux produits par le biais du type de données productListItems standard. Mais ils disposent également de champs de détails de produit supplémentaires qu’ils souhaitent envoyer à Platform. Au lieu de capturer tous ces champs dans leurs systèmes de point de vente et de commerce électronique, Luma préférerait ingérer ces champs directement à partir de son système de catalogue de produits. Une "relation de schéma" vous permet de définir une relation entre deux schémas à des fins de classification ou de recherche. Luma utilisera une relation pour classer les détails de son produit. Nous commencerons le processus maintenant et le terminerons à la fin de la prochaine leçon.

NOTE
Si vous êtes déjà client Analytics ou Target, la classification des entités avec des relations de schéma est analogue aux classifications de SAINT ou le téléchargement de votre catalogue de produits pour Recommendations

Tout d’abord, nous devons créer un schéma pour le catalogue de produits de Luma à l’aide d’une classe personnalisée :

  1. Sélectionnez le bouton Créer un schéma .

  2. Dans le workflow Créer un schéma , sélectionnez l’option Autre .
    Créer un schéma

  3. Sélectionnez le bouton Créer une classe

  4. Nommez-le Luma Product Catalog Class

  5. Laissez Comportement sur Enregistrement

  6. Sélectionnez le bouton Créer .
    Créer une classe

  7. La classe de catalogue de produits Luma que vous avez créée apparaît dans le tableau Classes ci-dessous. Assurez-vous que la classe est sélectionnée, puis sélectionnez Suivant.
    Nouvelle classe ajoutée

  8. Nommez le schéma Luma Product Catalog Schema.

  9. Créez un groupe de champs appelé Luma Product Catalog field group avec les champs suivants :

    1. productName : Nom du produit : chaîne
    2. productCategory : Catégorie de produits : chaîne
    3. productColor : Product Color : String
    4. productSku : SKU du produit : chaîne | Obligatoire
    5. productSize : Taille du produit : chaîne
    6. productPrice : Prix du produit : Double

  10. Enregistrer le schéma

Votre nouveau schéma devrait ressembler à ceci. Notez comment le champ productSku est répertorié dans la section Champs obligatoires :
Schéma de produit

L’étape suivante consiste à définir la relation entre les deux schémas ExperienceEvent et le Luma Product Catalog Schema. Toutefois, quelques étapes supplémentaires doivent être franchies dans la leçon suivante avant de pouvoir le faire.

Ressources supplémentaires

Maintenant que vous disposez de vos schémas, vous pouvez mapper les identités !

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad