(bêta) Marketo Engage espaces de nommage et schémas

IMPORTANT

La source Marketo Engage est actuellement en version bêta. La fonction et la documentation sont des sujets de modification.

Le présent document fournit des informations sur la configuration sous-jacente des espaces de nommage et schémas B2B utilisés avec Marketo Engage (ci-après dénommés "Marketo"). Ce document fournit également des détails sur la configuration de votre utilitaire d'automatisation Postman nécessaire à la génération d'Marketo espaces de nommage et schémas B2B.

Configuration de l’utilitaire de génération automatique d’espace de nommage et de schéma Marketo

La première étape de l'utilisation de l'utilitaire de génération automatique d'espace de nommage et de schéma Marketo consiste à configurer votre console de développement de plate-forme et votre environnement Postman.

Avec une console de développement de plate-forme et Postman configurée, vous pouvez maintenant début d'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 :

Variable Description Exemple
CLIENT_SECRET Identificateur unique utilisé pour générer votre {ACCESS_TOKEN}. Consultez le didacticiel sur l'authentification et l'accès aux API Experience Platform pour savoir comment récupérer votre {CLIENT_SECRET}. {CLIENT_SECRET}
JWT_TOKEN Le JSON Web Token (JWT) est un jeu d’informations d’identification d’authentification utilisé pour générer votre {ACCESS_TOKEN}. Consultez le didacticiel sur l'authentification et l'accès aux API Experience Platform pour savoir comment générer votre {JWT_TOKEN}. {JWT_TOKEN}
API_KEY Identificateur unique utilisé pour authentifier les appels aux API Experience Platform. Consultez le didacticiel sur l'authentification et l'accès aux API Experience Platform pour savoir comment récupérer votre {API_KEY}. c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN Jeton d’autorisation requis pour terminer les appels aux API Experience Platform. Consultez le didacticiel sur l'authentification et l'accès aux API Experience Platform pour savoir comment récupérer votre {ACCESS_TOKEN}. Bearer {ACCESS_TOKEN}
META_SCOPE En ce qui concerne Marketo, cette valeur est fixe et toujours définie sur : ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID Le conteneur global contient tous les Adobes standard et les partenaires Experience Platform fournis par des classes, des groupes de champs de schéma, des types de données et des schémas. En ce qui concerne Marketo, cette valeur est fixe et toujours définie sur global. global
PRIVATE_KEY Informations d’identification utilisées pour authentifier votre instance Postman auprès des API Experience Platform. Consultez le didacticiel sur la configuration de la console de développement et la configuration de la console de développement et Postman pour savoir comment récupérer votre {PRIVATE_KEY}. {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Informations d’identification utilisées pour l’intégration à l’Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS Le système Identity Management (IMS) fournit le cadre d'authentification aux services d'Adobe. En ce qui concerne Marketo, cette valeur est fixe et toujours définie sur : ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG Entité corporative qui peut posséder ou mettre sous licence des produits et services et autoriser l'accès à ses membres. Consultez le didacticiel sur la configuration de la console de développement et Postman pour savoir comment récupérer vos {IMS_ORG} informations. ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Nom de la partition sandbox virtuelle que vous utilisez. prod
TENANT_ID ID utilisé pour vous assurer que les ressources que vous créez sont correctement espacées dans l’espace de noms et qu’elles sont contenues dans votre organisation IMS. b2bcdpproductiontest
PLATFORM_URL Point de terminaison d’URL auquel vous appelez l’API. Cette valeur est fixe et est toujours définie sur : http://platform.adobe.io/. http://platform.adobe.io/
munchkinId ID unique de votre compte Marketo. Consultez le didacticiel sur l'authentification de votre Marketo instance pour savoir comment récupérer votre munchkinId. 123-ABC-456
sfdc_org_id ID d'organisation de votre compte Salesforce. Consultez le Salesforce guide suivant pour plus d'informations sur l'acquisition de votre Salesforce ID d'organisation. 00D4W000000FgYJUA0
msd_org_id ID d'organisation de votre compte Dynamics. Consultez le Microsoft Dynamics guide suivant pour plus d'informations sur l'acquisition de votre Dynamics ID d'organisation. f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm Valeur booléenne qui indique si vous êtes abonné à Marketo Account-Based Marketing. false
has_msi Valeur booléenne qui indique si vous êtes abonné à Marketo Sales Insight. false

Exécution des scripts

Une fois votre collection et votre environnement Postman configurés, 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.

dossier racine

L'interface Runner s'affiche. A partir de là, assurez-vous que toutes les cases à cocher sont sélectionnées, puis sélectionnez Run Adobe I/O Access Token Generation + Automate Namespace creation.

générateur de courant

Une demande réussie crée les espaces de nommage et schémas B2B selon les spécifications bêta.

Marketo espaces de nommage

Les espaces de noms d’identité sont des composants d’Identity Service qui servent d’indicateurs du contexte auquel une identité se rapporte.

Une identité complète est composée d’une valeur d’identifiant et d’un espace de noms. Un nouvel espace de nommage personnalisé est requis pour chaque nouvelle combinaison d'instance et de jeu de données Marketo. Par exemple, un connecteur source Marketo ingérant le jeu de données programs nécessite son propre espace de nommage personnalisé et un autre connecteur source Marketo ingérant le même jeu de données nécessite également son propre nouvel espace de nommage personnalisé. Pour plus d'informations, consultez la présentation des espaces de nommage.

L'espace de nommage Marketo est utilisé dans l'identité Principale de l'entité.

Le tableau suivant contient des informations sur la configuration sous-jacente des espaces de nommage Marketo.

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é Type d’émetteur Type d'entité émetteur Exemple d'identifiant Munchkin
marketo_person_{MUNCHKIN_ID} généré automatiquement CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} généré automatiquement B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} généré automatiquement B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} généré automatiquement B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} généré automatiquement B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} généré automatiquement B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} généré automatiquement B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} généré automatiquement B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} généré automatiquement B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce espaces de nommage

