DocumentazioneExperience PlatformDati modello negli schemi

Dati modello negli schemi

Last update: Thu Oct 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

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 Experience Platform, di inviare il messaggio giusto alla persona giusta, sul canale giusto, nel momento esatto giusto. La metodologia su cui viene generato l'Experience Platform, XDM System, rende operativi gli schemi Experience Data Model per l'utilizzo da parte dei servizi Platform.

Gli architetti di dati dovranno creare schemi al di fuori di questa esercitazione, ma i Data Engineer lavoreranno 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):

video poster

https://video.tv.adobe.com/v/38516?learn=on&captions=ita

TIP
Per un approfondimento sulla modellazione dei dati in Experience Platform, consigliamo di guardare la playlist Modellare i dati sull'esperienza del cliente con XDM, disponibile gratuitamente su Experience League.

Autorizzazioni richieste

Nella lezione Configurare le autorizzazioni è possibile impostare tutti i controlli di accesso necessari per completare la lezione.

Creare uno schema di fedeltà tramite l’interfaccia utente

In questo esercizio, creeremo uno schema per i dati fedeltà di Luma.

  1. Vai all’interfaccia utente di Platform e accertati che la sandbox sia selezionata.

  2. Vai a Schemi nel menu di navigazione a sinistra.

  3. Seleziona il pulsante Crea schema in alto a destra.
    Schema con gruppo di campi OOTB

  4. Nel flusso di lavoro Crea schema, seleziona Profilo individuale come classe base per lo schema, poiché verranno modellati gli attributi di un singolo cliente (punti, stato e così via).

  5. Seleziona Avanti.
    Seleziona classe base

  6. Immetti Luma Loyalty Schema nel campo di testo Schema display name. Nell’area di lavoro seguente, puoi anche rivedere e verificare la struttura dello schema di base fornita dalla classe scelta.

  7. Seleziona Fine per creare lo schema.
    Fine creazione schema fedeltà

Aggiungi gruppi di campi standard

Una volta creato lo schema, verrai reindirizzato all’editor schema, dove potrai aggiungere campi allo schema. Puoi aggiungere campi singoli direttamente allo schema o utilizzare gruppi di campi. È importante notare che tutti i singoli campi sono ancora associati a una classe o a un gruppo di campi. 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 Experience 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 passaggio importante consisterà nel determinare quali dei tuoi dati devono essere acquisiti in Platform e come devono essere modellati. Questo argomento di grandi dimensioni viene discusso più approfonditamente nella playlist 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:

  1. Seleziona Aggiungi nell'intestazione Gruppi di campi.
    Aggiungi un nuovo gruppo di campi

  2. Nel modale Aggiungi gruppi di campi, seleziona i seguenti gruppi di campi:

    1. Dettagli demografici per dati cliente di base come nome e data di nascita
    2. Dati personali per informazioni di contatto di base quali indirizzo e-mail e numero di telefono

  3. Puoi visualizzare in anteprima i campi che hanno contribuito nel gruppo di campi selezionando l’icona a destra della riga.
    Selezionare gruppi di campi standard

  4. Seleziona la casella Settore > Vendita al dettaglio per esporre gruppi di campi specifici del settore.

  5. Seleziona Dettagli fedeltà per aggiungere i campi del programma fedeltà.

  6. Seleziona Aggiungi gruppi di campi per aggiungere tutti e tre i gruppi di campi allo schema.
    Aggiungi gruppi di campi standard allo schema fedeltà

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, selezionare Salva.
Salva schema

NOTE
È possibile aggiungere un campo per un punto dati che non viene raccolto da un gruppo di campi. Ad esempio, "faxPhone" potrebbe essere un campo per il quale Luma non raccoglie dati. Va bene. Solo perché un campo è definito nello schema non significa che i dati per esso devono essere acquisiti in un secondo momento. Puoi anche rimuovere il campo dallo schema.

Aggiungere un gruppo di campi personalizzato

Ora creiamo un gruppo di campi personalizzato.

