Espaces de noms et schémas B2B

AVAILABILITY
Vous devez avoir accès à Adobe Real-Time Customer Data Platform B2B edition pour que vos schémas B2B soient qualifiés dans Real-Time Customer Profile.
NOTE
Vous pouvez utiliser des modèles dans l’interface utilisateur de Adobe Experience Platform pour accélérer la création de ressources pour les données B2B et B2C. Pour plus d’informations, consultez le guide sur l’utilisation de modèles dans l’interface utilisateur d’Experience Platform.

Lisez ce document pour plus d’informations sur la configuration sous-jacente des espaces de noms et des schémas à utiliser avec les sources B2B. Ce document fournit également des détails sur la configuration de votre utilitaire d’automatisation Postman requis pour générer des espaces de noms et des schémas B2B.

Configurer l’utilitaire de génération automatique de schémas et d’espaces de noms B2B

IMPORTANT
Les informations d’identification du compte de service (JWT) ont été abandonnées. Vous devez vous assurer de migrer votre application ou votre intégration vers les nouvelles informations d’identification de serveur à serveur OAuth avant le 27 janvier 2025. Lisez la documentation suivante pour obtenir des instructions détaillées sur comment migrer vos informations d’identification JWT vers les informations d’identification OAuth de serveur à serveur.

Pour obtenir les informations préalables requises sur la configuration de votre environnement Postman pour prendre en charge l’utilitaire de génération automatique d’espaces de noms et de schémas B2B, consultez la documentation suivante.

Grâce à la console de développement et à la configuration des Postman d’Experience Platform, vous pouvez maintenant commencer à appliquer les valeurs d’environnement appropriées à votre environnement de Postman.

Le tableau suivant contient des exemples de valeurs ainsi que des informations supplémentaires sur la population de votre environnement Postman :

Variable
Description
Exemple
CLIENT_SECRET
Identifiant unique utilisé pour générer votre {ACCESS_TOKEN}. Pour plus d’informations sur la récupération de vos {CLIENT_SECRET}, consultez le tutoriel sur l’authentification et l’accès aux API Experience Platform.
{CLIENT_SECRET}
API_KEY
Identifiant unique utilisé pour authentifier les appels aux API Experience Platform. Pour plus d’informations sur la récupération de vos {API_KEY}, consultez le tutoriel sur l’authentification et l’accès aux API Experience Platform.
c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
Jeton d’autorisation requis pour effectuer des appels vers les API Experience Platform. Pour plus d’informations sur la récupération de vos {ACCESS_TOKEN}, consultez le tutoriel sur l’authentification et l’accès aux API Experience Platform.
Bearer {ACCESS_TOKEN}
META_SCOPE
En ce qui concerne Marketo, cette valeur est fixe et est toujours définie sur : ent_dataservices_sdk.
ent_dataservices_sdk
CONTAINER_ID
Le conteneur global contient toutes les classes, groupes de champs de schéma, types de données et schémas fournis par les partenaires standard d’Adobe et d’Experience Platform. En ce qui concerne Marketo, cette valeur est fixe et est toujours définie sur global.
global
TECHNICAL_ACCOUNT_ID
Informations d’identification utilisées pour intégrer à Adobe I/O.
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
Le système Identity Management (IMS) fournit la structure pour l’authentification aux services Adobe. En ce qui concerne Marketo, cette valeur est fixe et est toujours définie sur : ims-na1.adobelogin.com.
ims-na1.adobelogin.com
IMS_ORG
Entité d’entreprise pouvant posséder des produits et services ou en obtenir la licence et permettre l’accès à ses membres. Consultez le tutoriel sur configuration de Developer Console et Postman pour obtenir des instructions sur la récupération de vos informations de {ORG_ID}.
ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
Nom de la partition de sandbox virtuelle que vous utilisez.
prod
TENANT_ID
Identifiant utilisé pour s’assurer que les ressources que vous créez ont un espace de noms correct et sont contenues dans votre organisation.
b2bcdpproductiontest
PLATFORM_URL
Point d’entrée de l’URL vers lequel vous effectuez des appels API. Cette valeur est fixe et est toujours définie sur : http://platform.adobe.io/.
http://platform.adobe.io/

Exécution des scripts

Une fois votre collection de Postman et votre environnement configurés, vous pouvez exécuter le script via l’interface Postman.

Dans l’interface Postman, sélectionnez le dossier racine de l’utilitaire de génération automatique, puis sélectionnez Run dans l’en-tête supérieur.

Dossier racine du générateur d’espaces de noms et de schémas dans l’interface utilisateur de Postman. « Exécutions » est mis en surbrillance dans la barre de menus supérieure.

L’interface Runner s’affiche. À partir de là, assurez-vous que toutes les cases à cocher sont sélectionnées, puis sélectionnez Run Namespaces and Schemas Autogeneration Utility.

