DocumentationExperience PlatformGuide de modèle de données d’expérience (XDM)

Définir une relation plusieurs-à-un entre deux schémas dans l’édition B2B de Real-time Customer Data Platform

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

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 :

Relations de classe B2B

Ce tutoriel décrit les étapes à suivre pour définir une relation multiple-à-un entre deux schémas dans Real-Time CDP B2B edition.

NOTE
Si vous n’utilisez pas Real-Time Customer Data Platform B2B edition ou souhaitez créer une relation un-à-un, consultez le guide sur la création d’une relation un-à-un à la place.
Ce tutoriel se concentre sur la manière d’établir manuellement des relations entre les schémas B2B dans l’interface utilisateur d’Experience Platform. Si vous importez des données à partir d’une connexion source B2B, vous pouvez utiliser un utilitaire de génération automatique pour créer les schémas, identités et relations requis à la place. Consultez la documentation sur les sources relative aux espaces de noms et aux schémas B2B pour plus d’informations sur l’utilisation de l’utilitaire de génération automatique.

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.

champ sourceKey

NOTE
Lors de la définition d’un champ XDM en tant qu’identité, vous devez fournir un espace de noms d’identité pour définir l’identité sous. Il peut s’agir d’un espace de noms standard fourni par Adobe ou d’un espace de noms personnalisé défini par votre organisation. En pratique, l’espace de noms est simplement une chaîne contextuelle et peut être défini sur n’importe quelle valeur, à condition qu’il soit significatif pour votre organisation lors de la classification du type d’identité. Pour plus d’informations, consultez la présentation des espaces de noms d’identité.

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

Schéma d’opportunités dans l’éditeur de schémas avec l’objet opportunitéKey et le bouton (bascule) Activer pour le profil mis en surbrillance.

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.

Schéma Comptes dans l’éditeur de schémas avec l’objet accountKey et le bouton Activer pour le profil mis en surbrillance.

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.

NOTE
Actuellement, seules les relations multiples-à-un et un-à-un peuvent être définies d’un schéma source vers un schéma de référence. Pour les relations de type « un à plusieurs », vous devez définir le champ de relation dans le schéma qui représente le « plusieurs ».

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.

L’éditeur de schémas avec le champ sourceKey et l’option Ajouter une relation mise en surbrillance.

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.

La boîte de dialogue Ajouter une relation avec la relation de schéma plusieurs-à-un mise en surbrillance.

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.

NOTE
La liste des schémas de référence disponibles est filtrée afin de ne contenir que les schémas appropriés. Les schémas doivent disposent d’une identité principale attribuée et doivent être soit une classe B2B, soit la classe Individual Profile. Les schémas de classe de prospects ne peuvent pas avoir de relations.

La boîte de dialogue Ajouter une relation avec les champs Schéma de référence et Espace de noms d’identité de référence en surbrillance.

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.

NOTE
Les noms des relations doivent comporter 35 caractères maximum.

La boîte de dialogue Ajouter une relation avec les champs Nom de la relation mis en surbrillance.

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.

Application du nouveau nom de relation à l’éditeur de schémas.

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.

Schéma de destination dans l’éditeur de schémas avec le nouveau marqueur de relation mis en surbrillance.

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.

NOTE
Pour afficher toutes les relations associées, sélectionnez le champ Identité principale dans le schéma de référence, suivi de Afficher les relations.
L’éditeur de schémas avec un champ de relation sélectionné et Afficher la relation en surbrillance.

Éditeur de schémas avec un champ de relation et Modifier la relation en surbrillance.

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

Boîte de dialogue Modifier la relation.

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.

Onglet Relations de l’espace de travail Schémas.

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

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