Créez un schéma à l’aide de Schema Editor

L’interface utilisateur de Adobe Experience Platform vous permet de créer et de gérer des schémas Experience Data Model (XDM) dans une zone de travail visuelle interactive appelée Schema Editor. Ce tutoriel explique comment créer un schéma à l’aide de Schema Editor.

Si vous préférez composer un schéma à l’aide de l’API Schema Registry, commencez par lire le Schema Registry guide de développement avant de lancer le tutoriel sur la création d’un schéma à l’aide de l’API.

Prise en main

Ce tutoriel nécessite une compréhension pratique des différents aspects de Adobe Experience Platform impliqués dans la création de schémas. Avant de commencer ce tutoriel, veuillez consulter la documentation relative aux concepts suivants :

• Experience Data Model (XDM) : cadre normalisé selon lequel Platform organise les données de l’expérience client.
  • Principes de base de la composition des schémas : Présentation des schémas XDM et de leurs blocs de création, notamment les classes, les groupes de champs de schéma, les types de données et les champs individuels.
• Real-time Customer Profile : fournit un profil client en temps réel unifié basé sur des données agrégées issues de plusieurs sources.

Ouvrez l’espace de travail Schémas .

L’espace de travail Schémas de l’interface utilisateur Platform fournit une visualisation de Schema Library, ce qui vous permet d’afficher la gestion des schémas disponibles pour votre organisation. L’espace de travail comprend également la zone de travail Schema Editor, sur laquelle vous pouvez composer un schéma tout au long de ce tutoriel.

Après vous être connecté à Experience Platform, sélectionnez Schémas dans le volet de navigation de gauche pour ouvrir l’espace de travail Schémas. L’onglet Parcourir affiche une liste de schémas (une représentation de Schema Library) que vous pouvez afficher et personnaliser. La liste comprend le nom, le type, la classe et le comportement (enregistrement ou série chronologique) sur lesquels repose le schéma, ainsi que la date et l’heure de la dernière modification du schéma.

Pour plus d’informations, consultez le guide sur l’exploration des ressources XDM existantes dans l’interface utilisateur .

Création et attribution d’un nom à un schéma

Pour commencer à composer un schéma, sélectionnez Créer un schéma dans le coin supérieur droit de l’espace de travail Schémas. Un menu déroulant s’affiche, vous permettant de choisir entre les classes de base XDM Individual Profile et XDM ExperienceEvent. Si ces classes ne répondent pas à vos besoins, vous pouvez également sélectionner Parcourir pour choisir parmi d’autres classes disponibles ou créer une nouvelle classe.

Pour les besoins de ce tutoriel, sélectionnez XDM Individual Profile.

Puisque vous avez choisi une classe XDM standard sur laquelle baser le schéma, la boîte de dialogue Ajouter un groupe de champs s’affiche, ce qui vous permet de commencer immédiatement à ajouter des champs au schéma. Pour l’instant, sélectionnez Annuler pour quitter la boîte de dialogue.

Schema Editor s’affiche. C’est le canevas sur lequel vous allez composer votre schéma. Un schéma sans titre est automatiquement créé dans la section Structure du canevas lorsque vous arrivez dans l’éditeur, avec les champs standard inclus dans tous les schémas en fonction de cette classe. La classe affectée au schéma est également répertoriée sous Classe dans la section Composition .

Utilisez les champs situés à droite de l’éditeur pour fournir un nom d’affichage et une description facultative du schéma. Une fois qu’un nom est saisi, le canevas se met à jour pour tenir compte du nouveau nom du schéma.

Plusieurs éléments importants doivent être pris en compte lors du choix d’un nom pour votre schéma :

• Les noms des schémas doivent être courts et descriptifs afin que le schéma puisse être facilement retrouvé ultérieurement.
• Le nom d’un schéma doit être unique, ce qui signifie qu’il doit également être suffisamment précis pour ne pas être réutilisé à l’avenir. Par exemple, si votre organisation dispose de programmes de fidélité distincts pour différentes marques, nous vous conseillons de nommer votre schéma « Brand A Loyalty Members » pour faciliter la distinction avec d’autres schémas relatifs à la fidélité que vous pourriez définir ultérieurement.
• Vous pouvez également utiliser la description du schéma pour fournir toute information contextuelle supplémentaire concernant le schéma.

Ce tutoriel compose un schéma pour ingérer des données relatives aux membres d’un programme de fidélité. Par conséquent, le schéma est appelé "Loyalty Members".

Ajouter un groupe de champs

