Créer un schéma à l’aide de l’Schema Editor
L’interface utilisateur d’Adobe Experience Platform vous permet de créer et de gérer des schémas de Experience Data Model (XDM) dans une zone de travail visuelle interactive appelée l’Schema Editor. Ce tutoriel explique comment créer un schéma à l’aide de l’Schema Editor.
À des fins de démonstration, les étapes de ce tutoriel concernent la création d’un exemple de schéma qui décrit les membres d’un programme de fidélité des clients. Vous pouvez utiliser ces étapes pour créer un schéma différent pour vos propres besoins. Cependant, il est recommandé de suivre d’abord la création de l’exemple de schéma pour découvrir les fonctionnalités de l’Schema Editor.
Prise en main
Ce tutoriel demande une bonne compréhension des différents aspects d’Adobe Experience Platform relatifs à 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 de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.
Ouvrez l’espace de travail des schémas browse
L’espace de travail des schémas dans l’interface utilisateur de Platform offre une visualisation de la Schema Library, ce qui vous permet d’afficher et de gérer les schémas disponibles pour votre organisation. L’espace de travail comprend également l’Schema Editor, la zone de travail sur laquelle vous allez composer un schéma tout au long de ce tutoriel.
Connectez-vous à Experience Platform et sélectionnez Schémas dans le volet de navigation de gauche pour ouvrir l’espace de travail des 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.
Reportez-vous au guide sur l’exploration des ressources XDM existantes dans l’interface utilisateur pour plus d’informations.
Création et attribution d’un nom à un schéma create
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.
Le workflow Créer un schéma s’affiche. Choisissez ensuite une classe de base pour le schéma. Vous pouvez choisir entre les classes principales de XDM Individual Profile et XDM ExperienceEvent, ou Other si ces classes ne répondent pas à vos besoins. L’option Other classes vous permet de créer une nouvelle classe ou de choisir parmi d’autres classes préexistantes.
Pour plus d’informations sur ces classes, consultez la documentation XDM Individual profile et XDM ExperienceEvent . Pour les besoins de ce tutoriel, sélectionnez XDM Individual Profile suivi de Next.
Une fois que vous avez sélectionné une classe, la section Nom et révision s’affiche. Dans cette section, vous fournissez un nom et une description pour identifier votre schéma. Plusieurs éléments importants doivent être pris en compte lors du choix d’un nom pour votre schéma :
- Le nom d’un schéma doit être court et descriptif afin qu’il puisse être facilement retrouvé par la suite.
- 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 le concernant.
Ce tutoriel décrit la composition d’un schéma pour ingérer les données relatives aux membres d’un programme de fidélité, c’est pourquoi le schéma est nommé « Loyalty Members ».
La structure de base du schéma (fournie par la classe) s’affiche dans la zone de travail pour que vous puissiez examiner et vérifier la classe et la structure de schéma sélectionnés.
Saisissez un nom d’affichage de schéma convivial dans le champ de texte. Saisissez ensuite une description appropriée pour vous aider à identifier votre schéma. Une fois la structure de votre schéma revue et vos paramètres satisfaits, sélectionnez Terminer pour créer votre schéma.
L’Schema Editor apparaît. C’est la zone de travail sur laquelle vous allez composer votre schéma. Le schéma autointitulé est automatiquement créé dans la section Structure du canevas lorsque vous arrivez dans l’éditeur, avec les champs standard inclus dans la classe de base que vous avez sélectionnée. La classe affectée pour le schéma est également répertoriée sous Classe dans la section Composition.
Ajouter un groupe de champs field-group
Vous pouvez maintenant commencer à ajouter des champs à votre schéma grâce à l’ajout de groupes de schémas. 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, la date d’anniversaire, le numéro de téléphone, l’adresse, etc.
Pour ajouter un groupe de champs, cliquez sur Ajouter dans la sous-section Groupes de champs.
Une nouvelle boîte de dialogue apparait. Elle présente la liste des groupes de champs disponibles. Chaque groupe de champs est uniquement destiné à une utilisation avec une classe spécifique. Par conséquent, la boîte de dialogue ne répertorie que 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.
Vous pouvez utiliser l’un des filtres dans le rail de gauche pour limiter la liste des groupes de champs standard à des secteurs comme la vente au détail, les services financiers et les services de santé.
Lorsqu’un groupe de champs est sélectionné dans la liste, il s’affiche dans le rail de droite. Si vous le souhaitez, vous pouvez sélectionner plusieurs groupes de champs en les ajoutant chacun à la liste dans le rail de droite avant de confirmer la sélection. En outre, l’icône qui s’affiche sur le côté droit du groupe de champs sélectionné vous permet de prévisualiser la structure des champs qu’il présente.
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. 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 Retour lorsque vous avez terminé la prévisualisation pour retourner à 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 cliquez sur Ajouter un groupe de champs.
La zone de travail 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 complet », ce qui signifie qu’il décrit lui aussi un concept commun et contient des sous-champs liés au nom, tels que le prénom, le nom de famille, le titre de courtoisie et le suffixe.
Sélectionnez les différents champs dans la zone de travail pour afficher les champs supplémentaires contribuant à la structure du schéma.
Ajouter d’autres groupes de champs field-group-2
Vous pouvez maintenant répéter les mêmes étapes pour ajouter un autre groupe de champs. Lorsque la boîte de dialogue Ajouter un groupe de champs s’affiche cette fois-ci, vous remarquerez que les « Details démographiques » sont grisés et que la case à cocher adjacente 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 les groupes de champs standard Coordonnées personnelles et Détails de fidélité dans la liste, puis sélectionnez Ajouter des groupes de champs pour les ajouter au schéma.
La zone de travail réapparaît avec les groupes de champs ajoutés sous Groupes de champs dans la section Composition et leurs champs composites ajoutés à la structure du schéma.
Définir un groupe de champs personnalisé define-field-group
Le schéma Membres du programme de fidélité est destiné à capturer des données relatives aux membres d’un programme de fidélité. Le groupe de champs standard Détails de fidélité que vous avez ajouté au schéma fournit la plupart de ces informations, notamment le type de programme, les points, la date d’inscription, etc.
Cependant, il peut arriver que vous souhaitiez inclure d’autres champs personnalisés non couverts par des groupes de champs standard afin d’atteindre vos cas d’utilisation. Dans le cas de l’ajout de champs de fidélité personnalisés, vous disposez de deux options :
- Créer un groupe de champs personnalisé pour capturer ces champs. Il s’agit de la méthode qui sera abordée dans ce tutoriel.
- Étendre le groupe de champs standard Détails de fidélité avec des champs personnalisés. Cela entraîne la conversion de Détails de fidélité en un groupe de champs personnalisés et le groupe de champs standard d’origine ne sera plus disponible. Consultez le Guide de l’interface utilisateur des Schémas pour plus d’informations sur l’ajout de champs personnalisés à la structure des groupes de champs standard.
Pour créer un groupe de champs, sélectionnez Ajouter dans la sous-section Groupes de champs comme avant, mais cette fois, sélectionnez Créer un nouveau groupe de champs dans la partie supérieure de la boîte de dialogue qui s’affiche. Vous êtes alors invité à fournir un nom d’affichage et une description pour le nouveau groupe de champs. Pour ce tutoriel, nommez le nouveau groupe de champs « Custom Loyalty Details », puis sélectionnez Ajouter des groupes de champs.
« Custom Loyalty Details » devrait maintenant apparaître sous Groupes de champs sur le côté gauche de la zone de travail, 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 field-group-fields
Maintenant que vous avez créé le groupe de champs « Custom Loyalty Details », il est temps de définir les champs que le groupe de champs va ajouter au schéma.
Pour commencer, sélectionnez l’icône plus (+) située à côté du nom du schéma dans la zone de travail.
Un espace reservé « Champ sans titre » apparaît dans la zone de travail, et le rail de droite se met à jour pour afficher les options de configuration du champ.
Dans ce scénario, le schéma doit comporter un champ de type objet qui décrit en détail le niveau de fidélité actuel de la personne. À l’aide des commandes du rail de droite, commencez à créer un champ loyaltyTier
de type « Objet » qui sera utilisé pour contenir vos champs associés.
Sous Attribuer à, vous devez sélectionner un groupe de champs auquel affecter le champ. N’oubliez pas que tous les champs de schéma appartiennent à une classe ou à un groupe de champs. Comme ce schéma utilise une classe standard, votre seule option est de sélectionner un groupe de champs. Commencez à saisir le nom « Custom Loyalty Details », puis sélectionnez le groupe de champs dans la liste.
Lorsque vous avez terminé, sélectionnez Appliquer.
Les modifications sont appliquées et le nouvel objet « loyaltyTier
» s’affiche. Puisqu’il s’agit d’un champ personnalisé, il est automatiquement imbriqué dans un espace de noms d’objet associé à l’identifiant du client de votre organisation, précédé d’un trait de soulignement (_tenantId
dans cet exemple).
Sélectionnez l’icône plus (+) à côté de l’objet loyaltyTier
pour commencer à ajouter des sous-champs. Un espace reservé au nouveau champ apparaît et la section Propriétés du champ est visible sur le côté droit de la zone de travail.
Chaque champ nécessite les informations suivantes :
- Nom du champ : le nom du champ, écrit de façon à ce que les mots soient liés sans espace ni ponctuation, et en mettant en capitale la première lettre de chaque mot (Camel Case). Aucune espace n’est autorisé. Il s’agit du nom utilisé pour référencer le champ dans le code et dans d’autres applications en aval.
- Exemple : loyaltyLevel
- Nom d’affichage : le nom du champ, écrit avec la première lettre de chaque mot important en majuscule (Title Case). Il s’agit du nom qui s’affiche dans la zone de travail lors de l’affichage ou de la modification du schéma.
- Exemple : Loyalty Level
- Type : le type de données du champ. Cela inclut les types scalaires de base et tous les types de données définis dans 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 avec un maximum de 200 caractères.
Le premier champ de l’objet loyaltyTier
sera une chaîne de caractères appelée id
, représentant l’ID du niveau actuel du membre du programme de fidélité. L’ID de niveau sera unique pour chaque membre du programme de fidélité, car cette entreprise définit différents seuils de point de niveau de fidélité pour chaque client en fonction de différents facteurs. Définissez le type du nouveau champ sur "String" et la section Propriétés du champ contient plusieurs options pour appliquer des contraintes, notamment la valeur par défaut, le format et la longueur maximale. Pour en savoir plus, consultez la documentation sur les bonnes pratiques relatives aux champs de validation des données .
Comme id
est une chaîne à structure libre générée de manière aléatoire, aucune autre contrainte n’est nécessaire. Sélectionnez Appliquer pour appliquer vos modifications.
Ajouter des champs supplémentaires au groupe de champs field-group-fields-2
Maintenant que vous avez ajouté le champ id
, vous pouvez ajouter des champs supplémentaires pour recueillir des informations relatives à la fidélité, par exemple :
- Seuil de point actuel (entier) : nombre minimal de points de fidélité que le membre doit conserver pour rester au niveau actuel.
- Seuil de point de niveau supérieur (entier) : nombre de points de fidélité que le membre doit acquérir pour passer au niveau supérieur.
- Date d’entrée en vigueur (date et heure) : date à laquelle le membre du programme de fidélité a rejoint ce niveau.
Pour ajouter chaque champ au schéma, sélectionnez l’icône plus (+) à côté de l’objet loyalty
et renseignez les informations requises.
Une fois cette étape terminée, l’objet loyaltyTier
contiendra des champs pour id
, currentThreshold
, nextThreshold
, et effectiveDate
.
Ajouter un champ d’énumération au groupe de champs enum
Lorsque vous définissez des champs dans le Schema Editor, vous pouvez appliquer certaines options supplémentaires aux types de champs de base afin de fournir d’autres contraintes aux 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 loyaltyTier
dans le schéma nécessite un nouveau champ d’énumération qui décrit la classe de niveau, 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 (+) à côté de l’objet loyaltyTier
et remplissez 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é, y compris les cases à cocher pour Tableau, Énumération et valeurs suggérées, Identité et Relation.
Sélectionnez la case à cocher Énumération et valeurs suggérées, puis sélectionnez Énumération. Ici, vous pouvez saisir la valeur (en Camel Case -Casse mixte) et le nom d’affichage (nom facultatif et facile à lire écrit en Title Case - 1ère lettre des mots en majuscule) pour chaque classe de fidélité acceptable.
Une fois toutes les propriétés de champ renseignées, sélectionnez Appliquer pour ajouter le champ tierClass
à l’objet loyaltyTier
.
Conversion d’un objet à plusieurs champs en un type de données datatype
L’objet loyaltyTier
contient désormais plusieurs champs et représente une structure de données commune qui peut s’avérer utile dans d’autres schémas. Le 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, avec plus de flexibilité qu’un groupe de champs, car elles peuvent être utilisées 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 le Schema Registry.
Pour convertir l’objet loyaltyTier
pour un type de données, sélectionnez le champ loyaltyTier
dans la zone de travail, 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 notification s’affiche, confirmant que la conversion de l’objet a réussi. Dans la zone de travail, vous pouvez maintenant voir que le champ loyaltyTier
comporte désormais une icône de lien et que le rail droit indique qu’il possède un type de données « Loyalty Tier ».
Dans un prochain schéma, vous pourrez désormais attribuer un champ en tant que type « Loyalty Tier », ce qui inclurait automatiquement des champs pour l’ID, la classe de niveau, les seuils de point et la date d’entrée en vigueur.
Rechercher et filtrer 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 situées à côté 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é identity-field
La structure de données standard fournie par les schémas peut être exploité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 des données en fonction d’identités individuelles, les champs clés doivent être marqués comme des champs d’identité dans les schémas applicables.
Experience Platform permet de désigner facilement un champ d’identité grâce à une case à cocher Identité dans le 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é, et plusieurs d’entre eux peuvent partager la même adresse physique. Dans ce scénario, cependant, chaque membre du programme de fidélité fournit lors de l’inscription son adresse électronique personnelle. Puisque les adresses e-mail personnelles sont généralement gérées par une seule personne, le champ personalEmail.address
(fourni par le groupe de champs Coordonnées personnelles) est un bon candidat pour un champ d’identité.
identityMap
pour contenir des informations d’identité.identityMap
, gardez à l’esprit qu’il remplacera toute identité principale que vous ajoutez directement au schéma. Pour plus d’informations, consultez la section sur identityMap
dans les principes de base du guide de composition de schémas.Sélectionnez le champ personalEmail.address
dans la zone de travail, et la case à cocher Identité apparaît sous Propriétés du champ. Cochez la case et vous aurez la possibilité de la définir comme Identité principale. Cochez également cette case.
Ensuite, vous devez fournir un Espace de noms d’identité à partir des espaces de noms prédéfinis dans la liste déroulante. Puisque ce champ correspond à l’adresse e-mail du client, sélectionnez « E-mail » dans la liste déroulante. Sélectionnez Appliquer pour confirmer les mises à jour du champ personalEmail.address
.
Après application de la modification, l’icône personalEmail.address
affiche un symbole d’empreinte digitale, indiquant qu’il s’agit désormais d’un champ d’identité. Le champ est également répertorié dans le rail de gauche sous Identités.
Désormais, toutes les données ingérées dans le champ personalEmail.address
seront utilisées pour aider à identifier cet individu et à établir une vue unique de ce client. Pour en savoir plus sur l’utilisation des identités dans Experience Platform, veuillez consultez la documentation d’Identity Service.
Activer le schéma pour l’utiliser dans Real-Time Customer Profile profile
Real-Time Customer Profile exploite les données d’identité dans Experience Platform afin de fournir une vue holistique de chaque client individuel. Le service crée des profils fiables et complets des attributs des clients, ainsi que des comptes horodatés de chaque interaction des clients dans 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 avoir préalablement défini une identité principale.
Pour utiliser le schéma « Membres du programme de fidélité » dans Profile, commencez par sélectionner le titre du schéma dans la zone de travail.
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. En plus de ces informations, vous trouverez également un bouton Profile.
Sélectionnez Profile et une fenêtre pop-up s’affiche, vous demandant de confirmer que vous souhaitez activer le schéma pour Profile.
Sélectionnez Activer pour confirmer votre choix. Vous pouvez de nouveau sélectionner le bouton Profile pour désactiver le schéma si vous le souhaitez, mais une fois que le schéma a été enregistré alors que Profile est activé, il ne peut plus être désactivé.
Actions supplémentaires more
Dans l’éditeur de schémas, vous pouvez également exécuter des actions rapides pour copier la structure JSON du schéma ou supprimer le schéma. Sélectionnez Plus en haut de la vue pour afficher une liste déroulante avec des actions rapides.
Supprimer un schéma delete-a-schema
Un schéma peut être supprimé dans l’interface utilisateur de l’éditeur de schémas à l’aide des actions Plus et également des détails du schéma dans l’onglet Parcourir. Certaines conditions empêchent la suppression d’un schéma. Un schéma ne peut pas être supprimé si :
- Le schéma est activé pour Profile.
- Le schéma est activé pour Profile et comporte des jeux de données associés.
- Le schéma comporte des jeux de données associés, mais n’est pas activé pour Profile.
Copier la structure JSON copy-json-structure
Sélectionnez Copier la structure JSON pour générer une charge d’exportation pour n’importe quel schéma de la bibliothèque de schémas. Cette action copie la structure JSON dans le presse-papiers. Le fichier JSON exporté peut ensuite être utilisé pour importer le schéma et toutes les ressources associées dans un environnement de test ou une organisation différent. Cela rend le partage et la réutilisation des schémas entre différents environnements simples et efficaces.
É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 pour enregistrer le schéma dans Schema Library et pouvoir y accéder depuis Schema Registry.
Votre nouveau schéma peut maintenant ê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 « Membres du programme de fidélité ».
Vous pouvez également consulter et gérer le schéma « Membres du programme de fidélité » à l’aide de l’API Schema Registry. Pour commencer à utiliser l’API, consultez 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 champ.
Annexe
Les sections suivantes apportent des informations supplémentaires sur l’utilisation de Schema Editor.
Création d’une nouvelle classe create-new-class
Experience Platform offre la possibilité de définir un schéma basé sur une classe propre à votre organisation. Pour apprendre à créer une nouvelle classe, consultez le guide sur la création et modification de classes dans l’interface utilisateur.
Modification de la classe d’un schéma change-class
Vous pouvez modifier la classe d’un schéma à tout moment au cours du processus de composition initiale, avant que le schéma ne soit enregistré.
Pour apprendre à modifier la classe d’un schéma, consultez le guide sur la gestion des schémas dans l’interface utilisateur.