(Beta) Marketo Engage spazi dei nomi e schemi

IMPORTANTE

La sorgente Marketo Engage è attualmente in versione beta. La funzione e la documentazione sono soggette a modifica.

Il presente documento fornisce informazioni sulla configurazione sottostante per i namespace e gli schemi B2B utilizzati con Marketo Engage (in seguito denominati "Marketo"). Questo documento fornisce anche dettagli sulla configurazione dell'utility di automazione Postman necessaria per generare Marketo spazi dei nomi e schemi B2B.

Imposta l'utilità di generazione automatica dello spazio dei nomi Marketo e dello schema

Il primo passaggio nell’utilizzo dell’utility di generazione automatica dello spazio dei nomi e dello schema Marketo è quello di configurare la console per sviluppatori di Platform e l’ambiente Postman .

Con una console per sviluppatori Platform e Postman configurata, ora puoi iniziare ad applicare i valori di ambiente appropriati all’ambiente Postman.

La tabella seguente contiene valori di esempio e informazioni aggiuntive sulla compilazione dell'ambiente Postman :

Variable Descrizione Esempio
CLIENT_SECRET Identificatore univoco utilizzato per generare il {ACCESS_TOKEN}. Per informazioni su come recuperare le {CLIENT_SECRET}, consulta l’esercitazione sull’ autenticazione e accesso alle API Experience Platform . {CLIENT_SECRET}
JWT_TOKEN Il JSON Web Token (JWT) è una credenziale di autenticazione utilizzata per generare il tuo {ACCESS_TOKEN}. Per informazioni su come generare le {JWT_TOKEN}, consulta l’esercitazione sull’ autenticazione e accesso alle API Experience Platform . {JWT_TOKEN}
API_KEY Identificatore univoco utilizzato per autenticare le chiamate alle API di Experience Platform. Per informazioni su come recuperare le {API_KEY}, consulta l’esercitazione sull’ autenticazione e accesso alle API Experience Platform . c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN Token di autorizzazione necessario per completare le chiamate alle API di Experience Platform. Per informazioni su come recuperare le {ACCESS_TOKEN}, consulta l’esercitazione sull’ autenticazione e accesso alle API Experience Platform . Bearer {ACCESS_TOKEN}
META_SCOPE Per quanto riguarda Marketo, questo valore è fisso e sempre impostato su: ent_dataservices_sdk. ent_dataservices_sdk
CONTAINER_ID Il contenitore global contiene tutte le classi, i gruppi di campi di schema, i tipi di dati e gli schemi standard forniti dal partner di Adobe e Experience Platform. Per quanto riguarda Marketo, questo valore è fisso e viene sempre impostato su global. global
PRIVATE_KEY Credenziale utilizzata per autenticare l’istanza Postman alle API di Experience Platform. Per istruzioni su come recuperare {PRIVATE_KEY}, consulta l’esercitazione sulla configurazione della console per sviluppatori e configurazione della console per sviluppatori e Postman . {PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID Credenziale utilizzata per l’integrazione con Adobe I/O. D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS Il sistema Identity Management (IMS) fornisce il framework per l’autenticazione ai servizi Adobe. Per quanto riguarda Marketo, questo valore è fisso ed è sempre impostato su: ims-na1.adobelogin.com. ims-na1.adobelogin.com
IMS_ORG Un'entità aziendale che può possedere o concedere in licenza prodotti e servizi e consentire l'accesso ai propri membri. Per istruzioni su come recuperare le informazioni su {IMS_ORG}, consulta l’esercitazione su configurazione della console per sviluppatori e Postman . ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME Nome della partizione sandbox virtuale in uso. prod
TENANT_ID Un ID utilizzato per garantire che le risorse create siano spaccate correttamente e contenute all’interno dell’organizzazione IMS. b2bcdpproductiontest
PLATFORM_URL L'endpoint URL a cui si effettua la chiamata API. Questo valore è fisso e viene sempre impostato su: http://platform.adobe.io/. http://platform.adobe.io/
munchkinId L'ID univoco del tuo account Marketo. Per informazioni su come recuperare il munchkinId, consulta l’esercitazione sull’ autenticazione dell’ Marketo istanza . 123-ABC-456
sfdc_org_id L'ID organizzazione del tuo account Salesforce. Per ulteriori informazioni sull'acquisizione dell'ID organizzazione Salesforce, consulta la seguente Salesforce guida . 00D4W000000FgYJUA0
msd_org_id L'ID organizzazione del tuo account Dynamics. Per ulteriori informazioni sull'acquisizione dell'ID organizzazione Dynamics, consulta la seguente Microsoft Dynamics guida . f6438fab-67e8-4814-a6b5-8c8dcdf7a98f
has_abm Un valore booleano che indica se sei abbonato a Marketo Account-Based Marketing. false
has_msi Un valore booleano che indica se sei iscritto a Marketo Sales Insight. false

Esecuzione degli script

Con la raccolta Postman e l'ambiente impostati, ora puoi eseguire lo script tramite l'interfaccia Postman.

Nell'interfaccia Postman, seleziona la cartella principale dell'utilità di generazione automatica e seleziona Run dall'intestazione superiore.

cartella principale

Viene visualizzata l'interfaccia Runner. Da qui, accertati che tutte le caselle di controllo siano selezionate e quindi seleziona Run Adobe I/O Access Token Generation + Automate Namespace creation.

generatore di corrente

Una richiesta corretta crea i namespace e gli schemi B2B in base alle specifiche beta.

Marketo spazi dei nomi

Gli spazi dei nomi di identità sono un componente di Identity Service che fungono da indicatori del contesto a cui si riferisce un’identità.

Un'identità completa include un valore ID e uno spazio dei nomi. È necessario un nuovo namespace personalizzato per ogni nuova istanza Marketo e combinazione di set di dati. Ad esempio, un connettore di origine Marketo che acquisisce il set di dati programs richiede un proprio spazio dei nomi personalizzato, mentre un altro connettore di origine Marketo che acquisisce lo stesso set di dati richiede anche il proprio nuovo spazio dei nomi personalizzato. Per ulteriori informazioni, consulta la panoramica dei namespace .

Lo spazio dei nomi Marketo viene utilizzato nell’identità principale dell’entità.

La tabella seguente contiene informazioni sull’impostazione sottostante per i namespace Marketo.

NOTA

Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.

Nome visualizzato Simbolo di identità Tipo di identità Tipo di emittente Tipo di entità emittente Esempio di ID Munchkin
marketo_person_{MUNCHKIN_ID} generato automaticamente CROSS_DEVICE Marketo person 123-ABC-789
marketo_company_{MUNCHKIN_ID} generato automaticamente B2B_ACCOUNT Marketo company 123-ABC-789
marketo_opportunity_{MUNCHKIN_ID} generato automaticamente B2B_OPPORTUNITY Marketo opportunity 123-ABC-789
marketo_opportunity_contact_role_{MUNCHKIN_ID} generato automaticamente B2B_OPPORTUNITY_PERSON Marketo opportunity contact role 123-ABC-789
marketo_program_{MUNCHKIN_ID} generato automaticamente B2B_CAMPAIGN Marketo program 123-ABC-789
marketo_program_member_{MUNCHKIN_ID} generato automaticamente B2B_CAMPAIGN_MEMBER Marketo program member 123-ABC-789
marketo_static_list_{MUNCHKIN_ID} generato automaticamente B2B_MARKETING_LIST Marketo static list 123-ABC-789
marketo_static_list_member_{MUNCHKIN_ID} generato automaticamente B2B_MARKETING_LIST_MEMBER Marketo static list member 123-ABC-789
marketo_named_account_{MUNCHKIN_ID} generato automaticamente B2B_ACCOUNT Marketo named account 123-ABC-789

Salesforce spazi dei nomi

Se l’utente è iscritto all’integrazione Salesforce, lo spazio dei nomi Salesforce viene utilizzato nell’identità secondaria dell’entità.

La tabella seguente contiene informazioni sull’impostazione sottostante per i namespace Salesforce.

NOTA

Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.

Nome visualizzato Simbolo di identità Tipo di identità Tipo di emittente Tipo di entità emittente Salesforce esempio di ID organizzazione sottoscrizione
salesforce_lead_{SALESFORCE_ORGANIZATION_ID} generato automaticamente CROSS_DEVICE Salesforce lead 00DA0000000Hz79
salesforce_account_{SALESFORCE_ORGANIZATION_ID} generato automaticamente B2B_ACCOUNT Salesforce account 00DA0000000Hz79
salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID} generato automaticamente B2B_OPPORTUNITY Salesforce opportunity 00DA0000000Hz79
salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} generato automaticamente B2B_OPPORTUNITY_PERSON Salesforce opportunity contact role 00DA0000000Hz79
salesforce_campaign_{SALESFORCE_ORGANIZATION_ID} generato automaticamente B2B_CAMPAIGN Salesforce campaign 00DA0000000Hz79
salesforce_campaign_member_{SALESFORCE_ORGANIZATION_ID} generato automaticamente B2B_CAMPAIGN_MEMBER Salesforce campaign member 00DA0000000Hz79

