Creare uno schema utilizzando Schema Editor
L’interfaccia utente di Adobe Experience Platform consente di creare e gestire Experience Data Model (XDM) in un’area di lavoro visiva e interattiva, denominata Schema Editor. Questo tutorial illustra come creare uno schema utilizzando Schema Editor.
A scopo dimostrativo, i passaggi di questa esercitazione comportano la creazione di uno schema di esempio che descrive i membri di un programma fedeltà dei clienti. Sebbene sia possibile utilizzare questi passaggi per creare uno schema diverso per le proprie finalità, si consiglia di seguire prima la creazione dello schema di esempio per apprendere le funzionalità di Schema Editor.
Introduzione
Questo tutorial richiede una buona conoscenza dei vari aspetti di Adobe Experience Platform coinvolti nella creazione dello schema. Prima di iniziare questo tutorial, consulta la documentazione per i seguenti concetti:
- Experience Data Model (XDM): il quadro standardizzato mediante il quale Platform organizza i dati sull’esperienza del cliente.
- Nozioni di base sulla composizione dello schema: panoramica degli schemi XDM e dei relativi blocchi predefiniti, tra cui classi, gruppi di campi di schema, tipi di dati e singoli campi.
- Real-Time Customer Profile: fornisce un profilo consumer unificato e in tempo reale basato su dati aggregati provenienti da più origini.
Apri Schemi workspace browse
Il Schemi area di lavoro in Platform L’interfaccia utente fornisce una visualizzazione del Schema Library, che consente di visualizzare e gestire gli schemi disponibili per la tua organizzazione. L'area di lavoro include anche Schema Editor, l’area di lavoro in cui puoi comporre uno schema, in questa esercitazione.
Dopo l’accesso a Experience Platform, seleziona Schemi nel menu di navigazione a sinistra per aprire Schemi Workspace. Il Sfoglia visualizza un elenco di schemi (una rappresentazione del Schema Library) per la visualizzazione e la personalizzazione. L’elenco include il nome, il tipo, la classe e il comportamento (record o serie temporale) su cui è basato lo schema, nonché la data e l’ora dell’ultima modifica dello schema.
Consulta la guida su esplorazione delle risorse XDM esistenti nell’interfaccia utente per ulteriori informazioni.
Creare e denominare uno schema create
Per iniziare a comporre uno schema, seleziona Crea schema nell'angolo in alto a destra del Schemi Workspace.
Il Crea schema viene visualizzato workflow. Scegliere quindi una classe base per lo schema. Puoi scegliere tra le classi principali di Profilo individuale XDM e XDM ExperienceEvent, o Altro se queste classi non sono adatte ai tuoi scopi. Il Altro l'opzione classi consente di: crea una nuova classe oppure scegliere tra altre classi preesistenti.
Consulta la Profilo individuale XDM e XDM ExperienceEvent per ulteriori informazioni su queste classi. Ai fini del presente tutorial, seleziona Profilo individuale XDM seguito da Successivo.
Dopo aver selezionato una classe, Nome e recensione viene visualizzata la sezione. In questa sezione, fornisci un nome e una descrizione per identificare lo schema. Ci sono diverse considerazioni importanti da fare quando si decide un nome per lo schema:
- I nomi degli schemi devono essere brevi e descrittivi in modo che lo schema possa essere facilmente trovato in un secondo momento.
- I nomi degli schemi devono essere univoci, ovvero devono essere sufficientemente specifici da non poter essere riutilizzati in futuro. Ad esempio, se l’organizzazione dispone di programmi fedeltà separati per marchi diversi, sarebbe opportuno denominare lo schema "Membri fedeltà per marchio" per semplificare la distinzione da altri schemi relativi alla fedeltà che potresti definire in un secondo momento.
- È inoltre possibile utilizzare la descrizione dello schema per fornire eventuali informazioni contestuali aggiuntive relative allo schema.
Questa esercitazione crea uno schema per acquisire i dati relativi ai membri di un programma fedeltà e pertanto lo schema si chiama "Loyalty Members".
La struttura di base dello schema (fornita dalla classe) viene visualizzata nell’area di lavoro per rivedere e verificare la struttura di classe e schema selezionata.
Inserisci un Nome visualizzato schema nel campo di testo. Quindi, inserisci una descrizione adatta per identificare lo schema. Dopo aver rivisto la struttura dello schema e aver impostato correttamente le impostazioni, seleziona Fine per creare lo schema.
Il Schema Editor viene visualizzato. Questa è l’area di lavoro su cui comporrai lo schema. Lo schema con titolo autonomo viene creato automaticamente nel Struttura sezione dell’area di lavoro quando arrivi nell’editor, insieme ai campi standard inclusi nella classe base selezionata. La classe assegnata per lo schema è elencata anche in Classe in Composizione sezione.
Aggiungi un gruppo di campi field-group
Ora puoi iniziare ad aggiungere campi allo schema aggiungendo gruppi di campi. Un gruppo di campi è un gruppo di uno o più campi che vengono spesso utilizzati insieme per descrivere un particolare concetto. Questa esercitazione utilizza i gruppi di campi per descrivere i membri del programma fedeltà e acquisire informazioni chiave come nome, compleanno, numero di telefono, indirizzo e altro ancora.
Per aggiungere un gruppo di campi, seleziona Aggiungi nel Gruppi di campi sottosezione.
Viene visualizzata una nuova finestra di dialogo con un elenco dei gruppi di campi disponibili. Ogni gruppo di campi deve essere utilizzato solo con una classe specifica, pertanto nella finestra di dialogo vengono elencati solo i gruppi di campi compatibili con la classe selezionata (in questo caso, XDM Individual Profile classe). Se utilizzi una classe XDM standard, l’elenco dei gruppi di campi verrà ordinato in modo intelligente in base alla popolarità dell’utilizzo.
Puoi selezionare uno dei filtri nella barra a sinistra per limitare l’elenco dei gruppi di campi standard a specifici settori come il commercio al dettaglio, i servizi finanziari e l'assistenza sanitaria.
Selezionando un gruppo di campi dall’elenco, questo viene visualizzato nella barra a destra. Se necessario, puoi selezionare più gruppi di campi, aggiungendoli all’elenco nella barra a destra prima di confermare. Sul lato destro del gruppo di campi attualmente selezionato viene inoltre visualizzata un'icona che consente di visualizzare in anteprima la struttura dei campi forniti.
Nell’anteprima di un gruppo di campi, nella barra a destra viene fornita una descrizione dettagliata dello schema del gruppo di campi. Puoi anche spostarti tra i campi del gruppo di campi nell’area di lavoro fornita. Quando selezioni diversi campi, la barra a destra si aggiorna per mostrare i dettagli del campo in questione. Seleziona Indietro al termine della visualizzazione in anteprima per tornare alla finestra di dialogo di selezione del gruppo di campi.
Per questo tutorial, seleziona la Dettagli demografici gruppo di campi, quindi seleziona Aggiungi gruppo di campi.
Viene visualizzata di nuovo l’area di lavoro dello schema. Il Gruppi di campi La sezione ora elenca "Dettagli demografici" e Struttura La sezione include i campi con il contributo del gruppo di campi. È possibile selezionare il nome del gruppo di campi sotto Gruppi di campi per evidenziare i campi specifici che fornisce all’interno dell’area di lavoro.
Questo gruppo di campi contribuisce con diversi campi sotto il nome di livello principale person
con il tipo di dati "Persona". Questo gruppo di campi descrive informazioni su un individuo, tra cui nome, data di nascita e genere.
Tieni presente che name
il campo ha un tipo di dati "Nome e cognome", il che significa che descrive anche un concetto comune e contiene sottocampi relativi al nome come nome, cognome, titolo di cortesia e suffisso.
Seleziona i diversi campi all’interno dell’area di lavoro per visualizzare eventuali campi aggiuntivi che contribuiscono alla struttura dello schema.
Aggiungi altri gruppi di campi field-group-2
È ora possibile ripetere gli stessi passaggi per aggiungere un altro gruppo di campi. Quando visualizzi il Aggiungi gruppo di campi questa volta, tieni presente che il"Dettagli demograficiIl gruppo di campi " è stato disattivato e la casella di controllo accanto ad esso non può essere selezionata. In questo modo si evita di duplicare accidentalmente i gruppi di campi già inclusi nello schema corrente.
Per questo tutorial, seleziona i gruppi di campi standard Dettagli di contatto personali e Dettagli fedeltà dall’elenco, quindi seleziona Aggiungi gruppi di campi per aggiungerli allo schema.
L’area di lavoro viene nuovamente visualizzata con i gruppi di campi aggiunti elencati in Gruppi di campi nel Composizione e i relativi campi compositi aggiunti alla struttura dello schema.
Definire un gruppo di campi personalizzato define-field-group
Il Membri fedeltà lo schema ha lo scopo di acquisire dati relativi ai membri di un programma fedeltà e allo standard Dettagli fedeltà il gruppo di campi aggiunto allo schema fornisce la maggior parte di questi, inclusi il tipo di programma, i punti, la data di unione e altro ancora.
Tuttavia, potrebbe esserci uno scenario in cui desideri includere campi personalizzati aggiuntivi non coperti dai gruppi di campi standard per ottenere i casi d’uso. Se aggiungi campi fedeltà personalizzati, puoi scegliere tra due opzioni:
- Crea un nuovo gruppo di campi personalizzato per acquisire questi campi. Questo è il metodo che verrà descritto in questa esercitazione.
- Estendere lo standard Dettagli fedeltà gruppo di campi con campi personalizzati. Questo causa Dettagli fedeltà da convertire in un gruppo di campi personalizzato e il gruppo di campi standard originale non sarà più disponibile. Consulta la Schemi Guida all’interfaccia utente per ulteriori informazioni su aggiunta di campi personalizzati alla struttura di gruppi di campi standard.
Per creare un nuovo gruppo di campi, selezionare Aggiungi nel Gruppi di campi sottosezione come prima, ma questa volta seleziona Crea nuovo gruppo di campi nella parte superiore della finestra di dialogo visualizzata. Viene quindi richiesto di fornire un nome visualizzato e una descrizione per il nuovo gruppo di campi. Per questa esercitazione, assegna un nome al nuovo gruppo di campi "Custom Loyalty Details", quindi seleziona Aggiungi gruppi di campi.
"Custom Loyalty Details" dovrebbe ora essere visualizzato in Gruppi di campi sul lato sinistro dell’area di lavoro, ma non sono ancora presenti campi associati ad essa e pertanto non vengono visualizzati nuovi campi in Struttura.
Aggiungi campi al gruppo di campi field-group-fields
Ora che hai creato il "Custom Loyalty Details", è il momento di definire i campi che il gruppo di campi contribuirà allo schema.
Per iniziare, seleziona la più (+) accanto al nome dello schema nell’area di lavoro.
Un "Campo senza titoloIl segnaposto " viene visualizzato nell’area di lavoro e la barra a destra viene aggiornata per visualizzare le opzioni di configurazione per il campo.
In questo scenario, lo schema deve avere un campo di tipo oggetto che descrive in dettaglio il livello di fedeltà corrente della persona. Utilizzando i controlli nella barra a destra, inizia a creare una loyaltyTier
campo con tipo "Oggetto" che verranno utilizzati per contenere i campi correlati.
Sotto Assegna a, è necessario selezionare un gruppo di campi a cui assegnare il campo. Ricorda che tutti i campi dello schema appartengono a una classe o a un gruppo di campi e poiché questo schema utilizza una classe standard, l’unica opzione consiste nel selezionare un gruppo di campi. Inizia a digitare il nome "Custom Loyalty Details", quindi seleziona il gruppo di campi dall’elenco.
Al termine, seleziona Applica.
Le modifiche vengono applicate e la nuova loyaltyTier
viene visualizzato l'oggetto. Poiché si tratta di un campo personalizzato, viene automaticamente nidificato all’interno di un oggetto con spazio dei nomi corrispondente all’ID tenant della tua organizzazione, preceduto da un carattere di sottolineatura (_tenantId
in questo esempio).
Seleziona la più (+) accanto al simbolo loyaltyTier
per iniziare ad aggiungere i sottocampi. Viene visualizzato un nuovo segnaposto per il campo e Proprietà campo è visibile sul lato destro dell’area di lavoro.
Ogni campo richiede le seguenti informazioni:
- Nome campo: Il nome del campo, preferibilmente scritto in CamelCase. Non sono consentiti spazi. Questo è il nome utilizzato per fare riferimento al campo nel codice e in altre applicazioni a valle.
- Esempio: loyaltyLevel
- Nome visualizzato: Il nome del campo, scritto in iniziali maiuscole. Questo è il nome che verrà visualizzato nell’area di lavoro durante la visualizzazione o la modifica dello schema.
- Esempio: livello di fedeltà
- Tipo: Il tipo di dati del campo. Questo include i tipi scalari di base e tutti i tipi di dati definiti nella Schema Registry. Esempi: Stringa, Intero, Booleano, Persona, Indirizzo, Numero di telefono, ecc.
- Descrizione: Una descrizione facoltativa del campo deve essere inclusa con un massimo di 200 caratteri.
Il primo campo per loyaltyTier
l'oggetto sarà una stringa denominata id
, che rappresenta l'ID del livello corrente del membro fedeltà. L’ID del livello sarà univoco per ciascun membro fedeltà, poiché questa società imposta soglie di punti del livello fedeltà diverse per ciascun cliente in base a fattori diversi. Imposta il tipo del nuovo campo su "Stringa", e Proprietà campo La sezione viene compilata con diverse opzioni per l'applicazione dei vincoli, tra cui il valore predefinito, il formato e la lunghezza massima. Consulta la documentazione su best practice per i campi di convalida dei dati per ulteriori informazioni.
Da id
sarà una stringa a forma libera generata in modo casuale, non sono necessari ulteriori vincoli. Seleziona Applica per applicare le modifiche.
Aggiungi altri campi al gruppo di campi field-group-fields-2
Ora che hai aggiunto il id
campo, puoi aggiungere campi aggiuntivi per acquisire informazioni sul livello fedeltà, ad esempio:
- Soglia punto corrente (numero intero): il numero minimo di punti fedeltà che il membro deve mantenere per rimanere nel livello corrente.
- Soglia punto livello successivo (numero intero): il numero di punti fedeltà che il membro deve accumulare per passare al livello successivo.
- Data di validità (data-ora): la data in cui il membro fedeltà è entrato a far parte del livello.
Per aggiungere ogni campo allo schema, seleziona la più (+) accanto al simbolo loyalty
e inserire le informazioni richieste.
Una volta completata, la loyaltyTier
l'oggetto conterrà campi per id
, currentThreshold
, nextThreshold
, e effectiveDate
.
Aggiungere un campo enum al gruppo di campi enum
Quando definisci i campi in Schema EditorTuttavia, esistono alcune opzioni aggiuntive che è possibile applicare ai tipi di campo di base per fornire ulteriori vincoli sui dati che il campo può contenere. I casi di utilizzo per questi vincoli sono illustrati nella tabella seguente:
Per questa esercitazione, il loyaltyTier
L'oggetto nello schema richiede un nuovo campo enum che descrive la classe di livello, dove il valore può essere solo una delle quattro opzioni possibili. Per aggiungere questo campo allo schema, seleziona la più (+) icona accanto a loyaltyTier
e compilare i campi obbligatori per Nome campo e Nome visualizzato. Per Tipo, seleziona "Stringa".
Dopo aver selezionato il tipo di campo, vengono visualizzate ulteriori caselle di controllo, incluse quelle per Array, Enum e valori suggeriti, Identità, e Relazione.
Seleziona la Enum e valori suggeriti , quindi seleziona Enum. Qui puoi inserire il Valore (in camelCase) e Nome visualizzato (nome descrittivo facoltativo in maiuscolo/minuscolo) per ogni classe di livello fedeltà accettabile.
Dopo aver completato tutte le proprietà del campo, seleziona Applica per aggiungere tierClass
campo al loyaltyTier
oggetto.
Convertire un oggetto multicampo in un tipo di dati datatype
Il loyaltyTier
L’oggetto ora contiene diversi campi e rappresenta una struttura di dati comune che potrebbe essere utile in altri schemi. Il Schema Editor consente di applicare rapidamente oggetti multicampo riutilizzabili convertendo la struttura di tali oggetti in tipi di dati.
I tipi di dati consentono l’utilizzo coerente di strutture a più campi e forniscono maggiore flessibilità rispetto a un gruppo di campi, perché possono essere utilizzati ovunque all’interno di uno schema. Questa operazione viene eseguita impostando la proprietà Tipo valore a quello di qualsiasi tipo di dati definito nel Schema Registry.
Per convertire loyaltyTier
a un tipo di dati, selezionare il loyaltyTier
nell’area di lavoro, quindi seleziona Converti in nuovo tipo di dati sul lato destro dell’editor in Proprietà campo.
Viene visualizzata una notifica che conferma che l'oggetto è stato convertito correttamente. Nell’area di lavoro ora puoi vedere che il loyaltyTier
Il campo ora include un’icona di collegamento e la barra a destra indica che il tipo di dati è "Loyalty Tier".
In uno schema futuro, ora puoi assegnare un campo come "Loyalty Tier" e includerebbe automaticamente campi per ID, classe di livello, soglie di punti e data di validità.
Cercare e filtrare i campi dello schema
Lo schema ora contiene diversi gruppi di campi oltre ai campi forniti dalla relativa classe base. Quando si utilizzano schemi di grandi dimensioni, è possibile selezionare le caselle di controllo accanto ai nomi dei gruppi di campi nella barra a sinistra per filtrare i campi visualizzati solo in base a quelli forniti dai gruppi di campi desiderati.
Se cerchi un campo specifico nello schema, puoi anche utilizzare la barra di ricerca per filtrare i campi visualizzati per nome, indipendentemente dal gruppo di campi in cui vengono forniti.
Impostare un campo schema come campo identità identity-field
La struttura dati standard fornita dagli schemi può essere utilizzata per identificare i dati appartenenti alla stessa persona da più origini, consentendo vari casi di utilizzo a valle come segmentazione, reporting, analisi della scienza dei dati e altro ancora. Per unire i dati in base alle identità individuali, i campi chiave devono essere contrassegnati come Identità campi all’interno degli schemi applicabili.
Experience Platform consente di identificare facilmente un campo di identità tramite l’utilizzo di un Identità casella di controllo in Schema Editor. Tuttavia, devi determinare quale campo è il candidato migliore da utilizzare come identità, in base alla natura dei tuoi dati.
Ad esempio, possono esserci migliaia di membri del programma fedeltà appartenenti allo stesso livello fedeltà e diversi che possono condividere lo stesso indirizzo fisico. In questo scenario, tuttavia, al momento dell’iscrizione ogni membro del programma fedeltà fornisce il proprio indirizzo e-mail personale. Poiché gli indirizzi e-mail personali sono solitamente gestiti da una sola persona, il campo personalEmail.address
(fornito da Dettagli di contatto personali gruppo di campi) è un buon candidato per un campo di identità.
identityMap
per contenere informazioni di identità.identityMap
, ricorda che sostituirà qualsiasi identità primaria aggiunta direttamente allo schema. Consulta la sezione su identityMap
nel nozioni di base della guida alla composizione dello schema per ulteriori informazioni.Seleziona la personalEmail.address
nell'area di lavoro e Identità casella di controllo visualizzata in Proprietà campo. Seleziona la casella e l’opzione per impostarlo come Identità primaria viene visualizzato. Seleziona anche questa casella.
Quindi, devi fornire un Spazio dei nomi dell’identità dall’elenco degli spazi dei nomi predefiniti nel menu a discesa. Poiché questo campo è l’indirizzo e-mail del cliente, seleziona "E-mail" dal menu a discesa. Seleziona Applica per confermare gli aggiornamenti personalEmail.address
campo.
Dopo aver applicato la modifica, l’icona per personalEmail.address
mostra un simbolo di impronta digitale, che indica che si tratta di un campo di identità. Il campo è elencato anche nella barra a sinistra in Identità.
Ora tutti i dati acquisiti in personalEmail.address
Questo campo verrà utilizzato per identificare l’individuo e unire un’unica visualizzazione di quel cliente. Per ulteriori informazioni sull’utilizzo delle identità in Experience Platform, rivedi il Identity Service documentazione.
Abilita lo schema per l’utilizzo in Real-Time Customer Profile profile
Real-Time Customer Profile sfrutta i dati di identità in Experience Platform per fornire una visione olistica di ogni singolo cliente. Il servizio crea solidi profili a 360° di attributi del cliente e account con marca temporale di ogni interazione che i clienti hanno avuto in qualsiasi sistema integrato con Experience Platform.
Per abilitare uno schema per l’utilizzo con Real-Time Customer Profile, deve avere un’identità primaria definita. Riceverai un messaggio di errore se tenti di abilitare uno schema senza prima definire un’identità primaria.
Per abilitare lo schema "Membri fedeltà" per l’utilizzo in Profile, inizia selezionando il titolo dello schema nell’area di lavoro.
Sul lato destro dell’editor vengono visualizzate informazioni sullo schema, tra cui il nome visualizzato, la descrizione e il tipo. Oltre a queste informazioni, è disponibile un Profilo interruttore.
Seleziona Profilo e viene visualizzato un messaggio che richiede di confermare che si desidera abilitare lo schema per Profile.
Seleziona Abilita per confermare la scelta. È possibile selezionare Profilo attiva di nuovo per disabilitare lo schema, ma una volta che lo schema è stato salvato durante Profile è attivato, non può più essere disattivato.
Altre azioni more
Nell’Editor di schema è inoltre possibile eseguire azioni rapide per copiare la struttura JSON dello schema o eliminare lo schema, se non è stato abilitato per Real-Time Customer Profile o se a esso sono associati set di dati. Seleziona Altro nella parte superiore della visualizzazione per visualizzare un elenco a discesa con azioni rapide.
La funzionalità di copia della struttura JSON consente di visualizzare l’aspetto di un payload di esempio durante la creazione dello schema e delle pipeline di dati. È particolarmente utile nelle situazioni in cui sono presenti strutture complesse di mappa oggetto nello schema, ad esempio una mappa di identità.
Passaggi successivi e risorse aggiuntive
Dopo aver composto lo schema, nell’area di lavoro puoi vedere lo schema completo. Seleziona Salva e lo schema verrà salvato in Schema Library, rendendolo accessibile agli utenti Schema Registry.
Ora è possibile utilizzare il nuovo schema per acquisire i dati in Platform. Ricorda che una volta utilizzato lo schema per acquisire i dati, è possibile apportare solo modifiche aggiuntive. Consulta la nozioni di base sulla composizione dello schema per ulteriori informazioni sul controllo delle versioni degli schemi.
Ora puoi seguire l’esercitazione su definizione di una relazione di schema nell’interfaccia utente per aggiungere un nuovo campo di relazione allo schema "Membri fedeltà".
Lo schema "Membri fedeltà" è disponibile anche per essere visualizzato e gestito utilizzando Schema Registry API. Per iniziare a lavorare con l’API, inizia leggendo il Schema Registry API guida per sviluppatori.
Risorse video
Il video seguente mostra come creare uno schema semplice nel Platform UI.
Il video seguente ha lo scopo di rafforzare la tua comprensione del lavoro con i gruppi di campo e le classi.
Appendice
Le sezioni seguenti forniscono informazioni aggiuntive relative all’utilizzo del Schema Editor.
Crea una nuova classe create-new-class
Experience Platform offre la flessibilità di definire uno schema basato su una classe specifica per la tua organizzazione. Per informazioni su come creare una nuova classe, consulta la guida su creazione e modifica di classi nell’interfaccia utente.
Modificare la classe di uno schema change-class
È possibile modificare la classe di uno schema in qualsiasi momento durante il processo di composizione iniziale prima che lo schema sia stato salvato.
Per informazioni su come modificare la classe di uno schema, consulta la guida su gestione degli schemi nell’interfaccia utente di.