L’interface Runner de l’interface utilisateur de Postman avec plusieurs requêtes dans la collection Espaces de noms et Schémas cochées et le bouton « Exécuter les espaces de noms et les schémas » mis en surbrillance sur le côté droit.

Une requête réussie crée les espaces de noms et les schémas requis pour B2B.

Espaces de noms B2B

Les espaces de noms d’identité sont des composants d’Identity Service qui servent à distinguer le contexte d’une identité. Une identité complète comprend une valeur d’identité et un espace de noms. Lisez la Présentation des espaces de nomspour plus d’informations.

Les espaces de noms B2B sont utilisés dans l’identité principale de l’entité.

Le tableau suivant contient des informations sur la configuration sous-jacente des espaces de noms B2B.

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Nom d’affichage
Symbole d’identité
Type d’identité
Personne B2B
b2b_person
CROSS_DEVICE
Compte B2B
b2b_account
B2B_ACCOUNT
Opportunité B2B
b2b_opportunity
B2B_OPPORTUNITY
Relation de la personne avec l’opportunité B2B
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
Campagne B2B
b2b_campaign
B2B_CAMPAIGN
Membre de la campagne B2B
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
Liste marketing B2B
b2b_marketing_list
B2B_MARKETING_LIST
Membre de la liste marketing B2B
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
Relation avec la personne du compte B2B
b2b_account_person_relation
B2B_ACCOUNT_PERSON

Schémas B2B

Experience Platform utilise des schémas pour décrire la structure des données de manière cohérente et réutilisable. En définissant les données de manière cohérente sur l’ensemble des systèmes, il est plus simple de leur donner du sens et donc d’en tirer profit.

Avant que les données puissent être ingérées dans Experience Platform, un schéma doit être créé pour décrire la structure des données et fournir des contraintes au type de données pouvant être contenu dans chaque champ. Les schémas se composent d’une classe de base et de zéro ou plusieurs groupes de champs.

Pour plus d’informations sur le modèle de composition de schémas, y compris sur les principes de conception et les bonnes pratiques, consultez les bases de la composition de schémas.

Le tableau suivant contient des informations sur la configuration sous-jacente des schémas B2B.

NOTE
Veuillez faire défiler la page vers la gauche/droite pour consulter le contenu complet du tableau.
Nom du schéma
Classe de base
Groupes de champs
Profile dans le schéma
Identité principale
Espace de noms d’identité principal
identité Secondaire
Espace de noms d’identité Secondaire
Relation
Notes
Compte B2B
Compte professionnel XDM
Détails du compte professionnel XDM
Activé
accountKey.sourceKey dans la classe de base
Compte B2B
extSourceSystemAudit.externalKey.sourceKey dans la classe de base
Compte B2B
  • accountParentKey.sourceKey dans le groupe de champs Détails du compte professionnel XDM
  • Propriété de destination : /accountKey/sourceKey
  • Type : un à un
  • Schéma de référence : compte B2B
  • Espace De Noms : Compte B2B
Personne B2B
XDM Individual Profile
  • Détails de professionnel XDM
  • Composants de professionnel XDM
  • IdentityMap
  • Détails relatifs au consentement et aux préférences
Activé
b2b.personKey.sourceKey dans le groupe de champs Détails professionnels XDM
Personne B2B
  1. extSourceSystemAudit.externalKey.sourceKey du groupe de champs Détails professionnels XDM
  2. workEmail.address du groupe de champs Détails professionnels XDM
  1. Personne B2B
  2. E-mail
  • personComponents.sourceAccountKey.sourceKey du groupe de champs Composants professionnels XDM .
  • Type : plusieurs à un
  • Schéma De Référence : Compte B2B
  • Espace De Noms : Compte B2B
  • Propriété de destination : accountKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Compte
  • Nom de la relation du schéma de référence : Personnes
Opportunité B2B
Opportunité commerciale XDM
Détails de l’opportunité commerciale XDM
Activé
opportunityKey.sourceKey dans la classe de base
Opportunité B2B
extSourceSystemAudit.externalKey.sourceKey dans la classe de base
Opportunité B2B
  • accountKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Compte B2B
  • Espace De Noms : Compte B2B
  • Propriété de destination : accountKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Compte
  • Nom de la relation du schéma de référence : Opportunités
Relation de la personne avec l’opportunité B2B
Relation de la personne avec l’opportunité commerciale XDM
Aucune
Activé
opportunityPersonKey.sourceKey dans la classe de base
Relation de la personne avec l’opportunité B2B
extSourceSystemAudit.externalKey.sourceKey dans la classe de base
Relation de la personne avec l’opportunité B2B

Première relation

  • personKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Personne B2B
  • Espace De Noms : Personne B2B
  • Propriété de destination : b2b.personKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Personne
  • Nom de la relation du schéma de référence : Opportunités

Deuxième relation

  • opportunityKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Opportunité B2B
  • Espace de noms : opportunité B2B
  • Propriété de destination : opportunityKey.sourceKey
  • Nom de la relation à partir du schéma actuel : opportunité
  • Nom de la relation du schéma de référence : Personnes
