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 Experience 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 Experience Platform.
- Per informazioni su come generare le credenziali per le API Experience Platform, consulta l'esercitazione su autenticazione e accesso alle API Experience Platform.
- Per informazioni sulla configurazione di Postman per le API di Experience Platform, consulta l'esercitazione su configurazione della console per sviluppatori e Postman.
Con una console per sviluppatori Experience Platform e la configurazione di Postman, 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 , consulta il tutorial su autenticazione e accesso alle API di Experience Platform{CLIENT_SECRET}.{CLIENT_SECRET}API_KEY{API_KEY}.c8d9a2f5c1e03789bd22e8efdd1bdc1bACCESS_TOKEN{ACCESS_TOKEN}.Bearer {ACCESS_TOKEN}META_SCOPEent_dataservices_sdk.ent_dataservices_sdkCONTAINER_IDglobal contiene tutte le classi, i gruppi di campi di schema, i tipi di dati e gli schemi standard forniti dai 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}.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 che i dati possano essere acquisiti in Experience 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 XDM
- IdentityMap
- Dettagli su 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 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 baseccampaignMemberKey.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
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 ad Experience Platform, consulta l'esercitazione sulla creazione di un connettore di origine Marketo nell'interfaccia utente.