Vous pouvez maintenant commencer à ajouter des champs à votre schéma en ajoutant des groupes de champs. Un groupe de champs est un groupe d’un ou de plusieurs champs souvent utilisés conjointement pour décrire un concept particulier. Ce tutoriel utilise des groupes de champs pour décrire les membres du programme de fidélité et recueillir des informations clés telles que le nom, l’anniversaire, le numéro de téléphone, l’adresse, etc.

Pour ajouter un groupe de champs, sélectionnez Ajouter dans la sous-section Groupes de champs .

Une nouvelle boîte de dialogue s’affiche, affichant une liste des groupes de champs disponibles. Chaque groupe de champs est destiné uniquement à une utilisation avec une classe spécifique. Par conséquent, la boîte de dialogue répertorie uniquement les groupes de champs compatibles avec la classe que vous avez sélectionnée (dans ce cas, la classe XDM Individual Profile ). Si vous utilisez une classe XDM standard, la liste des groupes de champs sera triée intelligemment en fonction de la popularité de l’utilisation.

Si vous sélectionnez un groupe de champs dans la liste, il s’affiche dans le rail de droite. Vous pouvez sélectionner plusieurs groupes de champs si vous le souhaitez, en ajoutant chacun d’eux à la liste dans le rail de droite avant de le confirmer. En outre, une icône s’affiche sur le côté droit du groupe de champs actuellement sélectionné, ce qui permet de prévisualiser la structure des champs qu’il fournit.

Lors de la prévisualisation d’un groupe de champs, une description détaillée du schéma du groupe de champs est fournie dans le rail droit. Vous pouvez également parcourir les champs du groupe de champs dans la zone de travail fournie. Lorsque vous sélectionnez différents champs, le rail de droite se met à jour pour afficher les détails du champ en question. Sélectionnez Précédent lorsque vous avez terminé la prévisualisation pour revenir à la boîte de dialogue de sélection du groupe de champs.

Pour ce tutoriel, sélectionnez le groupe de champs Détails démographiques, puis sélectionnez Ajouter un groupe de champs.

Le canevas du schéma réapparaît. La section Groupes de champs répertorie désormais "Détails démographiques" et la section Structure inclut les champs fournis par le groupe de champs. Vous pouvez sélectionner le nom du groupe de champs sous la section Groupes de champs pour mettre en surbrillance les champs spécifiques qu’il fournit dans la zone de travail.

Ce groupe de champs fournit plusieurs champs sous le nom de niveau supérieur person avec le type de données "Personne". Ce groupe de champs décrit les informations sur un individu, notamment son nom, sa date de naissance et son genre.

Notez que le champ name possède un type de données "Nom de personne", ce qui signifie qu’il décrit également un concept commun et contient des sous-champs liés au nom, tels que le prénom, le nom, le titre de politesse et le suffixe.

Sélectionnez les différents champs de la zone de travail pour afficher les champs supplémentaires qui contribuent à la structure du schéma.

Ajouter un autre groupe de champs

Vous pouvez maintenant répéter les mêmes étapes pour ajouter un autre groupe de champs. Lorsque vous affichez cette fois la boîte de dialogue Ajouter un groupe de champs, notez que le groupe de champs "Détails démographiques" a été grisé et que la case à cocher à côté de celui-ci ne peut pas être sélectionnée. Cela vous évite de dupliquer accidentellement des groupes de champs que vous avez déjà inclus dans le schéma actuel.

Pour ce tutoriel, sélectionnez le groupe de champs "Personal Contact Details" dans la boîte de dialogue, puis sélectionnez Ajouter un groupe de champs pour l’ajouter au schéma.

Une fois ajouté, le canevas réapparaît. "Détails du contact personnel" est désormais répertorié sous Groupes de champs dans la section Composition. Des champs pour l’adresse du domicile, le téléphone mobile et d’autres ont été ajoutés sous Structure.

Tout comme le champ name, les champs que vous venez d’ajouter représentent des concepts à plusieurs champs. Par exemple, homeAddress possède un type de données "Adresse postale" et mobilePhone un type de données "Numéro de téléphone". Vous pouvez sélectionner chacun de ces champs pour les développer et afficher les champs supplémentaires inclus dans le type de données.

Définition d’un groupe de champs personnalisé

Le schéma "Loyalty Members" est destiné à capturer les données relatives aux membres d’un programme de fidélité. Il nécessite donc des champs spécifiques liés à la fidélité.