Microsoft Dynamics spazi dei nomi

Se sei iscritto all’integrazione Dynamics, lo spazio dei nomi Dynamics viene utilizzato come identità secondaria dell’entità.

La tabella seguente contiene informazioni sull’impostazione sottostante per i namespace Dynamics.

NOTA

Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.

Nome visualizzato Simbolo di identità Tipo di identità Tipo di emittente Tipo di entità emittente Dynamics esempio di ID organizzazione sottoscrizione
microsoft_person_{DYNAMICS_ID} generato automaticamente CROSS_DEVICE Microsoft person 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_account_{DYNAMICS_ID} generato automaticamente B2B_ACCOUNT Microsoft account 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_{DYNAMICS_ID} generato automaticamente B2B_OPPORTUNITY Microsoft opportunity 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_opportunity_contact_connection_{DYNAMICS_ID} generato automaticamente B2B_OPPORTUNITY_PERSON Microsoft opportunity relationship 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_{DYNAMICS_ID} generato automaticamente B2B_CAMPAIGN Microsoft campaign 94cahe38-e51h-3d57-a9c6-2edklb7184mh
microsoft_campaign_member_{DYNAMICS_ID} generato automaticamente B2B_CAMPAIGN_MEMBER Microsoft campaign member 94cahe38-e51h-3d57-a9c6-2edklb7184mh

