Espaces de noms et schémas B2B
Ce document fournit des informations sur la configuration sous-jacente des espaces de noms et des schémas à utiliser avec des 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.
Configuration des espaces de noms B2B et de l’utilitaire de génération automatique de schéma
La première étape de l’utilisation de l’espace de noms B2B et de l’utilitaire de génération automatique de schéma consiste à configurer votre console de développement Platform et votre environnement Postman.
- Vous pouvez télécharger l’espace de noms et l’environnement de génération automatique de schémas à partir de ce référentiel GitHub.
- Pour plus d’informations sur l’utilisation des API Platform, y compris sur la manière de rassembler des valeurs pour les en-têtes requis et de lire des exemples d’appels API, consultez le guide de prise en main des API Platform.
- Pour plus d’informations sur la génération de vos informations d’identification pour les API 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 Platform, consultez le tutoriel sur la configuration de la console de développement et Postman.
Avec une console de développement Platform et Postman configurée, vous pouvez maintenant commencer à appliquer les valeurs d’environnement appropriées à votre environnement Postman.
Le tableau suivant contient des exemples de valeurs ainsi que des informations supplémentaires sur le remplissage de votre environnement Postman :
CLIENT_SECRET{ACCESS_TOKEN}. Pour plus d’informations sur la récupération de votre {CLIENT_SECRET}, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .{CLIENT_SECRET}JWT_TOKEN{JWT_TOKEN}, consultez le tutoriel sur l’ authentification et l’accès aux API Experience Platform .{JWT_TOKEN}API_KEY{API_KEY}, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKEN{ACCESS_TOKEN}, consultez le tutoriel sur l’ authentification et accès aux API Experience Platform .Bearer {ACCESS_TOKEN}META_SCOPEent_dataservices_sdk.ent_dataservices_sdkCONTAINER_IDglobal contient toutes les classes d’Adobe standard et de partenaire Experience Platform fournies, les groupes de champs de schéma, les types de données et les schémas. Concernant Marketo, cette valeur est fixe et est toujours définie sur global.globalPRIVATE_KEY{PRIVATE_KEY}TECHNICAL_ACCOUNT_IDD42AEVJZTTJC6LZADUBVPA15@techacct.adobe.comIMSims-na1.adobelogin.com.ims-na1.adobelogin.comIMS_ORG{ORG_ID}.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgSANDBOX_NAMEprodTENANT_IDb2bcdpproductiontestPLATFORM_URLhttp://platform.adobe.io/.http://platform.adobe.io/Exécution des scripts
Avec votre collection Postman et votre environnement configuré, vous pouvez désormais 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 un composant de Identity Service qui sert à distinguer le contexte d’une identité. Une identité entièrement qualifiée comprend une valeur d’identité et un espace de noms. Pour plus d’informations, consultez la présentation des espaces de noms .
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_personCROSS_DEVICEb2b_accountB2B_ACCOUNTb2b_opportunityB2B_OPPORTUNITYb2b_opportunity_person_relationB2B_OPPORTUNITY_PERSONb2b_campaignB2B_CAMPAIGNb2b_campaign_memberB2B_CAMPAIGN_MEMBERb2b_marketing_listB2B_MARKETING_LISTb2b_marketing_list_memberB2B_MARKETING_LIST_MEMBERb2b_account_person_relationB2B_ACCOUNT_PERSONSché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 Platform, il est nécessaire de composer un schéma pour décrire la structure des données et fournir des contraintes au type de données pouvant être contenues 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.sourceKeydans le groupe de champs Détails du compte d’entreprise XDM- Propriété de destination :
/accountKey/sourceKey - Type : un pour 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 de la personne professionnelle XDMextSourceSystemAudit.externalKey.sourceKeydu groupe de champs Détails de la personne professionnelle XDMworkEmail.addressdu groupe de champs Détails de la personne professionnelle XDM
- Personne B2B
personComponents.sourceAccountKey.sourceKeydu groupe de champs Composants de personne professionnelle 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 à partir du schéma de référence : Personnes
opportunityKey.sourceKey dans la classe de baseextSourceSystemAudit.externalKey.sourceKey dans la classe de baseaccountKey.sourceKeydans 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 à partir 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.sourceKeydans 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 : opportunités
Deuxième relation
opportunityKey.sourceKeydans 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 à partir 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.sourceKeydans 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 : Campagnes
Deuxième relation
campaignKey.sourceKeydans 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 à partir du schéma de référence : Personnes
marketingListKey.sourceKey dans la classe de basemarketingListMemberKey.sourceKey dans la classe de basePremière relation
PersonKey.sourceKeydans 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.sourceKeydans 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 à partir du schéma de référence : Personnes
- Visite WebPage
- 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
- État dans la progression de la campagne modifiée
- 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 à Campaign
personKey.sourceKey du groupe de champs Identifiant de personnePremière relation
- Champ
listOperations.listKey.sourceKey - Type : un pour 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 pour un
- Schéma de référence : opportunité B2B
- Espace de noms : opportunité B2B
Troisième relation
- Champ
leadOperation.campaignProgression.campaignKey.sourceKey - Type : un pour 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 est la personne qui a effectué l’activité.accountPersonKey.sourceKey dans la classe de basePremière relation
personKey.sourceKeydans 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.sourceKeydans 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 à partir du schéma de référence : Personnes
Étapes suivantes
Pour savoir comment connecter vos données Marketo à Platform, consultez le tutoriel sur la création d’un connecteur source Marketo dans l’interface utilisateur.