Il existe un groupe de champs Loyalty Details standard que vous pouvez ajouter au schéma pour capturer les champs communs liés à un programme de fidélité. Bien qu’il soit vivement conseillé d’utiliser des groupes de champs standard pour représenter les concepts capturés par vos schémas, la structure du groupe de champs de fidélité standard peut ne pas être en mesure de capturer toutes les données pertinentes pour votre programme de fidélité spécifique. Dans ce scénario, vous pouvez choisir de définir un nouveau groupe de champs personnalisé pour capturer ces champs à la place.

Ouvrez à nouveau la boîte de dialogue Ajouter le groupe de champs, mais cette fois, sélectionnez Créer un groupe de champs près de la partie supérieure. Vous êtes alors invité à fournir un nom d’affichage et une description pour votre groupe de champs.

Comme pour les noms de classe, le nom du groupe de champs doit être court et simple, décrivant ce que le groupe de champs va apporter au schéma. Ces noms sont également uniques. Vous ne pourrez donc pas réutiliser le nom et devrez donc veiller à ce qu’il soit suffisamment spécifique.

Pour ce tutoriel, nommez le nouveau groupe de champs "Loyalty Details".

Sélectionnez Ajouter un groupe de champs pour revenir à Schema Editor. "Loyalty Details" doit maintenant apparaître sous Groupes de champs sur le côté gauche du canevas, mais aucun champ n’y est encore associé et, par conséquent, aucun nouveau champ n’apparaît sous Structure.

Ajouter des champs au groupe de champs

Maintenant que vous avez créé le groupe de champs "Loyalty Details", il est temps de définir les champs que le groupe de champs va ajouter au schéma.

Pour commencer, sélectionnez le nom du groupe de champs dans la section Groupes de champs . Une fois que vous avez effectué cette opération, les propriétés du groupe de champs s’affichent sur le côté droit de l’éditeur, tandis qu’une icône plus (+) apparaît en regard du nom du schéma sous Structure.

Sélectionnez l’icône plus (+) en regard de "Loyalty Members" pour créer un noeud dans la structure. Ce noeud (appelé _tenantId dans cet exemple) représente l’identifiant du client de votre organisation IMS, précédé d’un trait de soulignement. La présence de l’identifiant du client indique que les champs que vous ajoutez sont contenus dans l’espace de noms de votre organisation.

En d’autres termes, les champs que vous ajoutez sont propres à votre organisation et vont être enregistrés dans la balise Schema Registry d’une zone spécifique accessible uniquement à votre organisation. Les champs que vous définissez doivent toujours être ajoutés à votre espace de noms client pour empêcher les collisions avec des noms provenant d’autres classes, groupes de champs, types de données et champs standard.

À l’intérieur de ce noeud avec espace de noms se trouve un "Nouveau champ". Il s’agit du début du groupe de champs "Loyalty Details".

En utilisant les contrôles sur le côté droit de l’éditeur, commencez par créer un champ loyalty de type "Objet" qui sera utilisé pour contenir vos champs liés à la fidélité. Lorsque vous avez terminé, sélectionnez Appliquer.

Les modifications sont appliquées et l’objet loyalty nouvellement créé s’affiche. Sélectionnez l’icône plus (+) en regard de l’objet pour ajouter des champs supplémentaires liés à la fidélité. Un "Nouveau champ" apparaît et la section Propriétés du champ est visible sur le côté droit du canevas.

Chaque champ nécessite les informations suivantes :

• Nom du champ : nom du champ, écrit en majuscules. Exemple : loyaltyLevel
• Nom d’affichage : nom du champ, écrit en majuscules du titre. Exemple : Loyalty Level
• Type : type de données du champ. Cela inclut les types scalaires de base et tous les types de données définis dans la balise Schema Registry. Exemples : Chaîne, Entier, Booléen, Personne, Adresse, Numéro de téléphone, etc.
• Description : une description facultative du champ doit être incluse, écrite en majuscules, avec un maximum de 200 caractères.

Le premier champ de l’objet Loyalty sera une chaîne appelée loyaltyId. Lorsque vous définissez le type du nouveau champ sur "Chaîne", la section Propriétés du champ est renseignée avec plusieurs options pour appliquer des contraintes, y compris la valeur par défaut, le format et la longueur maximale.

Différentes options de contraintes sont disponibles selon le type de données sélectionné. Comme loyaltyId sera une adresse électronique, sélectionnez "email" dans le menu déroulant Format. Sélectionnez Appliquer pour appliquer vos modifications.

Ajouter d’autres champs au groupe de champs

Maintenant que vous avez ajouté le champ loyaltyId , vous pouvez ajouter des champs supplémentaires pour capturer des informations relatives à la fidélité, telles que :

