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.

NOTE
Si vous ingérez des données CSV dans Platform, vous pouvez mapper ces données à un schéma XDM créé par des recommandations générées par l’IA (actuellement en version bêta) sans avoir à créer manuellement le schéma.
Si vous préférez composer un schéma à l’aide de l’API Schema Registry, veuillez commencer par lire le Schema Registry guide du développeur avant de vous lancer dans le tutoriel sur la création d’un schéma à l’aide de l’API.

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 :

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. La variable Parcourir affiche une liste des schémas (une représentation de la fonction Schema Library) pour que vous puissiez 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 du Schémas workspace.

La variable Schémas workspace Parcourir avec Créer un schéma surlignée.

La variable Créer un schéma le workflow s’affiche. Choisissez ensuite une classe de base pour le schéma. Vous pouvez choisir parmi les classes principales de XDM Individual Profile et XDM ExperienceEvent, ou Autre si ces classes ne répondent pas à vos besoins. La variable Autre l’option classes vous permet d’effectuer l’une des opérations suivantes : créer une classe ou effectuez une sélection dans d’autres classes préexistantes.

Voir Profil individuel XDM et XDM ExperienceEvent documentation pour plus d’informations sur ces classes. Dans ce tutoriel, sélectionnez XDM Individual Profile suivie de Suivant.

La variable Créer un schéma avec la méthode Profil individuel XDM options et Suivant surlignée.

Une fois que vous avez sélectionné une classe, la variable 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 du schéma 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 passés, sélectionnez Terminer pour créer votre schéma.

La variable Nom et révision de la Créer un schéma avec la méthode Nom d’affichage du schéma, Description, et Terminer surlignée.

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 variable Structure de la zone de travail 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.

NOTE
Vous pouvez mettre à jour le nom d’affichage et la description facultative du schéma à partir de l’ Propriétés du schéma barre latérale. Une fois qu’un nouveau nom est saisi, le canevas se met automatiquement à jour pour refléter le nouveau nom du schéma.

Éditeur de schéma avec la classe de base et le schéma en surbrillance.

NOTE
Vous pouvez modifier la classe d’un schéma à tout moment au cours du processus de composition initial avant que le schéma ne soit enregistré, mais cela doit être fait avec la plus grande prudence. Les groupes de champs ne sont compatibles qu’avec certaines classes. Par conséquent, la modification de la classe réinitialisera la zone de travail et tous les champs que vous avez ajoutés.

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.

L’éditeur de schémas avec le bouton Ajouter des groupes de champs surligné.

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.

La variable Ajouter des groupes de champs boîte de dialogue.

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é.

La variable Ajouter des groupes de champs Boîte de dialogue avec les groupes de champs du secteur mis en évidence.

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.

La variable Ajouter des groupes de champs avec l’icône d’aperçu de groupe de champs sélectionnée mise en surbrillance.

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.

La variable Prévisualiser le groupe de champs avec le groupe de champs Détails démographiques prévisualisé.

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

La variable Ajouter des groupes de champs Boîte de dialogue avec le groupe de champs Détails démographiques sélectionné et Ajouter des groupes de champs surlignée.

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.

Les groupes de champs Éditeur de schéma avec détails démographiques sont mis en surbrillance.

