Creare uno schema utilizzando Schema Editor
L'interfaccia utente di Adobe Experience Platform consente di creare e gestire gli schemi 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. Anche se è possibile utilizzare questi passaggi per creare uno schema diverso per le proprie esigenze, si consiglia di eseguire 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): framework standardizzato tramite 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, inclusi classi, gruppi di campi dello 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 l'area di lavoro Schemi browse
L'area di lavoro Schemi nell'interfaccia utente Platform fornisce una visualizzazione di Schema Library, che consente di visualizzare e gestire gli schemi disponibili per l'organizzazione. L'area di lavoro include anche Schema Editor, l'area di lavoro in cui è possibile comporre uno schema in questa esercitazione.
Dopo aver effettuato l'accesso a Experience Platform, seleziona Schemi nella barra di navigazione a sinistra per aprire l'area di lavoro Schemi. La scheda Sfoglia visualizza un elenco di schemi (una rappresentazione di Schema Library) da visualizzare e personalizzare. 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.
Per ulteriori informazioni, consulta la guida sull'esplorazione delle risorse XDM esistenti nell'interfaccia utente🔗.
Creare e denominare uno schema create
Per iniziare a comporre uno schema, seleziona Crea schema nell'angolo superiore destro dell'area di lavoro Schemi.
Viene visualizzato il flusso di lavoro Crea schema. Scegliere quindi una classe base per lo schema. Puoi scegliere tra le classi principali di XDM Individual Profile e XDM ExperienceEvent o Other se queste classi non sono adatte alle tue esigenze. L'opzione Altre classi consente di creare una nuova classe o di scegliere tra altre classi preesistenti.
Per ulteriori informazioni su queste classi, consulta la documentazione Profilo individuale XDM e XDM ExperienceEvent. Ai fini di questa esercitazione, seleziona Profilo individuale XDM seguito da Successivo.
Dopo aver selezionato una classe, viene visualizzata la sezione Name and review. 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 è denominato "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.
Immetti un nome visualizzato dello schema descrittivo 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.
Verrà visualizzato Schema Editor. Questa è l’area di lavoro su cui comporrai lo schema. Lo schema con titolo autonomo viene creato automaticamente nella sezione Structure dell'area di lavoro quando si arriva nell'editor, insieme ai campi standard inclusi nella classe base selezionata. La classe assegnata per lo schema è elencata anche in Classe nella sezione Composizione.
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, selezionare Aggiungi nella sottosezione Gruppi di campi.
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, la classe XDM Individual Profile). 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 restringere l'elenco dei gruppi di campi standard a settori specifici, come vendita al dettaglio, servizi finanziari e sanità.
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 dell'anteprima per tornare alla finestra di dialogo di selezione del gruppo di campi.
Per questa esercitazione, seleziona il gruppo di campi Dettagli demografici, quindi seleziona Aggiungi gruppo di campi.
Viene visualizzata di nuovo l’area di lavoro dello schema. Nella sezione Gruppi di campi sono ora elencati "Dettagli demografici" e nella sezione Struttura sono inclusi i campi con il contributo del gruppo di campi. Puoi selezionare il nome del gruppo di campi nella sezione Gruppi di campi per evidenziare i campi specifici che fornisce nell'area di lavoro.
Questo gruppo di campi contribuisce a diversi campi con il nome di primo livello person con il tipo di dati "Persona". Questo gruppo di campi descrive informazioni su un individuo, tra cui nome, data di nascita e genere.
Si noti che il campo name contiene un tipo di dati "Nome completo", ovvero descrive un concetto comune e contiene campi secondari correlati 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 questa volta visualizzi la finestra di dialogo Aggiungi gruppo di campi, noterai che il gruppo di campi "Dettagli demografici" è disattivato e non è possibile selezionare la casella di controllo accanto a esso. In questo modo si evita di duplicare accidentalmente i gruppi di campi già inclusi nello schema corrente.
Per questo tutorial, seleziona dall'elenco i gruppi di campi standard Dettagli contatto personali e Dettagli fedeltà, 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 nella sezione Composizione e i relativi campi compositi aggiunti alla struttura dello schema.
Definire un gruppo di campi personalizzato define-field-group
Lo schema Membri fedeltà ha lo scopo di acquisire i dati relativi ai membri di un programma fedeltà e il gruppo di campi standard Dettagli fedeltà aggiunto allo schema fornisce la maggior parte di questi elementi, inclusi il tipo di programma, i punti, la data di iscrizione 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.
- Estendi il gruppo di campi Dettagli fedeltà standard con campi personalizzati. Questo causa la conversione di Dettagli fedeltà in un gruppo di campi personalizzato e il gruppo di campi standard originale non sarà più disponibile. Per ulteriori informazioni sull'aggiunta di campi personalizzati alla struttura dei gruppi di campi standard, vedere la guida dell'interfaccia utente Schemi.
Per creare un nuovo gruppo di campi, seleziona Aggiungi nella sottosezione Gruppi di campi come in precedenza, 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 al nuovo gruppo di campi il nome "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 verranno visualizzati nuovi campi in Struttura.
Aggiungi campi al gruppo di campi field-group-fields
Dopo aver creato il gruppo di campi "Custom Loyalty Details", è ora di definire i campi che il gruppo di campi contribuirà allo schema.
Per iniziare, seleziona l'icona più (+) accanto al nome dello schema nell'area di lavoro.
Nell'area di lavoro viene visualizzato il segnaposto "Campo senza titolo" e la barra a destra si aggiorna 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 un campo loyaltyTier con tipo "Oggetto" che verrà utilizzato per contenere i campi correlati.
In 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, selezionare Applica.
Le modifiche vengono applicate e viene visualizzato l'oggetto loyaltyTier appena creato. Poiché si tratta di un campo personalizzato, viene automaticamente nidificato all'interno di un oggetto con spazio dei nomi all'ID tenant dell'organizzazione, preceduto da un carattere di sottolineatura (_tenantId in questo esempio).
Per iniziare ad aggiungere i sottocampi, seleziona l'icona più (+) accanto all'oggetto loyaltyTier. Verrà visualizzato un nuovo segnaposto di campo e la sezione Proprietà campo sarà 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 con tutte le 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. Sono inclusi i tipi scalari di base e tutti i tipi di dati definiti in Schema Registry. Esempi: Stringa, Intero, Booleano, Persona, Indirizzo, Numero di telefono, ecc.
- Descrizione: Includere una descrizione facoltativa del campo con un massimo di 200 caratteri.
Il primo campo per l'oggetto loyaltyTier 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 la sezione Proprietà campo viene compilata con diverse opzioni per l'applicazione di vincoli, inclusi il valore predefinito, il formato e la lunghezza massima. Per ulteriori informazioni, consulta la documentazione sulle best practice per i campi di convalida dei dati.
Poiché 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
Dopo aver aggiunto il campo id, puoi aggiungere altri campi 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 l'icona più (+) accanto all'oggetto loyalty e compila le informazioni richieste.
Una volta completato, l'oggetto loyaltyTier conterrà i campi per id, currentThreshold, nextThreshold e effectiveDate.
Aggiungere un campo enum al gruppo di campi enum
Quando si definiscono i campi in Schema Editor, è possibile applicare alcune opzioni aggiuntive ai tipi di campo di base per fornire ulteriori vincoli ai dati che il campo può contenere. I casi di utilizzo per questi vincoli sono illustrati nella tabella seguente:
Per questa esercitazione, l'oggetto loyaltyTier nello schema richiede un nuovo campo enum che descrive la classe di livello, in cui il valore può essere solo una delle quattro opzioni possibili. Per aggiungere questo campo allo schema, seleziona l'icona più (+) accanto all'oggetto loyaltyTier e compila i campi obbligatori per Nome campo e Nome visualizzato. Per Tipo, selezionare "Stringa".
Dopo aver selezionato il tipo di campo, vengono visualizzate ulteriori caselle di controllo, incluse quelle per Array, Enum & Valori suggeriti, Identità e Relazione.
Seleziona la casella di controllo Enum & Valori suggeriti, quindi seleziona Enum. Qui puoi immettere il Valore (in CamelCase) e il Nome visualizzato (un nome facoltativo e descrittivo in Title Case) per ogni classe del livello fedeltà accettabile.
Dopo aver completato tutte le proprietà del campo, selezionare Applica per aggiungere il campo tierClass all'oggetto loyaltyTier.
Convertire un oggetto multicampo in un tipo di dati datatype
L'oggetto loyaltyTier contiene ora diversi campi e rappresenta una struttura di dati comune che potrebbe essere utile in altri schemi. Schema Editor consente di applicare rapidamente oggetti multifampo 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 il valore Type del campo su quello di qualsiasi tipo di dati definito in Schema Registry.
Per convertire l'oggetto loyaltyTier in un tipo di dati, selezionare il campo loyaltyTier nell'area di lavoro, quindi selezionare 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 possibile vedere che il campo loyaltyTier contiene un'icona di collegamento e la barra a destra indica che il tipo di dati è "Loyalty Tier".
In uno schema futuro, è ora possibile assegnare un campo come tipo "Loyalty Tier" e includerebbe automaticamente campi per ID, classe livello, soglie punto 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 Campi identità negli schemi applicabili.
Experience Platform consente di identificare facilmente un campo di identità tramite l'utilizzo di una casella di controllo Identity 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 in genere gestiti da una sola persona, il campo personalEmail.address (fornito dal gruppo di campi Dettagli contatto personali) è un buon candidato per un campo di identità.
identityMap per contenere informazioni sull'identità.identityMap, tieni presente che sostituirà qualsiasi identità primaria aggiunta direttamente allo schema. Per ulteriori informazioni, vedere la sezione su identityMap nella guida di base per la composizione dello schema.Selezionare il campo personalEmail.address nell'area di lavoro e la casella di controllo Identità verrà visualizzata in Proprietà campo. Seleziona la casella e viene visualizzata l'opzione per impostarla come Identità primaria. Seleziona anche questa casella.
Successivamente, devi fornire uno spazio dei nomi Identity dall'elenco di spazi dei nomi predefiniti nel menu a discesa. Poiché questo campo è l'indirizzo e-mail del cliente, seleziona "E-mail" dal menu a discesa. Selezionare Applica per confermare gli aggiornamenti al campo personalEmail.address.
Dopo aver applicato la modifica, l'icona di personalEmail.address mostra un simbolo di impronta digitale che indica che si tratta di un campo di identità. Il campo è inoltre elencato nella barra a sinistra in Identità.
Ora tutti i dati acquisiti nel campo personalEmail.address verranno utilizzati per identificare l'individuo e unire una singola visualizzazione di quel cliente. Per ulteriori informazioni sull'utilizzo delle identità in Experience Platform, consultare la documentazione di Identity Service.
Abilita lo schema da utilizzare in Real-Time Customer Profile profile
Real-Time Customer Profile sfrutta i dati di identità in Experience Platform per fornire una visualizzazione olistica di ogni singolo cliente. Il servizio crea profili robusti a 360° degli attributi del cliente e account con marca temporale di ogni interazione che i clienti hanno avuto in qualsiasi sistema integrato con Experience Platform.
Affinché uno schema possa essere abilitato 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, selezionare innanzitutto 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 pulsante di attivazione/disattivazione Profilo.
Selezionare Profilo e viene visualizzato un messaggio a comparsa che richiede di confermare l'attivazione dello schema per Profile.
Seleziona Abilita per confermare la scelta. È possibile selezionare di nuovo il profilo Profile per disabilitare lo schema, se lo si desidera, ma una volta che lo schema è stato salvato mentre Profile è abilitato, non può più essere disabilitato.
Altre azioni more
Nell’Editor di schema è inoltre possibile eseguire azioni rapide per copiare la struttura JSON dello schema o eliminare lo schema. Seleziona Altro nella parte superiore della visualizzazione per visualizzare un elenco a discesa con azioni rapide.
Eliminare uno schema delete-a-schema
Uno schema può essere eliminato all'interno dell'interfaccia utente dall'Editor di schema utilizzando Altre azioni e anche dai dettagli dello schema nella scheda Sfoglia. Esistono alcune condizioni che impediscono l’eliminazione di uno schema. Uno schema non può essere eliminato se:
- Lo schema è abilitato per il profilo.
- Lo schema è abilitato per Profilo e dispone di set di dati associati.
- Lo schema ha set di dati associati ma non è abilitato per il profilo.
Copia struttura JSON copy-json-structure
Selezionare Copia struttura JSON per generare un payload di esportazione per qualsiasi schema nella raccolta schemi. Questa azione copia la struttura JSON negli Appunti. Il JSON esportato può quindi essere utilizzato per importare lo schema e tutte le risorse correlate in una sandbox o organizzazione diversa. In questo modo la condivisione e il riutilizzo degli schemi tra ambienti diversi diventano semplici ed efficienti.
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 da Schema Registry.
Ora è possibile utilizzare il nuovo schema per acquisire dati in Platform. Ricorda che una volta utilizzato lo schema per acquisire i dati, è possibile apportare solo modifiche aggiuntive. Per ulteriori informazioni sul controllo delle versioni dello schema, vedere le nozioni di base sulla composizione dello schema.
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à".
È inoltre disponibile lo schema "Membri fedeltà" per la visualizzazione e la gestione tramite l'API Schema Registry. Per iniziare a utilizzare l'API, inizia leggendo la Schema Registry API guida per gli sviluppatori.
Risorse video
Nel video seguente viene illustrato come creare uno schema semplice nell'interfaccia utente Platform.
Il video seguente ha lo scopo di rafforzare la tua comprensione del lavoro con i gruppi di campo e le classi.
Appendice
Nelle sezioni seguenti vengono fornite informazioni aggiuntive sull'utilizzo di Schema Editor.
Crea una nuova classe create-new-class
Experience Platform offre la flessibilità necessaria per definire uno schema basato su una classe univoca 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.