Marketo schemi

Experience Platform utilizza gli schemi per descrivere la struttura dei dati in modo coerente e riutilizzabile. Definendo i dati in modo coerente tra i diversi sistemi, diventa più facile mantenere il significato e quindi ottenere valore dai dati.

Prima di poter acquisire i dati in Platform, è necessario comporre uno schema per descrivere la struttura dei dati e fornire vincoli al tipo di dati che può essere contenuto all’interno di ciascun campo. Gli schemi sono costituiti da una classe base e da zero o più gruppi di campi dello schema.

Per ulteriori informazioni sul modello di composizione dello schema, inclusi i principi di progettazione e le best practice, consulta le nozioni di base sulla composizione dello schema.

La tabella seguente contiene informazioni sulla configurazione sottostante degli schemi Marketo.

NOTA

Scorri verso sinistra/destra per visualizzare il contenuto completo della tabella.

Nome dello schema Classe base Gruppi di campi Profile in Schema Identità principale Spazio dei nomi identità principale Identità secondaria Spazio dei nomi identità secondario Relazione Note
Marketo Company {MUNCHKIN_ID} Account aziendale XDM Dettagli account aziendale XDM Abilitata accountID nella classe base marketo_company_{MUNCHKIN_ID} extSourceSystemAudit.externalID nella classe base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID nel gruppo di campi Dettagli account business XDM
  • Tipo: uno a uno
  • Schema di riferimento: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