Anche se il gruppo di campi fedeltà conteneva un campo loyaltyID, Luma vorrebbe gestire tutti i suoi identificatori di sistema in un unico gruppo per garantire la coerenza tra i suoi schemi.

I gruppi di campi devono essere creati nel flusso di lavoro dello schema. Puoi effettuare le seguenti operazioni:

  • Aggiungere prima un nuovo campo personalizzato allo schema, quindi creare un gruppo di campi personalizzato oppure
  • Creare prima un gruppo di campi personalizzato e quindi aggiungervi campi.

Questa esercitazione inizia con la creazione di un gruppo di campi personalizzato.

Per creare il gruppo di campi:

  1. Seleziona Aggiungi nell'intestazione Gruppi di campi schema
    Aggiungi un nuovo gruppo di campi
  2. Seleziona Crea nuovo gruppo di campi
  3. Usa Luma Identity profile field group come Nome visualizzato
  4. Utilizza system identifiers for XDM Individual Profile class come Descrizione
  5. Seleziona Aggiungi gruppi di campi
    Aggiungi un nuovo gruppo di campi

Il nuovo gruppo di campi vuoto viene aggiunto allo schema. I pulsanti + possono essere utilizzati per aggiungere nuovi campi a qualsiasi posizione nella gerarchia. Nel nostro caso, vogliamo aggiungere campi a livello principale:

  1. 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.

  2. Nella barra laterale Proprietà campo aggiungi i dettagli del nuovo campo:

    1. Nome campo: systemIdentifier

    2. Nome visualizzato: System Identifier

    3. Tipo: Oggetto

    4. Nel menu a discesa Gruppo di campi, seleziona il gruppo di campi Profilo identità Luma che abbiamo creato.

      Aggiungi un nuovo gruppo di campi

    5. Seleziona Applica

      Applica nuove proprietà campo

Ora aggiungi due campi sotto l'oggetto systemIdentifier:

  1. Primo campo

    1. Nome campo: loyaltyId
    2. Nome visualizzato: Loyalty Id
    3. Tipo: Stringa

  2. Secondo campo

    1. Nome Campo: crmId
    2. Nome visualizzato: CRM Id
    3. Tipo: Stringa

Il nuovo gruppo di campi sarà simile al seguente. Seleziona il pulsante Salva per salvare lo schema, ma lascia aperto lo schema per l'esercizio successivo.
Gruppo di campi fedeltà completato

Creare un tipo di dati

I gruppi di campi, ad esempio il nuovo Luma Identity profile field group, possono essere riutilizzati in altri schemi, consentendo di applicare definizioni di dati standard in più sistemi. Ma possono essere riutilizzati solo negli schemi che condividono una classe, in questo caso la classe Profilo individuale XDM.

Il tipo di dati è un altro costrutto a più campi che può essere riutilizzato negli schemi in più classi. Convertiamo il nuovo oggetto systemIdentifier in un tipo di dati:

Con Luma Loyalty Schema ancora aperto, selezionare l'oggetto systemIdentifier e selezionare Converti in nuovo tipo di dati

Gruppo di campi fedeltà completato

Se Annulla esce dallo schema e passi alla scheda Tipi di dati, verrà visualizzato il nuovo tipo di dati creato. Questo tipo di dati verrà utilizzato più avanti nella lezione.

Gruppo di campi fedeltà completato

Creare uno schema di gestione delle relazioni con i clienti tramite API

Ora creeremo uno schema utilizzando l’API.

TIP
Se preferisci saltare l’esercizio API, puoi creare il seguente schema utilizzando il metodo dell’interfaccia utente:
  1. Usa la classe Profilo individuale
  2. Denomina Luma CRM Schema
  3. Utilizza i seguenti gruppi di campi: Dettagli demografici, Dettagli contatto personale e Gruppo di campi del profilo Identità Luma

