Dati del modello negli schemi

In questa lezione, modellerai i dati di Luma in schemi. Questa è una delle lezioni più lunghe del tutorial, quindi prendi un bicchiere d'acqua e fibbia!

La standardizzazione e l'interoperabilità sono concetti chiave alla base di Adobe Experience Platform. Experience Data Model (XDM) è uno sforzo per standardizzare i dati sulla customer experience e definire schemi per la gestione della customer experience.

XDM è una specifica documentata pubblicamente progettata per migliorare il potere delle esperienze digitali. Fornisce strutture e definizioni comuni per qualsiasi applicazione da utilizzare per comunicare con i servizi 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ù rapido e integrato. Puoi ottenere informazioni utili dalle azioni dei clienti, definire il 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 sull'Experience Platform, di inviare il messaggio giusto alla persona giusta, sul canale giusto, al momento 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 dei dati dovrà creare schemi al di fuori di questa esercitazione, ma Ingegneri dati collaborerà strettamente con gli schemi creati dall’architetto dati.

Prima di iniziare gli esercizi, guarda questo breve video per ulteriori informazioni sugli schemi e su Experience Data Model (XDM):

SUGGERIMENTO

Ad Experience Platform, per approfondire la modellazione dei dati, ti consigliamo di seguire il corso Modellare i dati sulla customer experience con XDMdisponibile gratuitamente all'Experience League!

Autorizzazioni necessarie

In Configurare le autorizzazioni per completare la lezione, è necessario impostare tutti i controlli di accesso necessari.

Creare uno schema 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 nella navigazione a sinistra
  3. Seleziona la Crea schema in alto a destra
  4. Dal menu a discesa, seleziona Profilo individuale XDM, poiché verranno modellati gli attributi di un singolo cliente (punti, stato e così via).
    Schema con il 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 che utilizzano i gruppi. Puoi scegliere tra un ampio set di gruppi di campi standard di settore forniti da Adobe o crearne uno personalizzati. Quando inizi a modellare i tuoi dati in Experience Platform, è bene acquisire familiarità con i gruppi di campi standard del settore forniti da Adobe. Quando possibile, è consigliabile utilizzarli in quanto a volte alimentano servizi a valle, come Customer AI, Attribution AI e Adobe Analytics.

Quando lavori con i tuoi dati, un grande passo sarà quello di determinare quali dei tuoi dati devono essere acquisiti in Platform e come dovrebbero essere modellati. Questo grande argomento è discusso più approfonditamente nel corso Modellare i dati sulla customer experience con XDM. In questa esercitazione ti guiderò attraverso l’implementazione di alcuni schemi predefiniti.

Per aggiungere gruppi di campi:

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

    1. Dettagli demografici per i dati di base dei clienti quali nome e data di nascita
    2. Dati di contatto personali per informazioni di contatto di base come indirizzo e-mail e numero di telefono
  2. Puoi visualizzare in anteprima i campi aggiunti al gruppo di campi selezionando l’icona sul lato destro della riga.
    Seleziona gruppi di campi standard

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

  4. Seleziona Fedeltà per aggiungere i campi del 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à

A questo punto, soffermati a esplorare lo stato corrente dello schema. I gruppi di campi hanno aggiunto campi standard relativi a una persona, i relativi dettagli di contatto e lo stato del programma fedeltà. È possibile trovare questi due gruppi di campi utili quando si creano schemi per i dati della propria azienda. Seleziona una riga specifica del gruppo di campi o spunta la casella accanto al nome del gruppo di campi per vedere come cambia la visualizzazione.

Per salvare lo schema:

  1. Selezionare il nodo principale dello schema.
  2. Invio Luma Loyalty Schema come Nome visualizzato.
  3. Seleziona Salva.
    Assegnare un nome e salvare lo schema
NOTA

È corretto se un gruppo di campi aggiunge un campo per un punto dati che non viene raccolto. 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 in seguito.

Aggiungi un gruppo di campi personalizzato

Ora creiamo un gruppo di campi personalizzato.

Mentre il gruppo di campi fedeltà conteneva un loyaltyID Luma desidera gestire tutti i propri identificatori di sistema in un singolo gruppo per garantire la coerenza tra i propri schemi.

I gruppi di campi devono essere creati nel flusso di lavoro dello schema. Per creare il gruppo di campi:

  1. Seleziona Aggiungi in Gruppi di campi dello schema titolo
    Aggiungi un nuovo gruppo di campi

  2. Seleziona Crea nuovo gruppo di campi

  3. Utilizzo Luma Identity profile field group come Nome visualizzato

  4. Utilizzo 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. La + I pulsanti possono essere utilizzati per aggiungere nuovi campi a qualsiasi posizione della gerarchia. Nel nostro caso, desideri aggiungere campi al 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 quelli 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