Marketo Person {MUNCHKIN_ID} Profilo individuale XDM
  • Dettagli sulle persone aziendali XDM
  • Componenti per Business Person XDM
  • IdentityMap
 Abilitata personID nella classe base marketo_person_{MUNCHKIN_ID}
  1. extSourceSystemAudit.externalID Gruppo di campi Dettagli persona commerciale XDM
  2. workEmail.address Gruppo di campi Dettagli persona commerciale XDM
  3. identityMap del gruppo di campi Identity Map
  1. salesforce_lead_{SALESFORCE_ORGANIZATION_ID}
  2. E-mail
  3. ECID
  • personComponents.sourceAccountID Gruppo di campi Componenti Business Person XDM
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
  • Proprietà di destinazione: accountID
  • Nome di relazione dallo schema corrente: Account
  • Nome di relazione dallo schema di riferimento: Persone
Marketo Opportunity {MUNCHKIN_ID} Opportunità aziendali XDM Dettagli opportunità di business XDM Abilitata opportunityID nella classe base marketo_opportunity_{MUNCHKIN_ID} extSourceSystemAudit.externalID nella classe base salesforce_opportunity_{SALESFORCE_ORGANIZATION_ID}
  • accountID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Company {MUNCHKIN_ID}
  • Namespace: marketo_company_{MUNCHKIN_ID}
  • Proprietà di destinazione: accountID
  • Nome di relazione dallo schema corrente: Account
  • Nome di relazione dallo schema di riferimento: Opportunità
