Spazi dei nomi e schemi B2B
Leggi questo documento per 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
Per informazioni sui prerequisiti per impostare l'ambiente Postman per il supporto dello spazio dei nomi B2B e dell'utilità di generazione automatica dello schema, fare riferimento alla seguente documentazione.
- È 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, inclusi i dettagli su come raccogliere i valori per le intestazioni richieste e leggere chiamate API di esempio, consulta la guida introduttiva 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 di Experience Platform.
- Per informazioni sulla configurazione di Postman per le API di Platform, consulta l'esercitazione su configurazione della console per sviluppatori e Postman.
Con una console per sviluppatori Platform e Postman configurati, puoi iniziare ad applicare i valori di ambiente appropriati all'ambiente Postman.
La tabella seguente contiene valori di esempio e informazioni aggiuntive sul popolamento dell'ambiente Postman:
CLIENT_SECRET{ACCESS_TOKEN}. Per informazioni su come recuperare {CLIENT_SECRET}, consulta il tutorial su autenticazione e accesso alle API Experience Platform.{CLIENT_SECRET}API_KEY{API_KEY}, consulta il tutorial su autenticazione e accesso alle API Experience Platform.c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKEN{ACCESS_TOKEN}, consulta il tutorial su autenticazione e accesso alle API Experience Platform.Bearer {ACCESS_TOKEN}META_SCOPEent_dataservices_sdk.ent_dataservices_sdkCONTAINER_IDglobal contiene tutte le classi, i gruppi di campi dello schema, i tipi di dati e gli schemi standard forniti dal partner Adobe e Experience Platform. Per quanto riguarda Marketo, questo valore è fisso ed è sempre impostato su global.globalTECHNICAL_ACCOUNT_IDD42AEVJZTTJC6LZADUBVPA15@techacct.adobe.comIMSims-na1.adobelogin.com.ims-na1.adobelogin.comIMS_ORG{ORG_ID}, consulta il tutorial su come configurare la console per sviluppatori e Postman.ABCEH0D9KX6A7WA7ATQE0TE@adobeOrgSANDBOX_NAMEprodTENANT_IDb2bcdpproductiontestPLATFORM_URLhttp://platform.adobe.io/.http://platform.adobe.io/Esecuzione degli script
Dopo aver configurato la raccolta Postman e l'ambiente, è ora possibile eseguire lo script tramite l'interfaccia Postman.
Nell'interfaccia Postman, selezionare la cartella principale dell'utilità di generazione automatica, quindi selezionare Run dall'intestazione superiore.
Viene visualizzata l'interfaccia Runner. Da qui, assicurarsi che tutte le caselle di controllo siano selezionate, quindi selezionare 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 di 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. Per ulteriori informazioni, leggere la panoramica degli spazi dei nomi.
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_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_PERSONSchemi 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, vedere le 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.sourceKeynel 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 di XDM
- IdentityMap
- Dettagli di consenso e preferenze
b2b.personKey.sourceKey nel gruppo di campi Dettagli persona aziendale XDMextSourceSystemAudit.externalKey.sourceKeydel gruppo di campi Dettagli persona aziendale XDMworkEmail.addressdel gruppo di campi Dettagli persona aziendale XDM
- Persona B2B
personComponents.sourceAccountKey.sourceKeydel 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.sourceKeynella 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.sourceKeynella 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.sourceKeynella 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.sourceKeynella 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.sourceKeynella 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.sourceKeynella 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.sourceKeynella 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
- Conversione lead
- Aggiunta all’elenco
- Rimozione dall’elenco
- Aggiunta all’opportunità
- Rimozione dall’opportunità
- Modulo compilato
- Clic sui link
- E-mail consegnata
- E-mail aperta
- Clic effettuato sull’e-mail
- E-mail non recapitata
- E-mail non recapitata temporaneamente
- Iscrizione all’e-mail annullata
- 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
- Modifica flusso campagna
- Aggiungi a campagna
personKey.sourceKey del gruppo di campi Identificatore personaPrima relazione
- Campo
listOperations.listKey.sourceKey - Tipo: uno a uno
- Schema di riferimento: elenco di marketing B2B
- Spazio dei nomi: Elenco di marketing B2B
Seconda relazione
- Campo
opportunityEvent.opportunityKey.sourceKey - Tipo: uno a uno
- Schema di riferimento: opportunità B2B
- Namespace: Opportunità B2B
Terza relazione
- Campo
leadOperation.campaignProgression.campaignKey.sourceKey - 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.sourceKeynella 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.sourceKeynella 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 informazioni su come collegare i dati di Marketo a Platform, consulta l'esercitazione su creazione di un connettore di origine Marketo nell'interfaccia utente.