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

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

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 numériques. 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 insights précieux à 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.

Data Architects devra créer des schémas en dehors de ce tutoriel, mais Ingénieurs de données travaillera en étroite collaboration avec les schémas créés par Data Architect.

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) :

CONSEIL

Pour approfondir la modélisation des données dans l’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 boîte de dialogue Configuration des autorisations vous configurez tous les contrôles d'accès requis pour terminer ce cours.

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

Dans 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 la plate-forme et assurez-vous que votre sandbox est sélectionné.
  2. Aller à Schémas dans la navigation de gauche
  3. Sélectionnez l’option Créer un schéma en haut à droite
  4. Dans le menu déroulant, sélectionnez Profil individuel XDM, car nous allons modéliser les attributs d'un client individuel (points, statut, etc.).
    Schéma avec le groupe Champ OOTB

Ajout de groupes de champs standard

Vous serez ensuite invité à ajouter des groupes de champs au schéma. Tous les champs doivent être ajoutés aux schémas à l’aide de groupes. 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 se familiariser avec les groupes de champs standard fournis par Adobe. Dans la mesure du possible, il est recommandé de les utiliser car elles alimentent parfois des services en aval, tels que l’AI du client, l’Attribution AI et l’Adobe Analytics.

Lors de l'utilisation de vos propres données, une étape importante consistera à déterminer lesquelles de vos propres données doivent être capturées dans la plate-forme et comment elles doivent être modélisées. Ce grand sujet est abordé plus en détail dans le cours. Modèle de vos données d'expérience client avec XDM. Dans ce tutoriel, je vais vous guider tout au long de la mise en oeuvre de schémas prédéfinis.

Pour ajouter des groupes de champs :

  1. Dans la boîte de dialogue Ajouter des groupes de champs modale, 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. Coordonnées personnelles pour les coordonnées de base telles que l’adresse électronique et le numéro de téléphone
  2. Vous pouvez prévisualiser les champs fournis dans le groupe de champs en sélectionnant l’icône sur le côté droit de la ligne.
    Sélectionner des groupes de champs standard

  3. Cochez la case Industrie > Vente au détail pour exposer les groupes de champs spécifiques au secteur.

  4. Sélectionner Fidélité pour ajouter les champs du programme de fidélité.

  5. Sélectionner Ajouter un groupe de champs pour ajouter les trois groupes de champs au schéma.
    Ajout de groupes de champs standard au schéma de fidélité

Prenez le temps d’explorer l’état actuel du schéma. Les groupes de champs ont ajouté des champs standard liés à une personne, leurs 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 :

  1. Sélectionnez le noeud supérieur du schéma.
  2. Entrée Luma Loyalty Schema comme Nom d’affichage.
  3. Sélectionnez Enregistrer.
    Nommer et enregistrer le schéma
REMARQUE

Il n’est pas grave qu’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 correspondantes doit être assimilé ultérieurement.

Ajout d’un groupe de champs personnalisé

Nous allons maintenant créer un groupe de champs personnalisé.

Alors que le groupe de champs de fidélité contenait un loyaltyID , Luma souhaite gérer tous leurs identificateurs système dans un seul groupe afin de garantir la cohérence entre leurs schémas.

Les groupes de champs doivent être créés dans le workflow de schéma. Pour créer le groupe de champs :

  1. Sélectionner Ajouter sous Groupes de champs de schéma titre
    Ajouter un nouveau groupe de champs

  2. Sélectionner Créer un nouveau groupe de champs

  3. Utiliser Luma Identity profile field group comme Nom d’affichage

  4. Utiliser system identifiers for XDM Individual Profile class comme Description

  5. Sélectionner Ajout de groupes de champs

    Ajouter un nouveau groupe de champs

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

  1. Sélectionner + en regard du nom du schéma. Cela ajoute un nouveau champ sous votre espace de noms d’ID de client pour gérer les conflits entre vos champs personnalisés et tous les champs standard.

  2. Dans la boîte de dialogue Propriétés de champ sidebar ajoute les détails du nouveau champ :

    1. Nom du champ: systemIdentifier
    2. Nom d’affichage: System Identifier
    3. Type: Objet
    4. Sélectionner Appliquer

    Ajouter un nouveau groupe de champs

Ajoutez maintenant deux champs sous systemIdentifier objet :

  1. Premier champ
    1. Nom du champ: loyaltyId
    2. Nom d’affichage: Loyalty Id
    3. Type: Chaîne
  2. Deuxième 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 l’option 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

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

Le type de données est une autre construction à plusieurs champs qui peut être réutilisée dans les schémas. sur plusieurs classes. Nous allons convertir notre nouvelle systemIdentifier dans un type de données :

