Espaces de noms et schémas B2B
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
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.
- Vous pouvez télécharger la collection d’utilitaires et l’environnement de génération automatique d’espace de noms et de schéma à partir de ce référentiel GitHub.
- Pour plus d’informations sur l’utilisation des API Experience Platform, notamment sur la collecte des valeurs des en-têtes requis et la lecture d’exemples d’appels d’API, consultez le guide Prise en main des API Experience Platform.
- Pour plus d’informations sur la génération de vos informations d’identification pour les API Experience Platform, consultez le tutoriel sur l’authentification et accès aux API Experience Platform.
- Pour plus d’informations sur la configuration de Postman pour les API Experience Platform, consultez le tutoriel sur configuration de Developer Console et Postman.
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 :
CLIENT_SECRET
{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
{API_KEY}
, consultez le tutoriel sur l’authentification et l’accès aux API Experience Platform.c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
, consultez le tutoriel sur l’authentification et l’accès aux API Experience Platform.Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
.ent_dataservices_sdk
CONTAINER_ID
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
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
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.
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.
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.
b2b_person
CROSS_DEVICE
b2b_account
B2B_ACCOUNT
b2b_opportunity
B2B_OPPORTUNITY
b2b_opportunity_person_relation
B2B_OPPORTUNITY_PERSON
b2b_campaign
B2B_CAMPAIGN
b2b_campaign_member
B2B_CAMPAIGN_MEMBER
b2b_marketing_list
B2B_MARKETING_LIST
b2b_marketing_list_member
B2B_MARKETING_LIST_MEMBER
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.
accountKey.sourceKey
dans la classe de baseextSourceSystemAudit.externalKey.sourceKey
dans la classe de baseaccountParentKey.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
- Détails de professionnel XDM
- Composants de professionnel XDM
- IdentityMap
- Détails relatifs au consentement et aux préférences
b2b.personKey.sourceKey
dans le groupe de champs Détails professionnels XDMextSourceSystemAudit.externalKey.sourceKey
du groupe de champs Détails professionnels XDMworkEmail.address
du groupe de champs Détails professionnels XDM
- Personne B2B
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
opportunityKey.sourceKey
dans la classe de baseextSourceSystemAudit.externalKey.sourceKey
dans la classe de baseaccountKey.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
opportunityPersonKey.sourceKey
dans la classe de baseextSourceSystemAudit.externalKey.sourceKey
dans la classe de basePremiè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
campaignKey.sourceKey
dans la classe de baseextSourceSystemAudit.externalKey.sourceKey
dans la classe de baseccampaignMemberKey.sourceKey
dans la classe de baseextSourceSystemAudit.externalKey.sourceKey
dans la classe de basePremiè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
marketingListKey.sourceKey
dans la classe de basemarketingListMemberKey.sourceKey
dans la classe de basePremiè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
- 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
personKey.sourceKey
du groupe de champs Identifiant de personnePremiè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é.accountPersonKey.sourceKey
dans la classe de basePremiè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.