Définissez une relation un-à-un entre deux schémas à l’aide de la variable Schema Editor

Comprendre les relations entre vos clients et leurs interactions avec votre marque sur divers canaux est un aspect important d’Adobe Experience Platform. Définir ces relations au sein de la structure de votre Experience Data Model Les schémas (XDM) vous permettent d’obtenir des informations complexes sur les données de vos clients.

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 qui partagent la même classe. Pour établir une relation entre deux schémas appartenant à des classes différentes, un champ de relation dédié doit être ajouté à un schéma source, qui référence l’identité d’un schéma de destination.

Ce document fournit un tutoriel sur la définition d’une relation entre deux schémas à l’aide de l’éditeur de schémas dans la variable Experience Platform de l’interface utilisateur. Les étapes de la définition des relations de schémas à l’aide de l’API sont décrites dans le tutoriel sur la définition d’une relation à l’aide de l’API Schema Registry.

REMARQUE

Pour savoir comment créer une relation multiple-à-un dans Real-time Customer Data Platform B2B Edition, consultez le guide sur création de relations B2B.

Prise en main

Ce tutoriel nécessite une compréhension pratique de XDM System et de l’éditeur de schémas dans le Experience Platform Interface utilisateur. Avant de commencer ce tutoriel, consultez la documentation suivante :

Définition d’un schéma source et de destination

Vous devez avoir déjà créé les deux schémas qui seront définis dans la relation. À des fins de démonstration, ce tutoriel crée une relation entre les membres du programme de fidélité d’une organisation (définis dans un "Loyalty Members"" et leur hôtel préféré (défini dans un ") Hotels").

IMPORTANT

Pour établir une relation, les deux schémas doivent avoir défini des identités Principales et être activés pour Real-time Customer Profile. Voir la section sur activation d’un schéma à utiliser dans Profile dans le tutoriel sur la création de schémas si vous avez besoin de conseils sur la configuration de vos schémas en conséquence.

Les relations de schéma sont représentées par un champ dédié dans une schéma source qui fait référence à un autre champ d’un schéma de destination. Dans les étapes suivantes, "Loyalty Members" sera le schéma source, tandis que "Hotels" agira comme schéma de destination.

À titre de référence, les sections suivantes décrivent la structure de chaque schéma utilisé dans ce tutoriel avant de définir une relation.

Loyalty Members schema

Le schéma source "Loyalty Members" est basé sur la variable XDM Individual Profile et est le schéma qui a été créé dans le tutoriel pour création d’un schéma dans l’interface utilisateur. Il comprend un loyalty sous _tenantId qui comprend plusieurs champs spécifiques à la fidélité. Un de ces champs, loyaltyId, sert d’identité Principale pour le schéma sous le Email espace de noms. Comme vous pouvez le voir sous Propriétés du schéma, ce schéma a été activé pour une utilisation dans Real-time Customer Profile.

Hotels schema

Le schéma de destination "Hotels" est basé sur unHotels" et contient des champs qui décrivent un hôtel.

Pour participer à une relation, le schéma de destination doit avoir une identité Principale. Dans cet exemple, la variable hotelId est utilisé comme identité Principale, à l’aide d’un espace de noms d’identité personnalisé "ID d’hôtel".

Identité Principale de l'hôtel

REMARQUE

Pour savoir comment créer des espaces de noms d’identité personnalisés, reportez-vous à la section Documentation d’Identity Service.

Une fois l’identité Principale définie, le schéma de destination doit être activé pour Real-time Customer Profile.

Activation pour Profile

Création d’un groupe de champs de schéma de relation

REMARQUE

Cette étape n’est nécessaire que si votre schéma source ne dispose pas d’un champ de type chaîne dédié à utiliser comme référence au schéma de destination. Si ce champ est déjà défini dans votre schéma source, passez à l’étape suivante de la définition d’un champ de relation.

Pour définir une relation entre deux schémas, le schéma source doit disposer d’un champ dédié à utiliser comme référence au schéma de destination. Vous pouvez ajouter ce champ au schéma source en créant un nouveau groupe de champs de schéma.

Commencez par sélectionner Ajouter dans le Groupes de champs .

Le Ajouter un groupe de champs s’affiche. À partir de là, sélectionnez Créer un groupe de champs. Dans les champs de texte qui s'affichent, saisissez le nom d'affichage et la description du nouveau groupe de champs. Sélectionner Ajouter des groupes de champs lorsque vous avez terminé.

Le canevas réapparaît avec "Favorite Hotel" apparaissant dans la variable Groupes de champs . Sélectionnez le nom du groupe de champs, puis sélectionnez Ajouter un champ en regard du niveau racine Loyalty Members champ .

Un nouveau champ s’affiche dans la zone de travail sous _tenantId espace de noms. Sous Propriétés du champ, indiquez un nom de champ et un nom d’affichage pour le champ, puis définissez son type sur "Chaîne".

Lorsque vous avez terminé, sélectionnez Appliquer.

La mise à jour favoriteHotel s’affiche dans la zone de travail. Sélectionner Enregistrer pour finaliser les modifications apportées au schéma.

Définition d’un champ de relation pour le schéma source

Une fois que le champ de référence dédié de votre schéma source est défini, vous pouvez le désigner comme champ de relation.

REMARQUE

Les étapes ci-dessous expliquent comment définir un champ de relation à l’aide des commandes de rail droit dans la zone de travail. Si vous avez accès à l’édition B2B de Real-Time CDP, vous pouvez également définir une relation un-à-un à l’aide de la variable même boîte de dialogue comme lors de la création de relations multiples-à-un.

Sélectionnez la favoriteHotel dans la zone de travail, puis faites défiler l’écran vers le bas sous Propriétés du champ jusqu’à ce que la variable Relation s’affiche. Cochez la case pour afficher les paramètres requis pour la configuration d’un champ de relation.

Sélectionnez la liste déroulante pour Schéma de référence et sélectionnez le schéma de destination de la relation ("Hotels" dans cet exemple). Si le schéma de destination est activé pour Profile, la variable Espace de noms d’identité de référence est automatiquement défini sur l’espace de noms de l’identité Principale du schéma de destination. Si aucune identité principale n’est définie pour le schéma, vous devez sélectionner manuellement l’espace de noms que vous prévoyez d’utiliser dans le menu déroulant. Sélectionner Appliquer lorsque vous avez terminé.

Le favoriteHotel est maintenant mis en surbrillance en tant que relation dans la zone de travail, affichant le nom et l’espace de noms d’identité de référence du schéma de destination. Sélectionner Enregistrer pour enregistrer vos modifications et terminer le processus.

Étapes suivantes

En suivant ce tutoriel, vous avez réussi à créer une relation un-à-un entre deux schémas à l’aide de la variable Schema Editor. Les étapes de la définition des relations à l’aide de l’API sont décrites dans le tutoriel sur la définition d’une relation à l’aide de l’API Schema Registry.

Sur cette page