Avec la Luma Loyalty Schema toujours ouvert, sélectionnez l’option systemIdentifier et sélectionnez Conversion en nouveau type de données

Groupe de champs de fidélité Terminé

Si vous Annuler hors du schéma et accédez à la section Types de données , vous verrez votre nouveau type de données. Nous utiliserons ce type de données plus loin dans la leçon.

Groupe de champs de fidélité Terminé

Créer un schéma CRM via l’API

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

CONSEIL

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. Utilisez la Profil individuel XDM classe
  2. Nommer Luma CRM Schema
  3. Utilisez les groupes de champs suivants : Détails démographiques, Coordonnées personnelles et groupe de champs de profil Identité Luma

Nous allons d'abord créer le schéma vide :

  1. Ouvrir Postman

  2. Si vous n’avez pas fait de demande au cours des dernières 24 heures, vos jetons d’autorisation ont probablement expiré. Ouvrir la demande Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token et sélectionnez Envoyer pour demander de nouveaux jetons JWT et d'accès.

  3. Ouvrez vos variables d’environnement et modifiez la valeur de CONTAINER_ID de global à tenant. N’oubliez pas que vous devez utiliser tenant lorsque vous souhaitez interagir avec vos propres éléments personnalisés dans la plate-forme, par exemple en créant un schéma.

  4. Sélectionnez Enregistrer
    Remplacer l’ID_CONTENEUR par un ID de client

  5. Ouvrir la demande Schema Registry API > Schemas > Create a new custom schema.

  6. Ouvrez la Corps puis collez le code suivant et sélectionnez Envoyer pour effectuer l’appel d’API. Cet appel crée un nouveau schéma utilisant le même XDM Individual Profile classe de base :

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    REMARQUE

    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), peut être obtenu en utilisant des appels d’API de liste avec le CONTAINER_ID et acceptez le paramètre header défini sur les valeurs correctes. Certaines sont également facilement accessibles dans l’interface utilisateur.

  7. Vous devriez avoir un 201 Created réponse

  8. Copier 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

REMARQUE

Le meta:altId ou ID de schéma peut également être obtenu en faisant une demande d’API. Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. avec la CONTAINER_ID défini sur tenant et un en-tête d’acceptation application/vnd.adobe.xdm+json.

CONSEIL

Problèmes courants avec cet appel et correctifs probables :

  • Aucun jeton d’authentification : Exécutez la IMS : JWT Generate + Auth via User Token appel pour générer de nouveaux jetons
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Mettez à jour la CONTAINER_ID variable d'environnement à partir de global à tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: Vérifiez vos autorisations utilisateur dans le Admin Console

