Créez un schéma à l’aide de l’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 trame visuelle interactive appelée Schema Editor. Ce didacticiel 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, début en lisant le Schema Registry guide du développeur avant d'essayer le didacticiel sur la création d'un schéma à l'aide de l'API.

Prise en main

Ce tutoriel exige 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 mixins, les types de données et les champs.
• 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 du Schema Library, ce qui vous permet de gérer les schémas disponibles pour votre organisation par vue. L’espace de travail comprend également le canevas Schema Editor, sur lequel vous pouvez composer un schéma tout au long de ce didacticiel.

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 vue 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 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 Individuel Profil 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 didacticiel, sélectionnez Profil individuel XDM.

Le Schema Editor apparaît. C’est le canevas sur lequel vous allez composer votre schéma. Puisque vous avez choisi une classe XDM standard pour baser le 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 trouvé plus tard.
• 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 didacticiel compose un schéma d’assimilation de données relatives aux membres d’un programme de fidélité. Par conséquent, le schéma est nommé "Membres de fidélité".

Ajout d’un mixin

Vous pouvez maintenant commencer à ajouter des champs à votre schéma grâce à l’ajout de mixins. Un mixin est un groupe d’un ou de plusieurs champs qui sont souvent utilisés ensemble pour décrire un concept particulier. Ce tutoriel utilise des mixins 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 mixin, sélectionnez Ajouter dans la sous-section Mixins.

Une nouvelle boîte de dialogue s’affiche, affichant une liste de mixins disponibles. Chaque mixin n'est destiné qu'à une classe spécifique. Par conséquent, la boîte de dialogue ne liste que les mixins 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 mixins sera triée intelligemment en fonction de la popularité de l’utilisation.

Si vous sélectionnez un mixin dans la liste, il apparaît dans le rail de droite. Vous pouvez sélectionner plusieurs mixins si vous le souhaitez, en ajoutant chacun à la liste dans le rail de droite avant de confirmer. En outre, une icône s’affiche sur le côté droit du mixin actuellement sélectionné, ce qui vous permet de prévisualisation de la structure des champs fournis.

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

Pour ce didacticiel, sélectionnez le mixin Détails démographiques, puis Ajouter le mixin.

Le canevas du schéma réapparaît. La section Mixins liste désormais "Détails démographiques" et la section Structure comprend les champs fournis par le mixin. Vous pouvez sélectionner le nom du mixin sous la section Mixins pour mettre en surbrillance les champs spécifiques qu’il fournit dans la trame.

Ce mixin 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 qu’il contient des sous-champs liés aux noms tels que prénom, nom, titre de politesse et 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.

Ajout d’un autre mixin

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

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

Une fois ajouté, le canevas réapparaît. "Détails du contact personnel" est maintenant répertorié sous Mixins dans la section Composition, et les champs pour l'adresse de domicile, le téléphone portable, et plus 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 nouveau mixin

Le schéma "Membres de fidélité" est destiné à capturer les données relatives aux membres d'un programme de fidélité. Il nécessite donc certains champs spécifiques liés à la fidélité. Il n’existe pas de mixins standard qui contiennent les champs nécessaires. Vous devrez donc définir un nouveau mixin.

Cette fois, lorsque vous ouvrez la boîte de dialogue Ajouter un mixin, sélectionnez Créer un mixin. Vous serez alors invité à fournir un nom d’affichage et une description pour votre mixin.

Comme pour les noms de classe, le nom du mixin doit être court et simple, décrivant ce que le mixin 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 mixin « Loyalty Details ».

Sélectionnez Ajouter le mixin pour revenir au Schema Editor. "Les détails de fidélité" doivent maintenant apparaître sous Mixins à gauche du canevas, mais aucun champ n'y est associé pour le moment et, par conséquent, aucun nouveau champ n'apparaît sous Structure.

Ajout de champs au mixin

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

Pour commencer, sélectionnez le nom du mixin dans la section Mixins. Une fois que vous avez effectué cette opération, les propriétés du mixin s’affichent sur le côté droit de l’éditeur et 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 nouveau noeud dans la structure. Ce noeud (appelé _tenantId dans cet exemple) représente l’ID de 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 seront enregistrés dans Schema Registry dans une zone spécifique accessible uniquement à votre organisation. Les champs que vous définissez doivent toujours être ajoutés à votre espace de nommage locataire afin d’éviter les collisions avec des noms provenant d’autres classes standard, mixins, types de données et champs.

À l’intérieur de ce noeud, l’espace de noms est un "Nouveau champ". Il s’agit du début du mixin "Détails de fidélité".

En utilisant les contrôles sur le côté droit de l’éditeur, début en créant 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 d’autres champs 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 de la trame.

Chaque champ nécessite les informations suivantes :