Si vous êtes abonné à l'intégration Salesforce, l'espace de nommage Salesforce est utilisé dans l'identité secondaire de l'entité.

Le tableau suivant contient des informations sur la configuration sous-jacente des espaces de nommage Salesforce.

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é Type d’émetteur Type d'entité émetteur Salesforce Exemple d’identifiant d’organisation d’abonnement
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} généré automatiquement CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} généré automatiquement B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} généré automatiquement B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} généré automatiquement B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} généré automatiquement B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} généré automatiquement B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics espaces de nommage

Si vous êtes abonné à l'intégration Dynamics, l'espace de nommage Dynamics est utilisé comme identité secondaire de l'entité.

Le tableau suivant contient des informations sur la configuration sous-jacente des espaces de nommage Dynamics.

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é Type d’émetteur Type d'entité émetteur Dynamics Exemple d’identifiant d’organisation d’abonnement
microsoft_person_{DYNAMICS_ID} généré automatiquement CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} généré automatiquement B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} généré automatiquement B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} généré automatiquement B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} généré automatiquement B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} généré automatiquement B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo schémas

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 groupes de champs de schéma nuls ou plus.

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

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 dans le Schéma Identité Principal Espace de nommage d'identité Principal Identité Secondaire Espace de nommage d'identité Secondaire Relation Notes
Marketo Company {MUNCHKIN_ID} Compte professionnel XDM Détails du compte d'entreprise XDM Activé accountID dans la classe de base marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID dans la classe de base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID dans le groupe de champs Détails du compte professionnel XDM
  • Type : un à un
  • Schéma de référence : Marketo Company {MUNCHKIN_ID}
  • Espace de noms: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} XDM Individual Profile
  • Détails sur les personnes d'affaires XDM
  • Composants professionnels XDM
  • IdentityMap
Activé personID dans la classe de base marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID du groupe de champs Détails sur la personne active XDM
  2. workEmail.address du groupe de champs Détails sur la personne active XDM
  3. identityMap du groupe de champs Carte d’identité
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. E-mail
  3. ECID
  • personComponents.sourceAccountID du groupe de champs Composants professionnels de XDM
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Company {MUNCHKIN_ID}
  • Espace de noms: marketo_company_{MUNCHKIN_ID}
  • Propriété de destination : accountID
  • Nom de la relation à partir du schéma actuel : Compte
  • Nom de la relation à partir du schéma de référence : Personnes
Marketo Opportunity {MUNCHKIN_ID} Opportunité commerciale XDM Détails des opportunités commerciales XDM Activé opportunityID dans la classe de base marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID dans la classe de base salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Company {MUNCHKIN_ID}
  • Espace de noms: marketo_company_{MUNCHKIN_ID}
  • Propriété de destination : accountID
  • Nom de la relation à partir du schéma actuel : Compte
  • Nom de la relation à partir du schéma de référence : Opportunités
Marketo Opportunity Contact Role {MUNCHKIN_ID} Relation de personne avec une opportunité commerciale XDM Aucun Activé opportunityPersonID dans la classe de base marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID dans la classe de base salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} Première relation
  • personID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Person {MUNCHKIN_ID}
  • Espace de noms: marketo_person_{MUNCHKIN_ID}
  • Propriété de destination : personID
  • 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
  • opportunityID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Opportunity {MUNCHKIN_ID}
  • Espace de noms: marketo_opportunity_{MUNCHKIN_ID}
  • Propriété de destination : opportunityID
  • Nom de la relation à partir du schéma actuel : Opportunité
  • Nom de la relation à partir du schéma de référence : Personnes