• Points (entier)
• Member-since (date)

Pour ajouter chaque champ au schéma, sélectionnez l’icône plus (+) en regard de l’objet loyalty et renseignez les informations requises.

Une fois l’opération terminée, l’objet Loyalty contient des champs pour l’identifiant de fidélité, les points et le membre depuis.

Ajouter un champ d’énumération au groupe de champs

Lors de la définition de champs dans la balise Schema Editor, vous pouvez appliquer d’autres options aux types de champs de base afin de limiter davantage les données que le champ peut contenir. Les cas d’utilisation de ces contraintes sont expliqués dans le tableau suivant :

Pour ce tutoriel, l’objet “loyalty” du schéma nécessite un nouveau champ d’énumération qui décrit le “niveau de fidélité” d’un client, où la valeur ne peut être que l’une des quatre options possibles. Pour ajouter ce champ au schéma, sélectionnez l’icône plus (+) en regard de l’objet loyalty et renseignez les champs requis pour Nom du champ et Nom d’affichage. Pour Type, sélectionnez “Chaîne”.

D’autres cases à cocher s’affichent pour le champ une fois son type sélectionné, notamment les cases à cocher pour Tableau, Énumération et Identité.

Cochez la case Énumération pour ouvrir la section Valeurs d’énumération ci-dessous. Ici, vous pouvez saisir la valeur (en Camel Case) et le libellé (nom facultatif et facile à lire écrit en Title Case) pour chaque niveau de fidélité acceptable.

Une fois toutes les propriétés du champ renseignées, sélectionnez Appliquer pour ajouter le champ "loyaltyLevel" à l’objet loyalty.

Conversion d’un objet à plusieurs champs en un type de données

L’objet loyalty contient désormais plusieurs champs spécifiques à la fidélité et représente une structure de données commune qui pourrait s’avérer utile dans d’autres schémas. Schema Editor vous permet d’appliquer facilement des objets à champs multiples réutilisables en convertissant la structure de ces objets en types de données.

Les types de données permettent l’utilisation cohérente de structures à champs multiples et offrent plus de flexibilité qu’un groupe de champs, car ils peuvent être utilisés n’importe où dans un schéma. Pour ce faire, définissez la valeur Type du champ sur celle de tout type de données défini dans la balise Schema Registry.

Pour convertir l’objet loyalty en type de données, sélectionnez le champ loyalty sous Structure, puis sélectionnez Convertir en nouveau type de données sur le côté droit de l’éditeur sous Propriétés du champ. Une fenêtre contextuelle verte s’affiche, confirmant que la conversion de l’objet a réussi.

Désormais, lorsque vous observez sous Structure, vous pouvez constater que le champ loyalty possède un type de données "Loyalty" et que les champs sont accompagnés de petites icônes de verrouillage indiquant qu’ils ne sont plus des champs individuels mais qu’ils font plutôt partie d’un type de données à plusieurs champs.

Dans un prochain schéma, vous pourrez désormais attribuer un champ de type "Loyalty" et il comprendra automatiquement des champs pour l’identifiant, le niveau de fidélité, le membre depuis et les points.

Recherche et filtrage des champs de schéma

Votre schéma contient désormais plusieurs groupes de champs en plus des champs fournis par sa classe de base. Lorsque vous utilisez des schémas plus volumineux, vous pouvez cocher les cases en regard des noms des groupes de champs dans le rail de gauche pour filtrer les champs affichés uniquement par rapport aux groupes de champs qui vous intéressent.

Si vous recherchez un champ spécifique dans votre schéma, vous pouvez également utiliser la barre de recherche pour filtrer les champs affichés par nom, quel que soit le groupe de champs sous lequel ils sont fournis.

Définition d’un champ de schéma comme champ d’identité

La structure de données standard fournie par les schémas peut être utilisée pour identifier les données appartenant à la même personne sur plusieurs sources, ce qui permet d’utiliser divers cas d’utilisation en aval, tels que la segmentation, la création de rapports, l’analyse de la science des données, etc. Pour regrouper les données en fonction des identités individuelles, les champs clés doivent être marqués comme des champs Identité dans les schémas applicables.

Experience Platform permet de désigner facilement un champ d’identité à l’aide d’une case à cocher ​​Identité dans Schema Editor. Cependant, vous devez déterminer quel champ est le meilleur candidat à utiliser comme identité, en fonction de la nature de vos données.