NOTE
Dans l’éditeur de schémas, les classes standard (générées par un Adobe) et les groupes de champs sont indiqués par l’icône de cadenas ( Icône de cadenas. . Le cadenas s’affiche dans le rail de gauche en regard du nom de la classe ou du groupe de champs, ainsi qu’en regard de tout champ du diagramme de schéma qui fait partie d’une ressource générée par le système.
L’éditeur de schéma avec l’icône de cadenas mise en surbrillance

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.

NOTE
N’oubliez pas que les champs peuvent utiliser des types scalaires (chaîne, entier, tableau ou date), ainsi que tout type de données (un groupe de champs représentant un concept commun) défini dans Schema Registry.

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 variable Ajouter des groupes de champs Boîte de dialogue avec deux nouveaux groupes de champs sélectionnés et Ajouter des groupes de champs surlignée.

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.

L’éditeur de schémas avec la nouvelle structure de schéma composite mise en surbrillance.

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 :

  1. 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.
  2. É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.

La variable Ajouter des groupes de champs Boîte de dialogue avec Créer un groupe de champs, Nom d’affichage et Description surlignée.

NOTE
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.

« 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.

L’éditeur de schémas avec l’icône plus en surbrillance.

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.

L’éditeur de schémas avec une Champ sans titre et le schéma Propriétés du champ surlignée.

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.

L’éditeur de schémas avec l’objet Niveau de fidélité ajouté au schéma Propriétés du champ surlignée.

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

L’éditeur de schémas avec l’identifiant du client et le niveau de fidélité mis en surbrillance dans le diagramme de schéma.

NOTE
La présence de l’ID 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 Schema Registry dans une zone spécifique accessible uniquement par votre organisation. Les champs que vous définissez doivent toujours être ajoutés à votre espace de noms client pour empêcher les conflits avec des noms provenant d’autres classes, groupes de champs, types de données et champs standard.

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.

L’éditeur de schémas avec l’identifiant du client et un nouveau sous-champ ajoutés au niveau de fidélité dans le diagramme de schéma.

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 "Chaîne", et la variable Propriétés du champ est renseignée avec plusieurs options permettant d’appliquer des contraintes, notamment la valeur par défaut, le format et la longueur maximale. Consultez la documentation relative à bonnes pratiques relatives aux champs de validation des données pour en savoir plus.

L’éditeur de schémas avec les valeurs de propriété de champ pour le nouveau champ d’identifiant mis en surbrillance.

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.

Ajout et mise en surbrillance de l’éditeur de schémas avec le champ ID .

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.

Éditeur de schéma avec l’objet Niveau de fidélité en surbrillance.

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 :

Contrainte
Description
Obligatoire
Indique que le champ est obligatoire pour l’ingestion de données. Toute donnée chargée dans un jeu de données basé sur ce schéma qui ne contient pas ce champ sera défaillante lors de l’ingestion.
Tableau
Indique que le champ contient un tableau de valeurs, chacune avec le type de données spécifié. Par exemple, l’utilisation de cette contrainte sur un champ avec un type de données « Chaîne » indique que le champ contiendra un tableau de chaînes.
Énumération et valeurs suggérées
Une énumération indique que ce champ doit contenir une des valeurs d’une liste énumérée de valeurs possibles. Vous pouvez également utiliser cette option pour fournir une liste des valeurs suggérées pour un champ de chaîne sans limiter le champ à ces valeurs.
Identité
Indique que ce champ est un champ d’identité. Vous trouverez plus d’informations sur les champs d’identité dans la suite de ce tutoriel.
Relation
Bien que les relations de schéma puissent être déduites par l’utilisation du schéma d’union et Real-Time Customer Profile, cela s’applique uniquement aux schémas partageant la même classe. La contrainte Relation indique que ce champ fait référence à l’identité principale d’un schéma basée sur une classe différente, ce qui implique une relation entre les deux schémas. Pour plus d’informations, consultez le tutoriel sur la définition d’une relation.
NOTE
Tous les champs obligatoires d’identité ou de relation sont répertoriés dans leurs sections respectives du rail de gauche, ce qui vous permet de localiser facilement ces champs, quelle que soit la complexité du schéma.

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 ».

L’éditeur de schémas avec l’objet Classe de niveau ajouté et mis en surbrillance dans la variable Propriétés du champ.

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.

Propriétés du champ énumération et valeur de proposition complétées par Appliquer surlignée.

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.

Éditeur de schéma avec l’objet loyaltyLevel et Convertir en nouveau type de données surlignée.

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 ».

Éditeur de schéma avec l’objet loyaltyLevel et le nouveau nom d’affichage mis en surbrillance.

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.

NOTE
Vous pouvez également créer et modifier des types de données personnalisés indépendamment de la modification des schémas. Consultez le guide sur la création et modification des types de données pour plus d’informations.

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.

Certaines cases à cocher sélectionnées dans la section Groupes de champs de l’éditeur de schémas pour réduire la taille du schéma.

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.

Champ de recherche de l’éditeur de schémas avec les résultats pertinents mis en surbrillance sur la zone de travail.

IMPORTANT
La fonction de recherche prend en compte les filtres de groupes de champs sélectionnés lors de l’affichage des champs correspondants. Si une requête de recherche n’affiche pas les résultats attendus, vous devrez peut-être vérifier par deux fois que vous n’êtes pas en train de filtrer un groupe de champs approprié.

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é.

IMPORTANT
Les étapes décrites ci-dessous expliquent comment ajouter un descripteur d’identité à un champ de schéma existant. Au lieu de définir des champs d’identité dans la structure du schéma lui-même, vous pouvez également utiliser un champ identityMap pour contenir des informations d’identité.
Si vous envisagez d’utiliser 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.

NOTE
Chaque schéma ne peut contenir qu’un seul champ d’identité principal. Une fois qu’un champ du schéma a été défini comme identité principale, vous recevrez un message d’erreur si vous tentez par la suite de définir un autre champ d’identité du schéma comme identité principale.

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.

L’éditeur de schémas avec l’adresse électronique mise en surbrillance et la case à cocher Identité de Principal activée.

NOTE
Pour obtenir la liste des espaces de noms standard et leurs définitions, consultez la Identity Service documentation.

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.

L’éditeur de schémas avec l’adresse électronique mise en surbrillance et le champ d’identité mis en surbrillance dans la barre latérale de composition du schéma.

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.

Boîte de dialogue Identité principale manquante.

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.

L’éditeur de schémas avec la racine de schéma et le bouton activer pour le profil sont mis en surbrillance.

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

La boîte de dialogue de confirmation Activer pour Profile .

WARNING
Une fois qu’un schéma a été activé pour Real-Time Customer Profile et enregistré, il ne peut pas être désactivé.

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’il n’a pas été activé pour Real-time Customer Profile ou s’il comporte des jeux de données associés. Sélectionner Plus dans la partie supérieure de la vue pour afficher une liste déroulante contenant des actions rapides.

La fonctionnalité Copier la structure JSON vous permet de voir à quoi ressemblerait un exemple de payload pendant que vous créez encore le schéma et vos pipelines de données. Elle s’avère particulièrement utile dans les situations où il existe des structures de mappage d’objet complexes dans le schéma, telles qu’une carte d’identité.

L’éditeur de schémas avec le bouton Plus en surbrillance et les options de liste déroulante s’affichent.

É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

WARNING
L’interface utilisateur Platform affichée dans les vidéos suivantes est obsolète. Consultez la documentation pour découvrir les dernières captures dʼécran et fonctionnalités de lʼinterface utilisateur.

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é.

WARNING
La réattribution de la classe d’un schéma doit être effectuée avec une extrême prudence. Les groupes de champs ne sont compatibles qu’avec certaines classes. Par conséquent, la modification de la classe réinitialisera la zone de travail et tous les champs que vous avez ajoutés.

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

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07