Spazi dei nomi e schemi B2B
Questo documento fornisce informazioni sulla configurazione di base per gli spazi dei nomi e gli schemi da utilizzare con origini B2B. Questo documento fornisce anche dettagli sulla configurazione dell’utility di automazione Postman necessaria per generare spazi dei nomi e schemi B2B.
Configurare gli spazi dei nomi B2B e l’utility di generazione automatica dello schema
Il primo passaggio nell’utilizzo dello spazio dei nomi B2B e dell’utility di generazione automatica dello schema consiste nell’impostare Platform Developer Console e Postman ambiente.
- È possibile scaricare la raccolta di utilità di generazione automatica dello spazio dei nomi e dello schema e l'ambiente da questo Archivio GitHub.
- Per informazioni sull’utilizzo delle API di Platform, compresi i dettagli su come raccogliere i valori per le intestazioni richieste e leggere le chiamate API di esempio, consulta la guida su introduzione alle API di Platform.
- Per informazioni su come generare le credenziali per le API di Platform, consulta l’esercitazione su autenticazione e accesso alle API Experienci Platform.
- Per informazioni su come impostare Postman per le API di Platform, consulta l’esercitazione su configurazione della console per sviluppatori e Postman.
Con una console per sviluppatori di Platform e Postman , è ora possibile iniziare ad applicare i valori di ambiente appropriati al Postman ambiente.
La tabella seguente contiene valori di esempio e informazioni aggiuntive sulla compilazione del Postman ambiente:
CLIENT_SECRET
{ACCESS_TOKEN}
. Guarda il tutorial su autenticazione e accesso alle API Experienci Platform per informazioni su come recuperare {CLIENT_SECRET}
.{CLIENT_SECRET}
JWT_TOKEN
{JWT_TOKEN}
.{JWT_TOKEN}
API_KEY
{API_KEY}
.c8d9a2f5c1e03789bd22e8efdd1bdc1b
ACCESS_TOKEN
{ACCESS_TOKEN}
.Bearer {ACCESS_TOKEN}
META_SCOPE
ent_dataservices_sdk
.ent_dataservices_sdk
CONTAINER_ID
global
contenitore contiene tutte le classi, i gruppi di campi di schema, i tipi di dati e gli schemi standard forniti dal partner Adobe e Experienci Platform. Riguardo a Marketo, questo valore è fisso ed è sempre impostato su global
.global
PRIVATE_KEY
{PRIVATE_KEY}
TECHNICAL_ACCOUNT_ID
D42AEVJZTTJC6LZADUBVPA15@techacct.adobe.com
IMS
ims-na1.adobelogin.com
.ims-na1.adobelogin.com
IMS_ORG
{ORG_ID}
informazioni.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrg
SANDBOX_NAME
prod
TENANT_ID
b2bcdpproductiontest
PLATFORM_URL
http://platform.adobe.io/
.http://platform.adobe.io/
Esecuzione degli script
Con Postman e dell'ambiente, è ora possibile eseguire lo script tramite il Postman di rete.
In Postman selezionare la cartella principale dell'utilità di generazione automatica, quindi selezionare Run dall’intestazione in alto.
Il Runner viene visualizzata l'interfaccia. Da qui, accertati che tutte le caselle di controllo siano selezionate, quindi seleziona Run Namespaces and Schemas Autogeneration Utility.
In caso di esito positivo, la richiesta crea gli spazi dei nomi e gli schemi necessari per B2B.
Spazi dei nomi B2B
Gli spazi dei nomi delle identità sono un componente di Identity Service che servono a distinguere il contesto di un'identità. Un’identità completa include un valore di identità e uno spazio dei nomi. Leggi le panoramica degli spazi dei nomi per ulteriori informazioni.
Gli spazi dei nomi B2B vengono utilizzati nell’identità primaria dell’entità.
La tabella seguente contiene informazioni sull’impostazione sottostante per gli spazi dei nomi 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
Schemi B2B
Experience Platform utilizza gli schemi per descrivere la struttura dei dati in modo coerente e riutilizzabile. Definendo i dati in modo coerente tra i sistemi, diventa più semplice mantenere un 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 possono essere contenuti all’interno di ciascun campo. Gli schemi sono costituiti da una classe base e da zero o più gruppi di campi schema.
Per ulteriori informazioni sul modello di composizione dello schema, inclusi i principi di progettazione e le best practice, vedi nozioni di base sulla composizione dello schema.
La tabella seguente contiene informazioni sulla configurazione sottostante degli schemi B2B.
accountKey.sourceKey
nella classe baseextSourceSystemAudit.externalKey.sourceKey
nella classe baseaccountParentKey.sourceKey
nel gruppo di campi Dettagli account aziendale XDM- Proprietà di destinazione:
/accountKey/sourceKey
- Tipo: uno a uno
- Schema di riferimento: account B2B
- Spazio dei nomi: Account B2B
- Dettagli persona aziendale XDM
- Componenti della persona aziendale XDM
- IdentityMap
- Dettagli su consenso e preferenze
b2b.personKey.sourceKey
nel gruppo di campi Dettagli persona aziendale XDMextSourceSystemAudit.externalKey.sourceKey
del gruppo di campi Dettagli persona aziendale XDMworkEmail.address
del gruppo di campi Dettagli persona aziendale XDM
- Persona B2B
personComponents.sourceAccountKey.sourceKey
del gruppo di campi Componenti persona aziendale XDM- Tipo: molti-a-uno
- Schema di riferimento: account B2B
- Spazio dei nomi: Account B2B
- Proprietà di destinazione: accountKey.sourceKey
- Nome di relazione dallo schema corrente: Account
- Nome di relazione dallo schema di riferimento: Persone
opportunityKey.sourceKey
nella classe baseextSourceSystemAudit.externalKey.sourceKey
nella classe baseaccountKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: account B2B
- Spazio dei nomi: Account B2B
- Proprietà di destinazione:
accountKey.sourceKey
- Nome di relazione dallo schema corrente: Account
- Nome di relazione da schema di riferimento: opportunità
opportunityPersonKey.sourceKey
nella classe baseextSourceSystemAudit.externalKey.sourceKey
nella classe basePrima relazione
personKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: persona B2B
- Spazio dei nomi: Persona B2B
- Proprietà di destinazione: b2b.personKey.sourceKey
- Nome di relazione dallo schema corrente: Persona
- Nome di relazione da schema di riferimento: opportunità
Seconda relazione
opportunityKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: opportunità B2B
- Namespace: Opportunità B2B
- Proprietà di destinazione:
opportunityKey.sourceKey
- Nome di relazione dallo schema corrente: opportunità
- Nome di relazione dallo schema di riferimento: Persone
campaignKey.sourceKey
nella classe baseextSourceSystemAudit.externalKey.sourceKey
nella classe baseccampaignMemberKey.sourceKey
nella classe baseextSourceSystemAudit.externalKey.sourceKey
nella classe basePrima relazione
personKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: persona B2B
- Spazio dei nomi: Persona B2B
- Proprietà di destinazione:
b2b.personKey.sourceKey
- Nome di relazione dallo schema corrente: Persona
- Nome di relazione dallo schema di riferimento: Campagne
Seconda relazione
campaignKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: campagna B2B
- Spazio dei nomi: campagna B2B
- Proprietà di destinazione:
campaignKey.sourceKey
- Nome di relazione dallo schema corrente: Campaign
- Nome di relazione dallo schema di riferimento: Persone
marketingListKey.sourceKey
nella classe basemarketingListMemberKey.sourceKey
nella classe basePrima relazione
PersonKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: persona B2B
- Spazio dei nomi: Persona B2B
- Proprietà di destinazione:
b2b.personKey.sourceKey
- Nome di relazione dallo schema corrente: Persona
- Nome di relazione da schema di riferimento: elenchi di marketing
Seconda relazione
marketingListKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: elenco di marketing B2B
- Spazio dei nomi: Elenco di marketing B2B
- Proprietà di destinazione:
marketingListKey.sourceKey
- Nome di relazione dallo schema corrente: Elenco marketing
- Nome di relazione dallo schema di riferimento: Persone
- Visita pagina Web
- Nuovo lead
- Converti lead
- Aggiungi all'elenco
- Rimuovi dall’elenco
- Aggiungi all’opportunità
- Rimuovi dall’opportunità
- Modulo compilato
- Clic sui collegamenti
- E-mail consegnata
- E-mail aperta
- E-mail selezionata
- E-mail non recapitata
- E-mail non recapitata temporaneamente
- E-mail per cui è stata annullata l’iscrizione
- Punteggio modificato
- Opportunità aggiornata
- Stato nella progressione della campagna modificato
- Identificatore della persona
- URL web Marketo
- Momento di interesse
- Chiama webhook
- Modifica cadenza campagna
- Fase ricavi modificata
- Unisci lead
- E-mail inviata
- Cambia flusso campagna
- Aggiungi a campagna
personKey.sourceKey
del gruppo di campi Identificatore personaPrima relazione
listOperations.listKey.sourceKey
campo- Tipo: uno a uno
- Schema di riferimento: elenco di marketing B2B
- Spazio dei nomi: Elenco di marketing B2B
Seconda relazione
opportunityEvent.opportunityKey.sourceKey
campo- Tipo: uno a uno
- Schema di riferimento: opportunità B2B
- Namespace: Opportunità B2B
Terza relazione
leadOperation.campaignProgression.campaignKey.sourceKey
campo- Tipo: uno a uno
- Schema di riferimento: campagna B2B
- Spazio dei nomi: campagna B2B
ExperienceEvent
è diverso dalle entità. L’identità dell’evento esperienza è la persona che ha eseguito l’attività.accountPersonKey.sourceKey
nella classe basePrima relazione
personKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: persona B2B
- Spazio dei nomi: Persona B2B
- Proprietà di destinazione:
b2b.personKey.SourceKey
- Nome di relazione dallo schema corrente: Persone
- Nome di relazione da schema di riferimento: Account
Seconda relazione
accountKey.sourceKey
nella classe base- Tipo: molti-a-uno
- Schema di riferimento: account B2B
- Spazio dei nomi: Account B2B
- Proprietà di destinazione:
accountKey.sourceKey
- Nome di relazione dallo schema corrente: Account
- Nome di relazione dallo schema di riferimento: Persone
Passaggi successivi
Per scoprire come collegare il tuo Marketo su Platform, consulta l’esercitazione su creazione di un connettore di origine Marketo nell’interfaccia utente.