Ajout de groupes de champs standard

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

  1. Entrée Postman, Ouvrez la demande. Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. Dans la boîte de dialogue Params , collez le meta:altId valeur 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 d’API. Cet appel ajoute les groupes de champs standard à votre Luma CRM Schema:

    [{
        "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 devez 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és

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

  1. Ouvrir la demande Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Sélectionnez l’option Envoyer pour récupérer la liste de tous les groupes de champs personnalisés de votre compte

  3. Saisissez la $id de la Luma Identity profile field group (la vôtre sera différente de la valeur de cette capture d’écran)
    Récupérer la liste des groupes de champs

  4. Ouvrir la demande Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. encore

  5. Le Params doit toujours avoir la $id de votre schéma

  6. Ouvrez la Corps et collez le code suivant, en remplaçant le $ref avec la valeur $id de votre Luma Identity profile field group:

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. Sélectionner Envoyer

    Ajout du groupe Champ 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

Nous allons maintenant créer un schéma basé sur le XDM ExperienceEvent pour les données d’achat hors ligne de Luma. Comme vous connaissez maintenant l’interface utilisateur de l’éditeur de schéma, je réduis le nombre de captures d’écran dans les instructions :

  1. Créez un schéma avec le noeud XDM ExperienceEvent classe
  2. Ajouter le groupe de champs standard Détails du commerce pour capturer les détails d’ordre commun. Passez quelques minutes à explorer les objets à l'intérieur.
  3. Recherchez Luma Identity profile field group. Il n'est pas disponible ! N'oubliez pas que les groupes de champs sont liés à une classe, et comme nous utilisons une classe différente 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 très facile !
  4. Sélectionnez l’option Créer un nouveau groupe de champs bouton radio
  5. Saisissez la Nom d’affichage comme Luma Identity ExperienceEvent field group et sélectionnez l’option Ajout de groupes de champs bouton
  6. Assurez-vous que la + s’affichent dans la Structure pour ajouter de nouveaux champs
  7. Entrée Structure , sélectionnez + au niveau supérieur du schéma
  8. En tant que Nom du champ, entrez systemIdentifier
  9. En tant que Nom d’affichage, entrez System Identifier
  10. En tant que Type, sélectionnez Identifiant du système qui est le type de données personnalisé que vous avez créé précédemment
  11. Sélectionnez l’option Appliquer bouton
  12. Nommer votre schéma Luma Offline Purchase Events Schema
  13. Sélectionnez l’option Enregistrer bouton

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

Ajout du type de données au groupe de champs

Sélectionnez également XDM ExperienceEvent sous Classe en tête et inspecter certains des champs fournis par cette classe. Notez que les champs _id et timestamp sont obligatoires lors de l’utilisation de la classe XDM ExperienceEvent : ces champs doivent être renseignés pour chaque enregistrement que vous assimilez lors de l’utilisation de ce schéma :

Structure de base des événements d'expérience

Créer 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. À ce stade, vous devriez être un expert dans la création de schémas ! Générez le schéma suivant avec ces propriétés

Propriété Valeur
Classe XDM ExperienceEvent
Groupe de champs Mixin d’événements ExperienceEvent du SDK Web AEP
Groupe de champs Événement Expérience Consommateur
Nom du schéma Schéma d'événements web Luma

Sélectionnez l’option Événement Expérience Consommateur groupe de champs. Ce groupe de champs contient les objets commerce et productListItems qui se trouvaient également dans Détails du commerce. En effet Événement Expérience Consommateur est une combinaison de plusieurs autres groupes de champs standard qui sont également disponibles séparément. Mixin d’événements ExperienceEvent du SDK Web AEP Le groupe de champs contient également d’autres groupes de champs, y compris certains des mêmes dans Événement Expérience Consommateur. Heureusement, ils se mélangent harmonieusement.

Notez que nous n'avons pas ajouté le Luma Identity ExperienceEvent field group à ce schéma. Ceci est dû au fait que le SDK Web a une façon différente de collecter les identités. Si vous sélectionnez l’option XDM ExperienceEvent dans la Composition dans 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 d’Adobe pour créer des liens vers la plate-forme. Vous verrez comment les identités sont envoyées à la plate-forme via identityMap dans la leçon d'assimilation en flux continu.

Créer un schéma de catalogue de produits

En utilisant la Détails du commerce et Événement Expérience Consommateur groupes de champs, Luma signale certains détails d’événements liés au produit via le type de données productListItems standard. Mais ils disposent également de champs de détails de produit supplémentaires qu’ils souhaitent envoyer à la plate-forme. Au lieu de capturer tous ces champs dans leurs systèmes de point de vente et de commerce électronique, Luma préférerait assimiler ces champs directement à partir de son système de catalogues de produits. Une "relation de schéma" vous permet de définir une relation entre deux schémas aux fins de classification ou de recherche. Luma utilisera une relation pour classer les détails de son produit. Nous allons commencer le processus maintenant et le terminer à la fin de la prochaine leçon.

REMARQUE

Si vous êtes un client Analytics ou Target existant, la classification des entités avec des relations de schéma est analogue aux classifications de SAINTS ou au chargement de votre catalogue de produits pour Recommendations

Nous devons d'abord créer un schéma pour le catalogue de produits Luma à l'aide d'une classe personnalisée :

  1. Sélectionnez l’option Créer un schéma et sélectionnez Parcourir dans la liste déroulante
    Créer un nouveau schéma
  2. Sélectionnez l’option Créer une classe bouton radio
  3. Nommer Luma Product Catalog Class
  4. Laissez le bouton Comportement comme Enregistrer
  5. Sélectionnez l’option Affecter une classe bouton
    Créer une nouvelle classe
  6. Créer 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 produit : Chaîne
    3. productColor : Couleur du produit : Chaîne
    4. productSku : UGS du produit : Chaîne | Obligatoire
    5. productSize : Taille du produit : Chaîne
    6. productPrice : Prix du produit : Double
  7. Nommer le schéma Luma Product Catalog Schema (veillez à mettre à jour le champ correct et non à mettre à jour le nom de la classe)
  8. ​Enregistrement du schéma

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

L’étape suivante consiste à définir la relation entre les deux schémas ExperienceEvent et la Luma Product Catalog Schemacependant, il y a quelques mesures supplémentaires que nous devons prendre dans la prochaine leçon avant de pouvoir faire cela.

Ressources supplémentaires

Maintenant que vous avez vos schémas, vous pouvez identités de mappage!

Sur cette page