Marketo Program {MUNCHKIN_ID} XDM Business Campaign Détails de XDM Business Campaign Activé campaignID dans la classe de base marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID dans la classe de base salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} Membre XDM Business Campaign Détails des membres XDM Business Campaign Activé campaignMemberID dans la classe de base marketo_program_member_{MUNCHKIN_ID} Aucun Aucun Première relation
  • personID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Personne Marketo {MUNCHKIN_ID}
  • Espace de noms: marketo_person_{MUNCHKIN_ID}
  • Propriété de destination : personID
  • Nom de la relation à partir du schéma actuel : Personne
  • Nom de la relation à partir du schéma de référence : Programmes
Deuxième relation
  • campaignID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Program {MUNCHKIN_ID}
  • Espace de noms: marketo_program_{MUNCHKIN_ID}
  • Propriété de destination : campaignID
  • Nom de la relation à partir du schéma actuel : Programme
  • Nom de la relation à partir du schéma de référence : Personnes
Marketo Static List {MUNCHKIN_ID} XDM Business Marketing Liste Aucun Activé marketingListID dans la classe de base marketo_static_list_{MUNCHKIN_ID} Aucun Aucun Aucun La Liste statique n'est pas synchronisée à partir de Salesforce et n'a donc pas d'identité secondaire.
Marketo Static List Member {MUNCHKIN_ID} Membres de XDM Business Marketing Liste Aucun Activé marketingListMemberID dans la classe de base marketo_static_list_member_{MUNCHKIN_ID} Aucun Aucun Première relation
  • personID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Person {MUNCHKIN_ID}
  • Espace de noms: marketo_person_{MUNCHKIN_ID}
  • Propriété de destination : personID
  • Nom de la relation à partir du schéma actuel : Personne
  • Nom de la relation à partir du schéma de référence : Listes
Deuxième relation
  • marketingListID dans la classe de base
  • Type : Plusieurs à un
  • Schéma de référence : Marketo Static List {MUNCHKIN_ID}
  • Espace de noms: marketo_static_list_{MUNCHKIN_ID}
  • Propriété de destination : marketingListID
  • Nom de la relation à partir du schéma actuel : Liste
  • 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.
Marketo Named Account {MUNCHKIN_ID} Compte professionnel XDM Détails du compte d'entreprise XDM Activé accountID dans la classe de base marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID dans la classe de base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID dans le groupe de champs Détails du compte professionnel XDM
  • Type : un à un
  • Schéma de référence : Marketo Named Account {MUNCHKIN_ID}
  • Espace de noms: marketo_named_account_{MUNCHKIN_ID}
Marketo Activité {MUNCHKIN ID} XDM ExperienceEvent
  • Visiter la page Web
  • Nouvelle piste
  • Convertir la piste
  • Ajouter à la Liste
  • Supprimer de la Liste
  • Ajouter à l'opportunité
  • Supprimer de l'opportunité
  • Formulaire rempli
  • Clics sur les liens
  • Courrier électronique livré
  • Courrier électronique ouvert
  • Courrier électronique cliqué
  • Courrier indésirable
  • Courrier indésirable renvoyé par courriel
  • Courrier électronique sans abonnement
  • Score modifié
  • Opportunité mise à jour
  • Etat de la progression Campaign modifié
  • Identifiant de personne
  • URL Web Marketo
Activé personID du groupe de champs Identifiant de personne marketo_person_{MUNCHKIN_ID} Aucun Aucun Première relation
  • listOperations.listID field
  • Type : un à un
  • Schéma de référence : Marketo Static List {MUNCHKIN_ID}
  • Espace de noms: marketo_static_list_{MUNCHKIN_ID}
Deuxième relation
  • opportunityEvent.opportunityID field
  • Type : un à un
  • Schéma de référence : Marketo Opportunity {MUNCHKIN_ID}
  • Espace de noms: marketo_opportunity_{MUNCHKIN_ID}
Troisième relation
  • leadOperation.campaignProgression.campaignID field
  • Type : un à un
  • Schéma de référence : Marketo Program {MUNCHKIN_ID}
  • Espace de noms: marketo_program_{MUNCHKIN_ID}
L'identité Principale du schéma Marketo Activity {MUNCHKIN_ID} est personID, ce qui est identique à l'identité Principale du schéma [!DNL Marketo] Person {MUNCHKIN_ID}.

Étapes suivantes

Pour savoir comment connecter vos données Marketo à la plate-forme, consultez le didacticiel sur la création d'un connecteur source Marketo dans l'interface utilisateur.

Sur cette page