Innanzitutto creiamo lo schema vuoto:

  1. Apri Postman

  2. Se non disponi di un token di accesso, apri la richiesta OAuth: Request Access Token e seleziona Invia per richiedere un nuovo token di accesso.

  3. Apri le variabili di ambiente e cambia il valore di CONTAINER_ID da global a tenant. Ricorda che devi utilizzare tenant ogni volta che desideri interagire con i tuoi elementi personalizzati in Platform, ad esempio la creazione di uno schema.

  4. Seleziona Salva
    Modifica CONTAINER_ID in tenant

  5. Apri la richiesta Schema Registry API > Schemas > Create a new custom schema.

  6. Apri la scheda Corpo e incolla il seguente codice e seleziona Invia per effettuare la chiamata API. Questa chiamata crea un nuovo schema utilizzando la stessa classe base XDM Individual Profile:

    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 nei successivi esempi di codice (ad esempio https://ns.adobe.com/xdm/context/profile), possono essere ottenuti utilizzando le chiamate API di elenco con CONTAINER_ID e accettando l'intestazione impostata sui valori corretti. Alcune sono facilmente accessibili anche nell’interfaccia utente.

  7. Dovresti ricevere una risposta 201 Created

  8. Copia meta:altId dal corpo della risposta. La utilizzeremo successivamente in un altro esercizio.
    Creare lo schema CRM

  9. Il nuovo schema deve essere visibile nell’interfaccia utente, ma senza gruppi di campi
    Creare lo schema CRM

NOTE
È inoltre possibile ottenere l'ID di schema o meta:altId effettuando la richiesta API Schema Registry API > Schemas > Retrieve a list of schemas within the specified container. con CONTAINER_ID impostato su tenant e un'intestazione Accept application/vnd.adobe.xdm+json.
TIP
Problemi comuni relativi a questa chiamata e probabili correzioni:
  • Nessun token di autenticazione: esegui la richiesta OAuth: Request Access Token per generare un nuovo token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: aggiorna la variabile di ambiente CONTAINER_ID da global a tenant
  • 403: PALM Access Denied. POST access is denied for this resource from access control: verificare le autorizzazioni utente nell'Admin Console

Aggiungi gruppi di campi standard

Ora è il momento di aggiungere i gruppi di campi allo schema:

  1. In Postman, apri la richiesta Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. Nella scheda Parametri, incolla il valore meta:altId dalla risposta precedente come SCHEMA_ID

  3. 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"
    }
  }
]

  4. Dovresti ottenere uno stato OK 200 per la risposta e i gruppi di campi dovrebbero essere visibili come parte dello schema nell’interfaccia utente

    Gruppi di campi standard aggiunti

Aggiungi gruppo di campi personalizzato

Ora aggiungiamo Luma Identity profile field group allo schema. Innanzitutto, dobbiamo trovare l’ID del nuovo gruppo di campi, utilizzando un’API di elenco:

  1. Apri la richiesta Schema Registry API > Field groups > Retrieve a list of field groups within the specified container.

  2. Seleziona il pulsante Invia per recuperare un elenco di tutti i gruppi di campi personalizzati nel tuo account

  3. Acquisisci il valore $id di Luma Identity profile field group (il tuo sarà diverso dal valore in questa schermata)
    Recupera lelenco dei gruppi di campi

  4. Apri di nuovo la richiesta Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  5. La scheda Parametri deve contenere ancora $id dello schema

  6. Apri la scheda Corpo e incolla il seguente codice, sostituendo il valore $ref con il $id del tuo Luma Identity profile field group:

    code language-json 
    [{
  "op": "add",
  "path": "/allOf/-",
  "value": {
    "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
  }
}]

  7. Seleziona Invia
    Aggiunta del gruppo di campi di identità

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 sulla classe Experience Event per i dati di acquisto offline di Luma. Poiché ora conosci l’interfaccia utente dell’editor schema, ridurrò il numero di schermate nelle istruzioni:

  1. Crea uno schema con la classe Experience Event.
  2. Denomina lo schema Luma Offline Purchase Events Schema.
  3. Aggiungi il gruppo di campi standard Dettagli Commerce per acquisire i dettagli dell'ordine comuni. Trascorri qualche minuto ad esplorare gli oggetti al loro interno.
  4. 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!
  5. Seleziona il pulsante di scelta Crea nuovo gruppo di campi
  6. Immetti Nome visualizzato come Luma Identity ExperienceEvent field group e seleziona il pulsante Aggiungi gruppi di campi
  7. Seleziona + accanto al nome dello schema.
  8. Come Nome campo, immetti systemIdentifier.
  9. Come Nome visualizzato, immetti System Identifier.
  10. Come Tipo, selezionare Identificatore di sistema che è il tipo di dati personalizzato creato in precedenza.
  11. Come Gruppo di campi, seleziona Gruppo di campi ExperienceEvent Luma Identity.
  12. Selezionare il pulsante Applica.
  13. Seleziona il pulsante Salva.

