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):

TIP
Per un approfondimento sulla modellazione dei dati in Experienci Platform, consigliamo di seguire il corso Modellare i dati sull’esperienza del cliente con XDM, disponibile gratuitamente su Experience League!

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.

  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
  4. Dal menu a discesa, seleziona Profilo individuale XDM, in quanto verranno modellati gli attributi di un singolo cliente (punti, stato e così via).
    Schema con gruppo di campi OOTB

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:

  1. In Aggiungi gruppi di campi modale, seleziona i seguenti gruppi di campi:

    1. Dettagli demografici per dati cliente di base come nome e data di nascita
    2. Dettagli di contatto personali per dettagli di contatto di base come l’indirizzo e-mail e il numero di telefono
  2. 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

  3. Controlla la Settore > Retail per esporre gruppi di campi specifici del settore.

  4. Seleziona Fedeltà per aggiungere i campi programma fedeltà.

  5. Seleziona Aggiungi gruppo di campi per aggiungere tutti e tre i gruppi di campi allo schema.
    Aggiungere 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:

  1. Seleziona il nodo principale dello schema.
  2. Invio Luma Loyalty Schema come Nome visualizzato.
  3. Seleziona Salva.
    Denomina e salva lo 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 deve vengono acquisiti in un secondo momento.

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:

  1. Seleziona Aggiungi sotto Gruppi di campi schema intestazione
    Aggiungi un nuovo gruppo di campi
  2. Seleziona Crea nuovo gruppo di campi
  3. Utilizzare Luma Identity profile field group come Nome visualizzato
  4. Utilizzare 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. Il + 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. In Proprietà campo barra laterale aggiungi i dettagli del nuovo campo:

    1. Nome campo: systemIdentifier
    2. Nome visualizzato: System Identifier
    3. Tipo: Oggetto
    4. Seleziona Applica

    Aggiungi un nuovo gruppo di campi

Ora aggiungi due campi sotto systemIdentifier oggetto:

  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 la Salva per salvare lo schema, ma lasciare aperto lo schema per l'esercizio successivo.
Gruppo di campi fedeltà completato

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

Gruppo di campi fedeltà completato

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.

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. Utilizza il Profilo individuale XDM classe
  2. Assegna un nome 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 hai 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 modifica il valore di CONTAINER_ID da global a tenant. Ricorda, 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
    Modificare CONTAINER_ID in tenant

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

  6. 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.
  7. Dovresti ricevere un 201 Created risposta

  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
Il 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.
TIP
Problemi comuni relativi a questa chiamata e probabili correzioni:
  • 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 da global a tenant
  • 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:

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

  2. In Parametri , incolla il meta:altId valore della 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 il nostro 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 la Invia per recuperare un elenco di tutti i gruppi di campi personalizzati nel tuo account

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

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

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

  6. 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"
      }
    }]
    
  7. Seleziona Invia
    Aggiunta del gruppo di campi 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 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:

  1. Creare uno schema con XDM ExperienceEvent classe
  2. 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.
  3. 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!
  4. Seleziona la Crea nuovo gruppo di campi pulsante di opzione
  5. Inserisci il Nome visualizzato as Luma Identity ExperienceEvent field group e seleziona la Aggiungi gruppi di campi pulsante
  6. Assicurati che le + pulsanti visualizzati in Struttura per aggiungere nuovi campi
  7. In entrata Struttura sezione, seleziona + al livello principale dello schema
  8. Come Nome campo, immetti systemIdentifier
  9. Come Nome visualizzato, immetti System Identifier
  10. Come Tipo, seleziona Identificatore di sistema che è il tipo di dati personalizzato creato in precedenza
  11. Seleziona la Applica pulsante
  12. Assegnare un nome allo schema Luma Offline Purchase Events Schema
  13. Seleziona il pulsante Salva

Il tipo di dati ha aggiunto tutti i campi.

Aggiungere il tipo di dati al gruppo di 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:

Struttura di base dell’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
XDM ExperienceEvent
Gruppo di campi
Mixin ExperienceEvent AEP Web SDK
Gruppo di campi
Evento esperienza consumatore
Nome schema
Schema eventi web Luma

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.

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. Seleziona la Crea schema e selezionare il pulsante Sfoglia opzione dal menu a discesa
    Crea nuovo schema

  2. Seleziona la Crea nuova classe pulsante di opzione

  3. Assegna un nome Luma Product Catalog Class

  4. Lascia Comportamento as Registra

  5. Seleziona la Assegna classe pulsante
    Crea nuova classe

  6. Crea un nuovo gruppo di campi ha chiamato Luma Product Catalog field group con i seguenti campi:

    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
  7. Denomina lo schema Luma Product Catalog Schema (assicurati di aggiornare il campo corretto e non aggiornare il nome della classe)

  8. Salva lo schema

Il nuovo schema deve essere simile al seguente. Nota come productSku è elencato nel Campi obbligatori sezione:
Schema prodotto

Il passaggio successivo consiste nel definire la relazione tra i due schemi ExperienceEvent e Luma Product Catalog SchemaTuttavia, prima di poter procedere in tal senso, dobbiamo compiere alcuni ulteriori passi.

Risorse aggiuntive

Ora che disponi dei tuoi schemi puoi mappa identità!

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