Définir une relation plusieurs-à-un entre deux schémas dans l’édition B2B de Real-time Customer Data Platform
Créé pour :
- Développeur
Adobe Real-Time Customer Data Platform B2B edition fournit plusieurs classes de modèle de données d’expérience (XDM) qui capturent les entités de données B2B fondamentales, notamment les comptes, opportunités, campagnes, etc. En créant des schémas basés sur ces classes et en les activant pour les utiliser dans Real-Time Customer Profile, vous pouvez fusionner des données provenant de sources disparates en une représentation unifiée appelée schéma d’union.
Cependant, les schémas d’union ne peuvent contenir que des champs capturés par des schémas partageant la même classe. C’est là que les relations de schéma entrent en jeu. En implémentant des relations dans vos schémas B2B, vous pouvez décrire la manière dont ces entités commerciales sont liées les unes aux autres et inclure des attributs provenant de plusieurs classes dans les cas d’utilisation de segmentation en aval.
Le diagramme suivant fournit un exemple de la manière dont les différentes classes B2B peuvent être liées les unes aux autres dans une implémentation de base :
Ce tutoriel décrit les étapes à suivre pour définir une relation multiple-à-un entre deux schémas dans Real-Time CDP B2B edition.
Commencer
Ce tutoriel nécessite une compréhension pratique de XDM System et de l’éditeur de schémas dans l’interface utilisateur de Experience Platform. Avant de commencer ce tutoriel, consultez la documentation suivante :
- Système XDM dans Experience Platform : présentation de XDM et de sa mise en œuvre dans Experience Platform.
- Principes de base de composition des schémas : une présentation des blocs de création de schémas XDM.
- Création d’un schéma à l’aide du Schema Editor : tutoriel présentant les principes de base de la création et de la modification de schémas dans l’interface utilisateur.
Définition d’un schéma source et de référence
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 opportunités commerciales (définies dans un schéma « Opportunities ») et leur compte commercial associé (défini dans un schéma « Accounts »).
Les relations de schéma sont représentées par un champ dédié dans un schéma source qui fait référence au champ d’identité principale d’un schéma de référence. Dans les étapes qui suivent, « Opportunities » sert de schéma source, tandis que « Accounts » agit comme schéma de référence.
Comprendre les identités dans les relations B2B
Pour établir une relation, le schéma de référence doit avoir une identité principale définie. Lors de la définition d’une identité principale pour une entité B2B, gardez à l’esprit que les ID d’entité basés sur des chaînes peuvent se chevaucher si vous les collectez sur différents systèmes ou emplacements, ce qui peut entraîner des conflits de données dans Experience Platform.
Pour en tenir compte, toutes les classes B2B standard contiennent des champs « clé » conformes au type de données Source B2B. Ce type de données fournit des champs pour un identifiant de chaîne pour l’entité B2B ainsi que d’autres informations contextuelles sur la source de l’identifiant. L’un de ces champs, sourceKey
, concatène les valeurs des autres champs du type de données afin de produire un identifiant totalement unique pour l’entité. Ce champ doit toujours être utilisé comme identité principale pour les schémas d’entité B2B.
À des fins de référence, les sections suivantes décrivent la structure de chaque schéma utilisé dans ce tutoriel avant la définition d’une relation. Notez l’emplacement où les identités principales ont été définies dans la structure du schéma et les espaces de noms personnalisés qu’elles utilisent.
Schéma des opportunités
Le schéma source « Opportunities » est basé sur la classe XDM Business Opportunity. L’un des champs fournis par la classe, opportunityKey
, sert d’identifiant pour le schéma. Plus précisément, le champ sourceKey
sous l’objet opportunityKey
est défini comme identité principale du schéma sous un espace de noms personnalisé appelé B2B Opportunity.
Comme indiqué sous Propriétés du champ, ce schéma peut être utilisé dans Real-Time Customer Profile.
Accounts le schéma
Le schéma de référence « Accounts » est basé sur la classe Compte XDM. Le champ de accountKey
de niveau racine contient le sourceKey
qui agit comme identité principale sous un espace de noms personnalisé appelé B2B Account. Ce schéma peut également être utilisé dans Profile.
Définir un champ de relation pour le schéma source
Pour définir une relation entre deux schémas, le schéma source doit comporter un champ dédié qui indique l’identité principale du schéma de référence. Les classes B2B standard incluent des champs de clé source dédiés pour les entités commerciales fréquemment liées. Par exemple, la classe XDM Business Opportunity contient les champs de clé source pour un compte associé (accountKey
) et une campagne associée (campaignKey
). Cependant, vous pouvez également ajouter d’autres champs Source B2B au schéma à l’aide de groupes de champs personnalisés si vous avez besoin de plus que les composants par défaut.
Pour définir un champ de relation, sélectionnez le champ en question dans la zone de travail, puis Ajouter une relation dans la barre latérale Propriétés du schéma. Dans le cas du schéma Opportunities, il s’agit du champ accountKey.sourceKey
, car l’objectif est d’établir une relation multiple-à-un avec un compte.
La boîte de dialogue Ajouter une relation s’affiche. Utilisez cette boîte de dialogue pour spécifier les détails de la relation. Par défaut, le type de relation est défini sur plusieurs-à-un.
Sous Schéma de référence, utilisez la barre de recherche ou le menu déroulant pour trouver le nom du schéma de référence. Lorsque vous mettez en surbrillance le nom du schéma de référence, le champ Espace de noms d’identité de référence est automatiquement mis à jour vers l’espace de noms de l’identité principale du schéma de référence.
Sous Nom de la relation du schéma actuel et Nom de la relation du schéma de référence, fournissez des noms conviviaux pour la relation dans le contexte des schémas source et de référence, respectivement. Lorsque vous avez terminé, sélectionnez Appliquer pour confirmer les modifications et enregistrer la relation.
La zone de travail réapparaît, et le champ de relation est maintenant marqué du nom convivial que vous avez fourni précédemment. Le nom de la relation est également répertorié dans le rail de gauche pour en faciliter la référence.
Si vous affichez la structure du schéma de référence, le marqueur de relation s’affiche en regard du champ d’identité principale du schéma et dans le rail de gauche.
Modification d’une relation de schéma B2B
Une fois qu’une relation de schéma est établie, sélectionnez le champ de relation dans le schéma source, puis Modifier la relation.