Aggiungi ora due campi nella sezione 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 dovrebbe essere simile a questo. Seleziona la Salva per salvare lo schema, ma lasciare lo schema aperto per l'esercizio successivo.
Gruppo 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, consentendoti di applicare le definizioni dati standard su più sistemi. Ma possono essere riutilizzati solo in 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 nostro nuovo systemIdentifier oggetto in un tipo di dati:

Con la Luma Loyalty Schema ancora aperto, seleziona systemIdentifier e seleziona Converti in nuovo tipo di dati

Gruppo di campi fedeltà completo

Se Annulla uscire dallo schema e passare al Tipi di dati Il tipo di dati appena creato verrà visualizzato nella scheda . Questo tipo di dati verrà utilizzato più avanti nella lezione.

Gruppo di campi fedeltà completo

Creare uno schema CRM tramite API

Ora creeremo uno schema utilizzando l’API.

SUGGERIMENTO

Se preferisci saltare l’esercizio API, puoi creare il seguente schema utilizzando il metodo dell’interfaccia utente:

  1. Utilizza la Profilo individuale XDM Classe
  2. Denomina Luma CRM Schema
  3. Utilizza i seguenti gruppi di campi: Dettagli demografici, dettagli dei contatti personali e gruppo di campi profilo Luma Identity