• Nom du champ : nom du champ, écrit dans la casse du chameau. Exemple : loyaltyLevel
• Nom d’affichage : nom du champ, écrit en casse de 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 Schema Registry. Exemples : Chaîne, Entier, Boolean, Personne, Adresse, Numéro de téléphone, etc.
• Description : Une description facultative du champ doit être incluse, écrite en cas de phrase, 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 "String", la section Propriétés du champ devient renseignée avec plusieurs options pour appliquer des contraintes, notamment 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é. Puisque loyaltyId sera une adresse électronique, sélectionnez "email" dans le menu déroulant Format. Sélectionnez Appliquer pour appliquer vos modifications.

Ajouter plus de champs au mixin

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

• Points (entier)
• Membre depuis (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 terminé, l’objet Fidélité contient des champs pour l’identifiant de fidélité, les points et le membre depuis.

Ajouter un champ enum au mixin

Lors de la définition de champs dans 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 :

Contrainte	Description
Obligatoire	Indique que le champ est requis pour l’assimilation de données. Toute donnée chargée dans un ensemble 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 dont le type de données est "String" indique que le champ contiendra un tableau de chaînes.
Enum	Indique que ce champ doit contenir l’une des valeurs d’une liste énumérée de valeurs possibles.
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 ne s'applique qu'aux schémas qui partagent la même classe. La contrainte Relation indique que ce champ fait référence à l'identité Principale d'un schéma en fonction d'une classe différente, ce qui implique une relation entre les deux schémas. Pour plus d'informations, consultez le didacticiel sur la définition d'une relation.

Pour ce didacticiel, 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 obligatoires 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 Tableau, Enum et Identité.

Cochez la case Enum pour ouvrir la section Valeurs Enum 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 de champ remplies, 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 peut s'avérer utile dans d'autres schémas. Le Schema Editor permet d'appliquer facilement des objets multichamps 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é que les mixins, 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 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 l’objet a bien été converti.

Maintenant, lorsque vous observez sous Structure, vous pouvez voir que le champ loyalty a un type de données "Loyalty" et que les champs ont de petites icônes de verrouillage à côté d'eux, indiquant qu'ils ne sont plus des champs individuels mais qu'ils font plutôt partie d'un type de données à champs multiples.

Dans un schéma ultérieur, vous pouvez désormais attribuer un champ sous la forme "Loyalty" et inclure automatiquement des champs pour l’ID, le niveau de fidélité, le membre depuis et les points.

Rechercher et filtrer les champs de schéma

Votre schéma contient désormais plusieurs mixins en plus des champs fournis par sa classe de base. Lorsque vous travaillez avec des schémas plus volumineux, vous pouvez cocher les cases en regard des noms de mixin dans le rail de gauche pour filtrer les champs affichés uniquement ceux fournis par les mixins 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 mixin 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 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, le rapports, l'analyse des données scientifiques, 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 facilite la désignation d'un champ d'identité par le biais d'une case à cocher ​​Identité dans la Schema Editorsection. 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 un 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. Sélectionnez également cette zone.

Ensuite, vous devez fournir un espace de nommage d'identité à partir de la liste d'espaces de nommage prédéfinis dans la liste déroulante. loyaltyId étant l’adresse électronique du client, sélectionnez "Courriel" 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 saisies dans le champ loyaltyId seront utilisées pour identifier cette personne et assembler une seule vue de ce client. Pour en savoir plus sur l'utilisation des identités dans Experience Platform, consultez la documentation Identity Service.

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

Real-time Customer Profile exploite les données d'identité Experience Platform pour fournir une vue holistique à 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 dans tout système intégré à Experience Platform.

Pour qu'un schéma puisse être activé pour une utilisation avec Real-time Customer Profile, une identité Principale doit être définie. Vous recevrez un message d'erreur si vous tentez d'activer un schéma sans définir au préalable une identité Principale.

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

Sur le côté droit de l’éditeur, des informations sur le schéma, y compris son nom d’affichage, sa description et son type, s’affichent. Outre ces informations, il existe un bouton de bascule 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 la bascule Profil 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é.

É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 trame. Sélectionnez Enregistrer et le schéma sera enregistré dans Schema Library, ce qui le rendra accessible par Schema Registry.

Votre nouveau schéma peut désormais être utilisé pour importer 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 didacticiel 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 fidèles".

Le schéma "Membres fidèles" est également disponible pour être affiché et géré à l’aide de l’API Schema Registry. Pour commencer à travailler avec l'API, début en lisant le Schema Registry API guide du développeur.

Ressources vidéo

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

La vidéo ci-dessous est destinée à vous aider à mieux comprendre comment travailler avec des mixins et des classes.

Annexe

Les sections suivantes fournissent des informations complé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 nouvelle classe, consultez le guide Création et modification de 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 que le schéma n'ait été enregistré.

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