Campagne B2B
XDM Business Campaign
Détails de XDM Business Campaign
Activé
campaignKey.sourceKey dans la classe de base
Campagne B2B
extSourceSystemAudit.externalKey.sourceKey dans la classe de base
Campagne B2B
Membre de la campagne B2B
Membres de la campagne commerciale XDM
Détails du membre de la campagne commerciale XDM
Activé
ccampaignMemberKey.sourceKey dans la classe de base
Membre de la campagne B2B
extSourceSystemAudit.externalKey.sourceKey dans la classe de base
Membre de la campagne B2B

Première relation

  • personKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Personne B2B
  • Espace De Noms : Personne B2B
  • Propriété de destination : b2b.personKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Personne
  • Nom de la relation du schéma de référence : Campagnes

Deuxième relation

  • campaignKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Campagne B2B
  • Espace de noms : Campagne B2B
  • Propriété de destination : campaignKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Campaign
  • Nom de la relation du schéma de référence : Personnes
Liste marketing B2B
Liste marketing professionnelle XDM
Aucune
Activé
marketingListKey.sourceKey dans la classe de base
Liste marketing B2B
Aucune
Aucune
Aucune
La liste statique n’est pas synchronisée à partir de Salesforce et n’a donc pas d’identité secondaire.
Membre de la liste marketing B2B
Membres de la liste marketing professionnelle XDM
Aucune
Activé
marketingListMemberKey.sourceKey dans la classe de base
Membre de la liste marketing B2B
Aucune
Aucune

Première relation

  • PersonKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Personne B2B
  • Espace De Noms : Personne B2B
  • Propriété de destination : b2b.personKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Personne
  • Nom de la relation à partir du schéma de référence : Listes marketing

Deuxième relation

  • marketingListKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Liste Marketing B2B
  • Espace De Noms : Liste Marketing B2B
  • Propriété de destination : marketingListKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Liste marketing
  • Nom de la relation du schéma de référence : Personnes
Le membre de liste statique n’est pas synchronisé à partir de Salesforce et n’a donc pas d’identité secondaire.
Activité B2B
XDM ExperienceEvent
  • Visiter la page web
  • Nouveau prospect
  • Convertir le prospect
  • Ajouter à la liste
  • Supprimer de la liste
  • Ajouter à l’opportunité
  • Supprimer de l’opportunité
  • Formulaire complété
  • Clics sur les liens
  • E-mail remis
  • E-mail ouvert
  • E-mail faisant l’objet d’un clic
  • E-mail non remis
  • Non-remise temporaire de l’e-mail
  • E-mail : désabonné
  • Score modifié
  • Opportunité mise à jour
  • Statut modifié dans la progression de la campagne
  • Identifiant de la personne
  • URL Web Marketo
  • Moment intéressant
  • Appeler le Webhook
  • Modifier le rythme de la campagne
  • Étape de revenu modifiée
  • Fusionner les prospects
  • E-mail envoyé
  • Modifier le flux de la campagne
  • Ajouter à la campagne
Activé
personKey.sourceKey du groupe de champs Identifiant de personne
Personne B2B
Aucune
Aucune

Première relation

  • champ listOperations.listKey.sourceKey
  • Type : un à un
  • Schéma De Référence : Liste Marketing B2B
  • Espace De Noms : Liste Marketing B2B

Deuxième relation

  • champ opportunityEvent.opportunityKey.sourceKey
  • Type : un à un
  • Schéma De Référence : Opportunité B2B
  • Espace de noms : opportunité B2B

Troisième relation

  • champ leadOperation.campaignProgression.campaignKey.sourceKey
  • Type : un à un
  • Schéma De Référence : Campagne B2B
  • Espace de noms : Campagne B2B
ExperienceEvent est différent des entités. L’identité de l’événement d’expérience correspond à la personne qui a réalisé l’activité.
Relation avec la personne du compte B2B
Relation avec la personne du compte professionnel XDM
Mappage d’identités
Activé
accountPersonKey.sourceKey dans la classe de base
Relation avec la personne du compte B2B
Aucune
Aucune

Première relation

  • personKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Personne B2B
  • Espace De Noms : Personne B2B
  • Propriété de destination : b2b.personKey.SourceKey
  • Nom de la relation à partir du schéma actuel : Personnes
  • Nom de la relation à partir du schéma de référence : Compte

Deuxième relation

  • accountKey.sourceKey dans la classe de base
  • Type : plusieurs à un
  • Schéma De Référence : Compte B2B
  • Espace De Noms : Compte B2B
  • Propriété de destination : accountKey.sourceKey
  • Nom de la relation à partir du schéma actuel : Compte
  • Nom de la relation du schéma de référence : Personnes

Étapes suivantes

Pour découvrir comment connecter vos données Marketo à Experience Platform, consultez le tutoriel sur la création d’un connecteur source Marketo dans l’interface utilisateur.

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089