Marketo Opportunity Contact Role {MUNCHKIN_ID} Relazione personale opportunità di business XDM Nessuna Abilitata opportunityPersonID nella classe base marketo_opportunity_contact_role_{MUNCHKIN_ID} extSourceSystemAudit.externalID nella classe base salesforce_opportunity_contact_role_{SALESFORCE_ORGANIZATION_ID} Prima relazione
  • personID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Person {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Proprietà di destinazione: personID
  • Nome di relazione dallo schema corrente: Persona
  • Nome di relazione dallo schema di riferimento: Opportunità
Seconda relazione
  • opportunityID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Opportunity {MUNCHKIN_ID}
  • Namespace: marketo_opportunity_{MUNCHKIN_ID}
  • Proprietà di destinazione: opportunityID
  • Nome di relazione dallo schema corrente: Opportunità
  • Nome di relazione dallo schema di riferimento: Persone
Marketo Program {MUNCHKIN_ID} Campagna aziendale XDM Dettagli della campagna aziendale XDM Abilitata campaignID nella classe base marketo_program_{MUNCHKIN_ID} extSourceSystemAudit.externalID nella classe base salesforce_campaign_{SALESFORCE_ORGANIZATION_ID}
Marketo Program Member {MUNCHKIN_ID} Membro della campagna aziendale XDM Dettagli membri della campagna aziendale XDM Abilitata campaignMemberID nella classe base marketo_program_member_{MUNCHKIN_ID} Nessuna Nessuna Prima relazione
  • personID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Persona Marketo {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Proprietà di destinazione: personID
  • Nome di relazione dallo schema corrente: Persona
  • Nome di relazione dallo schema di riferimento: Programmi
Seconda relazione
  • campaignID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Program {MUNCHKIN_ID}
  • Namespace: marketo_program_{MUNCHKIN_ID}
  • Proprietà di destinazione: campaignID
  • Nome di relazione dallo schema corrente: Programma
  • Nome di relazione dallo schema di riferimento: Persone
Marketo Static List {MUNCHKIN_ID} Elenco di marketing aziendale XDM Nessuna Abilitata marketingListID nella classe base marketo_static_list_{MUNCHKIN_ID} Nessuna Nessuna Nessuna L’elenco statico non è sincronizzato da Salesforce e pertanto non dispone di un’identità secondaria.
Marketo Static List Member {MUNCHKIN_ID} Membri elenco marketing commerciale XDM Nessuna Abilitata marketingListMemberID nella classe base marketo_static_list_member_{MUNCHKIN_ID} Nessuna Nessuna Prima relazione
  • personID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Person {MUNCHKIN_ID}
  • Namespace: marketo_person_{MUNCHKIN_ID}
  • Proprietà di destinazione: personID
  • Nome di relazione dallo schema corrente: Persona
  • Nome di relazione dallo schema di riferimento: Elenchi
Seconda relazione
  • marketingListID nella classe base
  • Tipo: Many-to-one (Da molti a uno)
  • Schema di riferimento: Marketo Static List {MUNCHKIN_ID}
  • Namespace: marketo_static_list_{MUNCHKIN_ID}
  • Proprietà di destinazione: marketingListID
  • Nome di relazione dallo schema corrente: Elenco
  • Nome di relazione dallo schema di riferimento: Persone
 Il membro dell’elenco statico non è sincronizzato da Salesforce e pertanto non dispone di un’identità secondaria.
Marketo Named Account {MUNCHKIN_ID} Account aziendale XDM Dettagli account aziendale XDM Abilitata accountID nella classe base marketo_named_account_{MUNCHKIN_ID} extSourceSystemAudit.externalID nella classe base salesforce_account_{SALESFORCE_ORGANIZATION_ID}
  • accountParentID nel gruppo di campi Dettagli account business XDM
  • Tipo: uno a uno
  • Schema di riferimento: Marketo Named Account {MUNCHKIN_ID}
  • Namespace: marketo_named_account_{MUNCHKIN_ID}
Marketo Attività {MUNCHKIN ID} ExperienceEvent XDM
  • Visita WebPage
  • Nuovo lead
  • Converti lead
  • Aggiungi all’elenco
  • Rimuovi da elenco
  • Aggiungi a opportunità
  • Rimuovi da opportunità
  • Modulo compilato
  • Clic sui collegamenti
  • E-mail consegnata
  • E-mail aperta
  • E-mail selezionata
  • E-mail rimbalzata
  • E-mail - Soft rimbalzato
  • E-mail annullata
  • Punteggio modificato
  • Opportunità aggiornata
  • Stato in progressione campagna modificato
  • Identificatore persona
  • URL web Marketo
 Abilitata personID del gruppo di campi ID persona marketo_person_{MUNCHKIN_ID} Nessuna Nessuna Prima relazione
  • listOperations.listID o in un altro campo
  • Tipo: uno a uno
  • Schema di riferimento: Marketo Static List {MUNCHKIN_ID}
  • Namespace: marketo_static_list_{MUNCHKIN_ID}
Seconda relazione
  • opportunityEvent.opportunityID o in un altro campo
  • Tipo: uno a uno
  • Schema di riferimento: Marketo Opportunity {MUNCHKIN_ID}
  • Namespace: marketo_opportunity_{MUNCHKIN_ID}
Terza relazione
  • leadOperation.campaignProgression.campaignID o in un altro campo
  • Tipo: uno a uno
  • Schema di riferimento: Marketo Program {MUNCHKIN_ID}
  • Namespace: marketo_program_{MUNCHKIN_ID}
 L'identità principale dello schema Marketo Activity {MUNCHKIN_ID} è personID, che è la stessa dell'identità principale dello schema [!DNL Marketo] Person {MUNCHKIN_ID}.

Passaggi successivi

Per informazioni su come collegare i dati Marketo a Platform, consulta l’esercitazione su creazione di un connettore sorgente Marketo nell’interfaccia utente.

In questa pagina