Il tipo di dati ha aggiunto tutti i campi.

Aggiungi il tipo di dati al gruppo di campi

Inoltre, seleziona XDM ExperienceEvent sotto l'intestazione Class ed esamina alcuni dei 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:

Struttura base evento esperienza

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à

Proprietà
Valore
Classe
Evento esperienza
Nome schema
Schema eventi web Luma
Gruppo di campi
ExperienceEvent di AEP Web SDK
Gruppo di campi
Evento esperienza del consumatore

Seleziona il gruppo di campi Evento esperienza del consumatore. Questo gruppo di campi contiene gli oggetti commerce e productListItems presenti anche in Dettagli Commerce. In effetti Consumer Experience Event è una combinazione di diversi altri gruppi di campi standard disponibili separatamente. Il gruppo di campi ExperienceEvent di AEP Web SDK contiene anche altri gruppi di campi, inclusi alcuni degli stessi in Evento esperienza del consumatore. Fortunatamente, si fondono perfettamente.

Non è stato aggiunto 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 classe XDM ExperienceEvent nella sezione Composition dell'editor schema, si noterà che uno dei campi aggiunti per impostazione predefinita è denominato IdentityMap. IdentityMap viene utilizzato da varie applicazioni 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 i gruppi di campi Dettagli Commerce e Evento esperienza del consumatore, 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.

NOTE
Se sei un cliente Analytics o Target esistente, la classificazione delle entità con relazioni di schema è analoga alla classificazione SAINT o al caricamento del catalogo prodotti per Recommendations

Innanzitutto, devi creare uno schema per il catalogo prodotti di Luma utilizzando una classe personalizzata:

  1. Selezionare il pulsante Crea schema.

  2. Nel flusso di lavoro Crea schema, seleziona l'opzione Altro.
    Crea nuovo schema

  3. Seleziona il pulsante Crea classe

  4. Denomina Luma Product Catalog Class

  5. Lascia Comportamento come Record

  6. Seleziona il pulsante Crea.
    Crea nuova classe

  7. La classe del catalogo prodotti Luma creata viene visualizzata nella tabella Classi seguente. Assicurati che la classe sia selezionata, quindi seleziona Successivo.
    Nuova classe aggiunta

  8. Denomina lo schema Luma Product Catalog Schema.

  9. Crea un nuovo gruppo di campi denominato Luma Product Catalog field group con i campi seguenti:

    1. productName: Product Name: String
    2. productCategory: ProductCategory: String
    3. productColor: Product Color: String
    4. productSku: Product SKU: String | Obbligatorio
    5. productSize: Product Size: String
    6. productPrice: Product Price: Double

  10. Salva lo schema

Il nuovo schema deve essere simile al seguente. Il campo productSku è elencato nella sezione Campi obbligatori:
Schema prodotto

Il passaggio successivo consiste nel definire la relazione tra i due schemi ExperienceEvent e Luma Product Catalog Schema. Tuttavia, prima di procedere, è necessario eseguire alcuni passaggi aggiuntivi nella lezione successiva.

Risorse aggiuntive

Ora che hai i tuoi schemi puoi mappare le identità!

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad