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.
NOTEIntroduzione
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
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
Per iniziare a comporre uno schema, seleziona Crea schema nell'angolo superiore destro dell'area di lavoro Schemi.
Viene visualizzata la finestra di dialogo Crea schema. In questa finestra di dialogo, puoi scegliere di creare manualmente uno schema aggiungendo campi e gruppi di campi, oppure puoi caricare un file CSV e utilizzare algoritmi ML per generare uno schema. Seleziona un flusso di lavoro per la creazione di uno schema dalla finestra di dialogo.
Beta Creazione manuale o assistita da ML dello schema
Per informazioni su come utilizzare un algoritmo ML per consigliare una struttura di schema basata su un file caricato, consulta la guida alla creazione di schemi supportati dall'apprendimento automatico. Questa guida dell’interfaccia utente si concentra sul flusso di lavoro di creazione manuale.
Scegli una classe base
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.
Denomina e rivedi
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.
Componi 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.
NOTE
NOTEAggiungi un gruppo di campi
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.
NOTE
Questo gruppo di campi contribuisce con il tipo di dati a diversi campi sotto il nome di livello principale person "Persona". Questo gruppo di campi descrive informazioni su un individuo, tra cui nome, data di nascita e genere.
NOTETieni presente che il campo name ha un tipo di dati of "Nome completo", ovvero descrive un concetto comune e contiene campi secondari relativi al nome, ad esempio 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
È 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
Lo schema Membri fedeltà ha lo scopo di acquisire i dati relativi ai membri di un programma fedeltà e il gruppo di campi Dettagli fedeltà standard aggiunto allo schema fornisce la maggior parte di questi, incluso il tipo di programma, points, 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.
NOTE"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
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 object-type field 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 il 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).
NOTEPer 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 of il campo. Questo include i tipi scalari di base and qualsiasi tipo di dati defined 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 to "Stringa" e la sezione Proprietà campo vengono compilati 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.
