(Version bêta) Espaces de noms et schémas B2B

IMPORTANT

Cette fonctionnalité est actuellement en version bêta. La documentation et la fonctionnalité peuvent changer.

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 Postman environnement.

  • Vous pouvez télécharger la collection et l’environnement de génération automatique de l’espace de noms et du schéma à 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 sur 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 authentification et accès aux API Experience Platform.
  • Pour plus d’informations sur la configuration Postman pour les API Platform, consultez le tutoriel sur configuration de Developer Console et Postman.

Avec une console de développement Platform et Postman configuré. vous pouvez maintenant commencer à appliquer les valeurs d’environnement appropriées à votre Postman environnement.

Le tableau suivant contient des exemples de valeurs ainsi que des informations supplémentaires sur le remplissage de vos Postman environnement :

Variable Description Exemple
CLIENT_SECRET Identifiant unique utilisé pour générer votre {ACCESS_TOKEN}. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de récupérer votre {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN Le jeton Web JSON (JWT) est un identifiant d’authentification utilisé pour générer votre {ACCESS_TOKEN}. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de générer votre {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Identifiant unique utilisé pour authentifier les appels vers les API Experience Platform. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de récupérer votre {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN Jeton d’autorisation requis pour terminer les appels vers les API Experience Platform. Voir le tutoriel sur authentification et accès aux API Experience Platform pour plus d’informations sur la manière de récupérer votre {ACCESS_TOKEN}. 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 global conteneur contient toutes les classes fournies par les Adobes standard et les partenaires Experience Platform, les groupes de champs de schéma, les types de données et les schémas. En ce qui concerne Marketo, cette valeur est fixe et est toujours définie sur global. global
PRIVATE_KEY Informations d’identification utilisées pour authentifier vos Postman aux API Experience Platform. Consultez le tutoriel sur la configuration de Developer Console et configuration de Developer Console et Postman pour obtenir des instructions sur la manière de récupérer votre {PRIVATE_KEY}. {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Informations d’identification utilisées pour l’intégration à Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS Le système Identity Management (IMS) fournit la structure d’authentification des 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 Personne morale pouvant posséder ou accorder une licence pour des produits et des services et permettre l’accès à ses membres. Voir le tutoriel sur configuration de Developer Console et Postman pour obtenir des instructions sur la manière de récupérer votre {IMS_ORG} informations. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Nom de la partition d’environnement de test virtuel que vous utilisez. prod
TENANT_ID Identifiant utilisé pour vous assurer que les ressources que vous créez sont correctement placées dans l’espace de noms et qu’elles sont contenues dans votre organisation IMS. b2bcdpproductiontest
PLATFORM_URL Le point de terminaison d’URL vers lequel vous effectuez des appels d’API. Cette valeur est fixe et est toujours définie sur : http://platform.adobe.io/. http://platform.adobe.io/

Exécution des scripts

Avec votre Postman configuration de la collection et de l’environnement, vous pouvez désormais exécuter le script via la Postman .

Dans le 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.

root-folder

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

run-generator

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 servent à distinguer le contexte ou le type d’identité. Une identité complète est composée d’une valeur d’identifiant et d’un espace de noms. Voir présentation des espaces de noms pour 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.

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité 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 personne d’opportunité B2B b2b_opportunity_person_relation B2B_OPPORTUNITY_PERSON
Campagne B2B b2b_campaign B2B_CAMPAIGN
Membre de campagne B2B b2b_campaign_member B2B_CAMPAIGN_MEMBER
Liste marketing B2B b2b_marketing_list B2B_MARKETING_LIST
Membre de liste marketing B2B b2b_marketing_list_member B2B_MARKETING_LIST_MEMBER
Relation entre les personnes d’un 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 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 de schéma.

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.

REMARQUE

Faites défiler vers la gauche ou vers la droite pour consulter l’intégralité du tableau.

Nom du schéma Classe de base Groupes de champs Profile schéma in Identité Principal Espace de noms d’identité Principal Identité Secondaire Espace de noms d’identité Secondaire Relation Notes
Compte B2B Compte d’entreprise XDM Détails du compte commercial 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 d’entreprise 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
  • Informations détaillées sur les personnes commerciales XDM
  • Composants de personne active XDM
  • IdentityMap
  • Détails du consentement et des préférences
Activé b2b.personKey.sourceKey dans le groupe de champs Détails de la personne professionnelle XDM Personne B2B
  1. extSourceSystemAudit.externalKey.sourceKey du groupe de champs Détails de la personne active XDM
  2. workEmail.address du groupe de champs Détails de la personne active XDM
  1. Personne B2B
  2. Adresse e-mail
  • personComponents.sourceAccountKey.sourceKey du groupe de champs Composants de personne professionnelle XDM
  • Type : Multiple-à-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
Opportunité B2B Opportunités commerciales XDM Détails des opportunités commerciales 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 : Multiple-à-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
Relation de personne d’opportunité B2B Relation de personne avec les opportunités commerciales XDM Aucun Activé opportunityPersonKey.sourceKey dans la classe de base Relation de personne d’opportunité B2B extSourceSystemAudit.externalKey.sourceKey dans la classe de base Relation de personne d’opportunité B2B Première relation
  • personKey.sourceKey dans la classe de base
  • Type : Multiple-à-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.sourceKey dans la classe de base
  • Type : Multiple-à-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
Campagne B2B Campagne commerciale XDM Détails des campagnes commerciales XDM Activé campaignKey.sourceKey dans la classe de base Campagne B2B extSourceSystemAudit.externalKey.sourceKey dans la classe de base Campagne B2B
Membre de campagne B2B Membres de XDM Business Campaign Détails des membres XDM Business Campaign Activé ccampaignMemberKey.sourceKey dans la classe de base Membre de campagne B2B extSourceSystemAudit.externalKey.sourceKey dans la classe de base Membre de campagne B2B Première relation
  • personKey.sourceKey dans la classe de base
  • Type : Multiple-à-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.sourceKey dans la classe de base
  • Type : Multiple-à-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 : Campagne
  • Nom de la relation à partir du schéma de référence : Personnes
Liste marketing B2B Liste XDM Business Marketing Aucun Activé marketingListKey.sourceKey dans la classe de base Liste marketing B2B Aucun Aucun Aucun La liste statique n’est pas synchronisée à partir de Salesforce et ne possède donc pas d’identité secondaire.
Membre de liste marketing B2B Membres de la liste XDM Business Marketing Aucun Activé marketingListMemberKey.sourceKey dans la classe de base Membre de liste marketing B2B Aucun Aucun Première relation
  • PersonKey.sourceKey dans la classe de base
  • Type : Multiple-à-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 : Multiple-à-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
Le membre de liste statique n’est pas synchronisé à partir de Salesforce et ne possède donc pas d’identité secondaire.
Activité B2B XDM ExperienceEvent
  • Visite WebPage
  • Nouvelle piste
  • Convertir le prospect
  • Ajouter à la liste
  • Supprimer de la liste
  • Ajouter à l’opportunité
  • Supprimer de l’opportunité
  • Formulaire rempli
  • Clics sur les liens
  • Email diffusé
  • Courrier électronique ouvert
  • Courrier électronique cliqué
  • Email bounce
  • Email Bounce Soft
  • Désabonnement du courrier électronique
  • Score modifié
  • Opportunité mise à jour
  • État dans la progression de la campagne modifiée
  • Identifiant de personne
  • URL web Marketo
  • Moment intéressant
Activé personKey.sourceKey du groupe de champs Identifiant de personne Personne B2B Aucun Aucun Première relation
  • listOperations.listKey.sourceKey field
  • Type : un-à-un
  • Schéma de référence : Liste marketing B2B
  • Espace de noms : Liste marketing B2B
Deuxième relation
  • opportunityEvent.opportunityKey.sourceKey field
  • Type : un-à-un
  • Schéma de référence : Opportunité B2B
  • Espace de noms : Opportunité B2B
Troisième relation
  • leadOperation.campaignProgression.campaignKey.sourceKey field
  • 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 est la personne qui a effectué l’activité.
Relation entre les personnes d’un compte B2B Relation avec la personne du compte d’entreprise XDM Mappage d’identités Activé accountPersonKey.sourceKey dans la classe de base Relation entre les personnes d’un compte B2B Aucun Aucun Première relation
  • personKey.sourceKey dans la classe de base
  • Type : Multiple-à-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 : Multiple-à-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 votre Marketo data to Platform, consultez le tutoriel sur création d’un connecteur source Marketo dans l’interface utilisateur.

Sur cette page