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, y compris 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 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.

Puisque vous avez choisi une classe XDM standard pour la base du schéma, la boîte de dialogue Ajouter le groupe de champs s'affiche, vous permettant de immédiatement début l'ajout de champs au schéma. Pour l’instant, sélectionnez Annuler pour quitter la boîte de dialogue.

Le Schema Editor apparaît. 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 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é".

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 de champs qui sont souvent utilisés ensemble pour décrire un concept particulier. Ce didacticiel utilise des groupes de champs pour décrire les membres du programme de fidélité et capturer 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 de groupes de champs disponibles. Chaque groupe de champs n'est destiné qu'à une classe spécifique. Par conséquent, la boîte de dialogue ne liste 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.

Si vous sélectionnez un groupe de champs dans la liste, il apparaît dans le rail de droite. Vous pouvez sélectionner plusieurs groupes de champs 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 groupe de champs actuellement sélectionné, ce qui vous permet de prévisualisation la structure des champs fournis.

Lors de la prévisualisation d’un groupe de champs, une description détaillée de l’schéma du groupe de champs est fournie dans le rail de droite. Vous pouvez également parcourir les champs du groupe de champs dans le canevas fourni. 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 de groupe de champs.

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

Le canevas du schéma réapparaît. La section Groupes de champs liste désormais "Détails démographiques" et la section Structure comprend 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 trame.

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

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 vue cette fois la boîte de dialogue Ajouter le groupe de champs, notez que le groupe de champs "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 groupes de champs que vous avez déjà inclus dans le schéma actuel.

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

Une fois ajouté, le canevas réapparaît. "Détails du contact personnel" est maintenant répertorié sous Groupes de champs 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éfinir un groupe de champs personnalisé

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 existe un groupe de champs Détails de fidélité standard que vous pouvez ajouter au schéma pour capturer des champs communs liés à un programme de fidélité. Bien que vous soyez fortement encouragé à utiliser des groupes de champs standard pour représenter des 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é particulier. 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 du haut. 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 contribuera 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 didacticiel, nommez le nouveau groupe de champs "Détails de fidélité".

Sélectionnez Ajouter le groupe de champs pour revenir à Schema Editor. "Les détails de fidélité" doivent maintenant apparaître sous Groupes de champs à 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.

Ajouter des champs au groupe de champs

Maintenant que vous avez créé le groupe de champs "Détails de fidélité", il est temps de définir les champs que le groupe de champs contribuera 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 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, groupes de champs, 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 groupe de champs "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 groupe de champs

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 groupe de champs

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 :

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 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 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 groupes de champs 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 des groupes de champs dans le rail de gauche pour filtrer les champs affichés uniquement ceux fournis par les 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 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 suivante vise à vous aider à mieux comprendre comment travailler avec des groupes et des classes de terrain.

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.