La boîte de dialogue Modifier la relation s’affiche. À partir de cette boîte de dialogue, vous pouvez modifier le schéma de référence et les noms des relations, ou supprimer la relation. Le type de relation multiple-à-un ne peut pas être modifié.
Pour maintenir l’intégrité des données et éviter toute perturbation de la segmentation et d’autres processus, tenez compte des instructions suivantes lors de la gestion des relations de schémas avec des jeux de données liés :
- Évitez de supprimer directement des relations si un schéma est associé à un jeu de données, car cela peut avoir un impact négatif sur la segmentation. Supprimez plutôt le jeu de données associé avant de supprimer la relation.
- Vous ne pouvez pas modifier le schéma de référence sans supprimer au préalable la relation existante. Toutefois, cette opération doit être effectuée avec précaution, car la suppression d’une relation avec un jeu de données associé peut avoir des conséquences inattendues.
- L’ajout de nouvelles relations à un schéma avec des jeux de données liés existants peut ne pas fonctionner comme prévu et pourrait entraîner des conflits potentiels.
Filtrer et rechercher des relations
Vous pouvez filtrer et rechercher des relations spécifiques dans vos schémas à partir de l’onglet Relations de l’espace de travail Schémas. Vous pouvez utiliser cette vue pour localiser et gérer rapidement vos relations. Lisez le document exploration des ressources de schéma pour obtenir des instructions détaillées sur les options de filtrage.
Étapes suivantes
En suivant ce tutoriel, vous avez réussi à créer une relation multiple-à-un entre deux schémas à l’aide de l’Schema Editor . Une fois que les données ont été ingérées à l’aide de jeux de données basés sur ces schémas et que ces données ont été activées dans la banque de données de profils, vous pouvez utiliser les attributs des deux schémas pour les cas d’utilisation de la segmentation multiclasse.