Par exemple, il peut y avoir des milliers de membres du programme de fidélité appartenant au même "niveau de fidélité", mais chaque membre du programme de fidélité a une loyaltyId unique (qui dans ce cas est l’adresse électronique du membre individuel). Le fait que loyaltyId soit un identifiant unique pour chaque membre en fait un bon candidat pour un champ d’identité, contrairement à loyaltyLevel.

Dans la section Structure de l’éditeur, sélectionnez le champ loyaltyId et la case Identité apparaît sous Propriétés du champ. Cochez la case et l’option permettant de définir cette valeur comme identité Principal apparaît. Cochez également cette case.

Ensuite, vous devez fournir un espace de noms d’identité à partir de la liste des espaces de noms prédéfinis dans la liste déroulante. Comme loyaltyId est l’adresse électronique du client, sélectionnez "Email" dans la liste déroulante. Sélectionnez Appliquer pour confirmer les mises à jour du champ loyaltyId.

Après avoir appliqué la modification, l’icône loyaltyId affiche un symbole d’empreinte digitale, indiquant qu’il s’agit désormais d’un champ d’identité.

Désormais, toutes les données ingérées dans le champ loyaltyId seront utilisées pour aider à identifier cet individu et à assembler une vue unique de ce client. Pour en savoir plus sur l’utilisation des identités dans Experience Platform, consultez la documentation Identity Service .

Activer le schéma à utiliser dans Real-time Customer Profile

Real-time Customer Profile tire parti des données d’identité dans Experience Platform pour fournir une vue d’ensemble de chaque client. Le service crée des profils robustes de 360° d’attributs du client ainsi que des comptes horodatés de chaque interaction que les clients ont eue sur n’importe quel système intégré à Experience Platform.

Pour qu’un schéma puisse être utilisé avec Real-time Customer Profile, il doit avoir une identité Principale définie. Vous recevrez un message d’erreur si vous tentez d’activer un schéma sans d’abord définir une identité Principale.

Pour activer le schéma "Loyalty Members" à utiliser dans Profile, commencez par sélectionner "Loyalty Members" dans la section Structure de l’éditeur.

Dans la partie droite de l’éditeur, des informations sur le schéma sont affichées, notamment son nom d’affichage, sa description et son type. Outre ces informations, il existe un bouton de basculement Profil.

Sélectionnez Profil et une fenêtre contextuelle s’affiche, vous demandant de confirmer que vous souhaitez activer le schéma pour Profile.

Sélectionnez Activer pour confirmer votre choix. Vous pouvez sélectionner à nouveau le bouton d’activation/désactivation Profil pour désactiver le schéma si vous le souhaitez, mais une fois le schéma enregistré alors que Profile est activé, il ne peut plus être désactivé.

Étapes suivantes et ressources supplémentaires

Maintenant que vous avez fini de composer le schéma, vous pouvez voir le schéma complet dans la zone de travail. Sélectionnez Enregistrer et le schéma sera enregistré dans la balise Schema Library, ce qui le rendra accessible par la balise Schema Registry.

Votre nouveau schéma peut désormais être utilisé pour ingérer des données dans Platform. Pour rappel, une fois que le schéma a été utilisé pour ingérer des données, seules des modifications additives peuvent être apportées. Reportez-vous aux principes de base de la composition des schémas pour plus d’informations sur le contrôle de version des schémas.

Vous pouvez maintenant suivre le tutoriel sur la définition d’une relation de schéma dans l’interface utilisateur pour ajouter un nouveau champ de relation au schéma "Loyalty Members".

Le schéma "Loyalty Members" peut également être visualisé et géré à l’aide de l’API Schema Registry. Pour commencer à utiliser l’API, lisez d’abord le Schema Registry API guide de développement.

Ressources vidéo

La vidéo suivante montre comment créer un schéma simple dans l’interface utilisateur Platform.

La vidéo suivante est destinée à vous aider à mieux comprendre l’utilisation des groupes et classes de terrain.

Annexe

Les sections suivantes fournissent des informations supplémentaires sur l’utilisation de Schema Editor.

Création d’une nouvelle classe

Experience Platform offre la possibilité de définir un schéma basé sur une classe propre à votre organisation. Pour savoir comment créer une classe, consultez le guide sur la création et la modification des classes dans l’interface utilisateur.

Modification de la classe d’un schéma

Vous pouvez modifier la classe d’un schéma à tout moment pendant le processus de composition initial avant l’enregistrement du schéma.

Pour savoir comment modifier la classe d’un schéma, consultez le guide sur la gestion des schémas dans l’interface utilisateur.