Dati modello negli schemi
In questa lezione, modellerai i dati di Luma in schemi. Questa è una delle lezioni più lunghe dell'esercitazione, quindi prendi un bicchiere d'acqua e allacci la cintura!
La standardizzazione e l'interoperabilità sono concetti chiave alla base di Adobe Experience Platform. Experience Data Model (XDM) è un tentativo di standardizzare i dati sulla customer experience e definire schemi per la gestione della customer experience.
XDM è una specifica documentata pubblicamente progettata per migliorare la potenza delle esperienze digitali. Fornisce strutture e definizioni comuni per qualsiasi applicazione da utilizzare per comunicare con i servizi di Platform. Aderendo agli standard XDM, tutti i dati sulla customer experience possono essere incorporati in una rappresentazione comune che può fornire informazioni in modo più veloce e integrato. Puoi ottenere informazioni preziose dalle azioni dei clienti, definire i tipi di pubblico dei clienti attraverso i segmenti ed esprimere gli attributi dei clienti a scopo di personalizzazione.
XDM è il framework fondamentale che consente a Adobe Experience Cloud, basato su Experienci Platform, di inviare il messaggio giusto alla persona giusta, sul canale giusto, nel momento esatto giusto. La metodologia su cui si basa l'Experience Platform, Sistema XDM, rende operativi gli schemi Experience Data Model per l’utilizzo da parte dei servizi Platform.
Architetti di dati dovrà creare schemi al di fuori di questa esercitazione, ma Ingegneri dati opererà a stretto contatto con gli schemi creati dall’architetto di dati.
Prima di iniziare gli esercizi, guarda questo breve video per ulteriori informazioni sugli schemi e sull’Experience Data Model (XDM):
Autorizzazioni richieste
In Configurare le autorizzazioni Per completare questa lezione, è necessario impostare tutti i controlli di accesso necessari.
Creare uno schema di fedeltà tramite l’interfaccia utente
In questo esercizio, creeremo uno schema per i dati fedeltà di Luma.
- Vai all’interfaccia utente di Platform e accertati che la sandbox sia selezionata.
- Vai a Schemi nel menu di navigazione a sinistra
- Seleziona il pulsante Crea schema in alto a destra
- Dal menu a discesa, seleziona Profilo individuale XDM, in quanto verranno modellati gli attributi di un singolo cliente (punti, stato e così via).
Aggiungi gruppi di campi standard
Verrà quindi richiesto di aggiungere gruppi di campi allo schema. Tutti i campi devono essere aggiunti agli schemi utilizzando i gruppi. Puoi scegliere tra un ampio set di gruppi di campi standard del settore forniti da Adobe o crearne di personalizzati. Quando inizi a modellare i tuoi dati in Experienci Platform, è bene acquisire familiarità con i gruppi di campi standard di settore forniti da Adobe. Quando possibile, è consigliabile utilizzarli in quanto a volte forniscono servizi a valle, come IA per l’analisi dei clienti, Attribution AI e Adobe Analytics.
Quando lavori con i tuoi dati, un grande passo sarà determinare quali dei tuoi dati devono essere acquisiti in Platform e come devono essere modellati. Questo argomento di grandi dimensioni viene discusso in modo più approfondito nel corso Modellare i dati sull’esperienza del cliente con XDM. In questa esercitazione, ti guiderò attraverso l'implementazione di alcuni schemi predeterminati.
Per aggiungere gruppi di campi:
-
In Aggiungi gruppi di campi modale, seleziona i seguenti gruppi di campi:
- Dettagli demografici per dati cliente di base come nome e data di nascita
- Dettagli di contatto personali per dettagli di contatto di base come l’indirizzo e-mail e il numero di telefono
-
Puoi visualizzare in anteprima i campi che hanno contribuito nel gruppo di campi selezionando l’icona a destra della riga.
-
Controlla la Settore > Retail per esporre gruppi di campi specifici del settore.
-
Seleziona Fedeltà per aggiungere i campi programma fedeltà.
-
Seleziona Aggiungi gruppo di campi per aggiungere tutti e tre i gruppi di campi allo schema.
Ora prendi un po’ di tempo per esplorare lo stato corrente dello schema. I gruppi di campi hanno aggiunto campi standard relativi a una persona, ai relativi dettagli di contatto e allo stato del programma fedeltà. Questi due gruppi di campi possono risultare utili quando si creano schemi per i dati della propria azienda. Seleziona una riga specifica del gruppo di campi o seleziona la casella accanto al nome del gruppo di campi per visualizzare le modifiche apportate alla visualizzazione.
Per salvare lo schema:
- Seleziona il nodo principale dello schema.
- Invio
Luma Loyalty Schema
come Nome visualizzato. - Seleziona Salva.
Aggiungere un gruppo di campi personalizzato
Ora creiamo un gruppo di campi personalizzato.
Mentre il gruppo di campi fedeltà conteneva loyaltyID
Luma desidera gestire tutti i propri identificatori di sistema in un unico gruppo per garantire la coerenza tra i diversi schemi.
I gruppi di campi devono essere creati nel flusso di lavoro dello schema. Per creare il gruppo di campi:
- Seleziona Aggiungi sotto Gruppi di campi schema intestazione
- Seleziona Crea nuovo gruppo di campi
- Utilizzare
Luma Identity profile field group
come Nome visualizzato - Utilizzare
system identifiers for XDM Individual Profile class
come Descrizione - Seleziona Aggiungi gruppi di campi
Il nuovo gruppo di campi vuoto viene aggiunto allo schema. Il + I pulsanti possono essere utilizzati per aggiungere nuovi campi a qualsiasi posizione nella gerarchia. Nel nostro caso, vogliamo aggiungere campi a livello principale:
-
Seleziona + accanto al nome dello schema. Questo aggiunge un nuovo campo nello spazio dei nomi dell’ID tenant per gestire i conflitti tra i campi personalizzati e tutti i campi standard.
-
In Proprietà campo barra laterale aggiungi i dettagli del nuovo campo:
- Nome campo:
systemIdentifier
- Nome visualizzato:
System Identifier
- Tipo: Oggetto
- Seleziona Applica
- Nome campo:
Ora aggiungi due campi sotto systemIdentifier
oggetto:
-
Primo campo
- Nome campo:
loyaltyId
- Nome visualizzato:
Loyalty Id
- Tipo: Stringa
- Nome campo:
-
Secondo campo
- Nome campo:
crmId
- Nome visualizzato:
CRM Id
- Tipo: Stringa
- Nome campo:
Il nuovo gruppo di campi sarà simile al seguente. Seleziona la Salva per salvare lo schema, ma lasciare aperto lo schema per l'esercizio successivo.
Creare un tipo di dati
Gruppi di campi, ad esempio il nuovo Luma Identity profile field group
, può essere riutilizzato in altri schemi, consentendo di applicare definizioni di dati standard in più sistemi. Ma possono essere solo riutilizzati negli schemi che condividono una classe, in questo caso la classe XDM Individual Profile.
Il tipo di dati è un altro costrutto a più campi che può essere riutilizzato negli schemi tra più classi. Convertiamo il nostro nuovo systemIdentifier
oggetto in un tipo di dati:
Con il Luma Loyalty Schema
ancora aperto, seleziona la systemIdentifier
oggetto e selezione Converti in nuovo tipo di dati
Se Annulla fuori dallo schema e passare alla Tipi di dati , verrà visualizzato il tipo di dati appena creato. Questo tipo di dati verrà utilizzato più avanti nella lezione.
Creare uno schema di gestione delle relazioni con i clienti tramite API
Ora creeremo uno schema utilizzando l’API.
- Utilizza il Profilo individuale XDM classe
- Assegna un nome
Luma CRM Schema
- Utilizza i seguenti gruppi di campi: Dettagli demografici, Dettagli contatto personale e Gruppo di campi del profilo Identità Luma
Innanzitutto creiamo lo schema vuoto:
-
Apri Postman
-
Se non hai un token di accesso, apri la richiesta OAuth: Request Access Token e seleziona Invia per richiedere un nuovo token di accesso.
-
Apri le variabili di ambiente e modifica il valore di CONTAINER_ID da
global
atenant
. Ricorda, devi utilizzaretenant
ogni volta che desideri interagire con i tuoi elementi personalizzati in Platform, ad esempio la creazione di uno schema. -
Seleziona Salva
-
Apri la richiesta Schema Registry API > Schemas > Create a new custom schema.
-
Apri Corpo Tab e incolla il seguente codice e seleziona Invia per effettuare la chiamata API. Questa chiamata crea un nuovo schema utilizzando lo stesso
XDM Individual Profile
classe base:code language-json { "type": "object", "title": "Luma CRM Schema", "description": "Schema for CRM data of Luma Retail ", "allOf": [{ "$ref": "https://ns.adobe.com/xdm/context/profile" }] }
note note NOTE I riferimenti allo spazio dei nomi in questo e negli esempi di codice successivi (ad esempio https://ns.adobe.com/xdm/context/profile
), può essere ottenuto utilizzando l’elenco di chiamate API con CONTAINER_ID e accetta l’intestazione impostata sui valori corretti. Alcune sono facilmente accessibili anche nell’interfaccia utente. -
Dovresti ricevere un
201 Created
risposta -
Copia
meta:altId
dal corpo della risposta. La utilizzeremo successivamente in un altro esercizio.
-
Il nuovo schema deve essere visibile nell’interfaccia utente, ma senza gruppi di campi
meta:altId
L’ID di schema o può essere ottenuto anche effettuando la richiesta API. Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. con CONTAINER_ID imposta su tenant
e un’intestazione accept application/vnd.adobe.xdm+json
.- Nessun token di autenticazione: esegui OAuth: richiedi token di accesso richiesta di generazione di un nuovo token
401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/
: aggiorna il CONTAINER_ID variabile di ambiente daglobal
atenant
403: PALM Access Denied. POST access is denied for this resource from access control
: verifica le autorizzazioni utente nell’Admin Console
Aggiungi gruppi di campi standard
Ora è il momento di aggiungere i gruppi di campi allo schema:
-
In entrata Postman, Apri la richiesta Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.
-
In Parametri , incolla il
meta:altId
valore della risposta precedente comeSCHEMA_ID
-
Apri la scheda Corpo e incolla il seguente codice e seleziona Invia per effettuare la chiamata API. Questa chiamata aggiunge i gruppi di campi standard al tuo
Luma CRM Schema
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details" } }, { "op": "add", "path": "/allOf/-", "value": { "$ref": "https://ns.adobe.com/xdm/context/profile-person-details" } } ]
-
Dovresti ottenere uno stato OK 200 per la risposta e i gruppi di campi dovrebbero essere visibili come parte dello schema nell’interfaccia utente
Aggiungi gruppo di campi personalizzato
Ora aggiungiamo il nostro Luma Identity profile field group
allo schema. Innanzitutto, dobbiamo trovare l’ID del nuovo gruppo di campi, utilizzando un’API di elenco:
-
Apri la richiesta Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.
-
Seleziona la Invia per recuperare un elenco di tutti i gruppi di campi personalizzati nel tuo account
-
Acquisisci
$id
valore delLuma Identity profile field group
(il tuo sarà diverso dal valore di questa schermata)
-
Apri la richiesta Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID. di nuovo
-
Il Parametri La scheda deve ancora contenere
$id
dello schema -
Apri Corpo e incolla il seguente codice, sostituendo il
$ref
valore con$id
di tua proprietàLuma Identity profile field group
:code language-json [{ "op": "add", "path": "/allOf/-", "value": { "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID" } }]
-
Seleziona Invia
Verifica che il gruppo di campi sia stato aggiunto allo schema controllando sia la risposta API che l’interfaccia.
Crea schema eventi di acquisto offline
Ora creiamo uno schema basato su XDM ExperienceEvent classe per i dati di acquisto offline di Luma. Poiché ora conosci l’interfaccia utente dell’editor schema, ridurrò il numero di schermate nelle istruzioni:
- Creare uno schema con XDM ExperienceEvent classe
- Aggiungi il gruppo di campi standard Dettagli Commerce per acquisire i dettagli comuni dell’ordine. Trascorri qualche minuto ad esplorare gli oggetti al loro interno.
- Cerca
Luma Identity profile field group
. Non è disponibile. Ricorda che i gruppi di campi sono legati a una classe e che non è possibile utilizzarlo poiché per questo schema viene utilizzata una classe diversa. È necessario aggiungere un nuovo gruppo di campi per la classe ExperienceEvent XDM contenente i campi di identità. Il nostro tipo di dati lo renderà molto semplice! - Seleziona la Crea nuovo gruppo di campi pulsante di opzione
- Inserisci il Nome visualizzato as
Luma Identity ExperienceEvent field group
e seleziona la Aggiungi gruppi di campi pulsante - Assicurati che le + pulsanti visualizzati in Struttura per aggiungere nuovi campi
- In entrata Struttura sezione, seleziona + al livello principale dello schema
- Come Nome campo, immetti
systemIdentifier
- Come Nome visualizzato, immetti
System Identifier
- Come Tipo, seleziona Identificatore di sistema che è il tipo di dati personalizzato creato in precedenza
- Seleziona la Applica pulsante
- Assegnare un nome allo schema
Luma Offline Purchase Events Schema
- Seleziona il pulsante Salva
Il tipo di dati ha aggiunto tutti i campi.
Inoltre, seleziona XDM ExperienceEvent sotto Classe intestazione ed ispezione di alcuni campi forniti da questa classe. Tieni presente che i campi _id e timestamp sono obbligatori quando utilizzi la classe ExperienceEvent XDM: questi campi devono essere compilati per ogni record acquisito quando utilizzi questo schema:
Crea schema eventi web
Ora creeremo un altro schema per i dati del sito web di Luma. A questo punto dovresti essere un esperto nella creazione di schemi. Genera lo schema seguente con queste proprietà
Seleziona la Evento esperienza del consumatore gruppo di campi. Questo gruppo di campi contiene gli oggetti commerce e productListItems presenti Dettagli Commerce. Infatti Evento esperienza del consumatore è una combinazione di diversi altri gruppi di campi standard disponibili separatamente. Mixin ExperienceEvent AEP Web SDK gruppo di campi contiene anche altri gruppi di campi, inclusi alcuni degli stessi in Evento esperienza del consumatore. Fortunatamente, si fondono perfettamente.
Non è stato aggiunto il Luma Identity ExperienceEvent field group
a questo schema. Questo perché l’SDK per web ha un modo diverso di raccogliere le identità. Se si seleziona la XDM ExperienceEvent classe in Composizione nell’editor schema, noterai che uno dei campi aggiunti per impostazione predefinita è denominato IdentityMap. IdentityMap viene utilizzato da varie applicazioni di Adobe per il collegamento a Platform. Nella lezione di acquisizione in streaming, vedrai come le identità vengono inviate a Platform tramite identityMap.
Crea schema catalogo prodotti
Utilizzando il Dettagli Commerce e Evento esperienza del consumatore gruppi di campi, Luma segnala alcuni dettagli di eventi relativi al prodotto tramite il tipo di dati productListItems standard. ma dispongono anche di campi aggiuntivi per i dettagli del prodotto che desiderano inviare a Platform. Invece di acquisire tutti questi campi nei loro sistemi di punto vendita e e-commerce, Luma preferirebbe acquisire questi campi direttamente dal proprio sistema di catalogo dei prodotti. Una "relazione di schema" consente di definire una relazione tra due schemi a scopo di classificazione o ricerca. Luma utilizzerà una relazione per classificare i propri dettagli di prodotto. Inizieremo il processo ora e lo completeremo alla fine della prossima lezione.
Innanzitutto, devi creare uno schema per il catalogo prodotti di Luma utilizzando una classe personalizzata:
-
Seleziona la Crea schema e selezionare il pulsante Sfoglia opzione dal menu a discesa
-
Seleziona la Crea nuova classe pulsante di opzione
-
Assegna un nome
Luma Product Catalog Class
-
Lascia Comportamento as Registra
-
Seleziona la Assegna classe pulsante
-
Crea un nuovo gruppo di campi ha chiamato
Luma Product Catalog field group
con i seguenti campi:- productName: Product Name: String
- productCategory: ProductCategory: String
- productColor: Product Color: String
- productSku: Product SKU: String | Obbligatorio
- productSize: Product Size: String
- productPrice: Product Price: Double
-
Denomina lo schema
Luma Product Catalog Schema
(assicurati di aggiornare il campo corretto e non aggiornare il nome della classe) -
Salva lo schema
Il nuovo schema deve essere simile al seguente. Nota come productSku
è elencato nel Campi obbligatori sezione:
Il passaggio successivo consiste nel definire la relazione tra i due schemi ExperienceEvent e Luma Product Catalog Schema
Tuttavia, prima di poter procedere in tal senso, dobbiamo compiere alcuni ulteriori passi.
Risorse aggiuntive
Ora che disponi dei tuoi schemi puoi mappa identità!