Innanzitutto, creiamo lo schema vuoto:

  1. Open Postman

  2. Se non hai effettuato una richiesta nelle ultime 24 ore, i token di autorizzazione probabilmente sono scaduti. Apri la richiesta Adobe I/O Access Token Generation > Local Signing (Non-production use-only) > IMS: JWT Generate + Auth via User Token e seleziona Invia per richiedere nuovi token JWT e Access.

  3. Apri le variabili di ambiente e modifica 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 creare 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 seleziona 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:

    {
      "type": "object",
      "title": "Luma CRM Schema",
      "description": "Schema for CRM data of Luma Retail ",
      "allOf": [{
        "$ref": "https://ns.adobe.com/xdm/context/profile"
      }]
    }
    
    NOTA

    I riferimenti allo spazio dei nomi in questo ed esempi di codice successivi (ad esempio https://ns.adobe.com/xdm/context/profile), può essere ottenuto utilizzando le chiamate API elenco con CONTAINER_ID e accetta intestazione impostata sui valori corretti. Alcuni sono facilmente accessibili anche nell’interfaccia utente di .

  7. Dovresti prendere un 201 Created response

  8. Copia meta:altId dal corpo della risposta. Lo useremo più tardi 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

NOTA

La meta:altId o l’id dello schema può essere ottenuto anche 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 di accettazione application/vnd.adobe.xdm+json.

SUGGERIMENTO

Problemi comuni relativi a questa chiamata e possibili correzioni:

  • Nessun token di autenticazione: Esegui il IMS: JWT Genera + Auth tramite token utente chiamata per generare nuovi token
  • 401: Not Authorized to PUT/POST/PATCH/DELETE for this path : /global/schemas/: Aggiorna 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 Postman, Apri la richiesta Schema Registry API > Schemas > Update one or more attributes of a custom schema specified by ID.

  2. In Parametri , incolla 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:

    [{
        "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. È necessario ottenere uno stato 200 OK 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 la nostra Luma Identity profile field group allo schema. Innanzitutto, devi 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. Afferra la $id del valore Luma Identity profile field group (il tuo sarà diverso dal valore in questa schermata)
    Recupera l’elenco 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. La Parametri la scheda deve ancora avere $id dello schema

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

    [{
      "op": "add",
      "path": "/allOf/-",
      "value": {
        "$ref": "REPLACE_WITH_YOUR_OWN_FIELD_GROUP_ID"
      }
    }]
    
  7. Seleziona Invia

    Aggiunta del gruppo Campo identità

Verifica che il gruppo di campi sia stato aggiunto allo schema controllando sia la risposta API che nell’interfaccia.

Crea schema eventi di acquisto offline

Ora creiamo uno schema basato su ExperienceEvent XDM per i dati di acquisto offline di Luma. Poiché ora hai familiarità con l’interfaccia utente dell’editor dello schema, ridurrò il numero di schermate nelle istruzioni:

  1. Creare uno schema con ExperienceEvent XDM Classe
  2. Aggiungi il gruppo di campi standard Dettagli Commerce per acquisire i dettagli comuni dell’ordine. Passate qualche minuto ad esplorare gli oggetti all'interno.
  3. Cerca Luma Identity profile field group. Non è disponibile! Tenere presente che i gruppi di campi sono legati a una classe e poiché per questo schema utilizziamo una classe diversa, non è possibile utilizzarla. È necessario aggiungere un nuovo gruppo di campi per la classe ExperienceEvent XDM contenente i campi di identità. Il nostro tipo di dati lo renderà davvero facile!
  4. Seleziona la Crea nuovo gruppo di campi pulsante di scelta
  5. Inserisci il Nome visualizzato come Luma Identity ExperienceEvent field group e seleziona la Aggiungi gruppi di campi pulsante
  6. Assicurati che + i pulsanti sono attivati Struttura in modo da poter aggiungere nuovi campi
  7. In Struttura sezione , seleziona + al livello superiore dello schema
  8. Come Nome campo, inserisci systemIdentifier
  9. Come Nome visualizzato, inserisci System Identifier
  10. Come Tipo, seleziona Identificatore del sistema tipo di dati personalizzato creato in precedenza
  11. Seleziona la Applica pulsante
  12. Denomina lo schema Luma Offline Purchase Events Schema
  13. Seleziona la Salva pulsante

Tieni presente che il tipo di dati ha aggiunto tutti i campi.

Aggiungi il tipo di dati al gruppo di campi

Inoltre, seleziona ExperienceEvent XDM in Classe intestazione ed ispezione di alcuni dei campi aggiunti 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 degli eventi di 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! Crea il seguente schema con queste proprietà

Proprietà Valore
Classe ExperienceEvent XDM
Gruppo di campi Mixin ExperienceEvent SDK per web AEP
Gruppo di campi Evento esperienza consumatore
Nome dello schema Schema eventi web Luma

Seleziona la Evento esperienza consumatore gruppo di campi. Questo gruppo di campi contiene gli oggetti commerce e productListItems che si trovavano anche in Dettagli Commerce. Effettivamente Evento esperienza consumatore è una combinazione di diversi altri gruppi di campi standard disponibili separatamente. Mixin ExperienceEvent SDK per web AEP il gruppo di campi contiene anche altri gruppi di campi, inclusi alcuni degli stessi in Evento esperienza consumatore. Fortunatamente si fondono perfettamente.

Nota che non abbiamo 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 selezioni la ExperienceEvent XDM nella classe Composizione nell’editor dello schema, noterai che uno dei campi aggiunti per impostazione predefinita è denominato IdentityMap. IdentityMap viene utilizzato da varie applicazioni di Adobe per effettuare il collegamento a Platform. Nella lezione di streaming ingestion , vedrai come le identità vengono inviate a Platform tramite identityMap.

Crea schema catalogo prodotti

Utilizzando Dettagli Commerce e Evento esperienza consumatore gruppi di campi, Luma segnala alcuni dettagli degli eventi relativi al prodotto tramite il tipo di dati standard productListItems. Ma dispongono anche di campi di dettaglio del prodotto aggiuntivi che desiderano inviare a Platform. Invece di acquisire tutti questi campi nei loro sistemi di punti vendita ed 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 ai fini della classificazione o delle ricerche. Luma utilizzerà una relazione per classificare i dettagli del prodotto. Inizieremo il processo adesso e lo completeremo alla fine della prossima lezione.

NOTA

Se sei un cliente Analytics o Target esistente, la classificazione delle entità con relazioni di schema è simile alle classificazioni di SAINT o al caricamento del catalogo dei prodotti per Recommendations

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

  1. Seleziona la Creare uno schema e seleziona il pulsante Sfoglia dall’elenco a discesa
    Crea nuovo schema
  2. Seleziona la Crea nuova classe pulsante di scelta
  3. Denomina Luma Product Catalog Class
  4. Lascia la Comportamento come Record
  5. Seleziona la Assegna classe pulsante
    Crea nuova classe
  6. Crea un nuovo gruppo di campi chiamato Luma Product Catalog field group con i campi seguenti:
    1. productName: Nome del prodotto: Stringa
    2. productCategory: Categoria di prodotti: Stringa
    3. productColor: Colore del prodotto: Stringa
    4. productSku: SKU del prodotto: Stringa | Obbligatorio
    5. productSize: Dimensioni del prodotto: Stringa
    6. productPrice: Prezzo del prodotto: Doppio
  7. Denomina lo schema Luma Product Catalog Schema (assicurarsi di aggiornare il campo corretto e non aggiornare il nome della classe)
  8. Salva schema

Il nuovo schema dovrebbe essere simile al seguente. Tieni presente che productSku è elencato in Campi obbligatori sezione:
Schema del prodotto

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

Risorse aggiuntive

Ora che hai i tuoi schemi puoi identità mappa!

In questa pagina