Creare elementi dati

CAUTION
Prevediamo di pubblicare modifiche principali a questo tutorial venerdì 15 marzo 2024. Dopo questo punto molti esercizi cambieranno e potrebbe essere necessario riavviare l'esercitazione dall'inizio per completare tutte le lezioni.

Scopri come creare gli elementi dati essenziali necessari per acquisire i dati con Experienci Platform Web SDK. Acquisire sia contenuti che dati di identità sul Sito di dimostrazione Luma. Scopri come utilizzare lo schema XDM creato in precedenza per la raccolta di dati tramite Platform Web SDK tramite un nuovo tipo di elemento dati denominato Oggetto XDM.

NOTE
A scopo dimostrativo, gli esercizi di questa lezione si basano sull’esempio utilizzato durante Configurare uno schema passaggio; creazione di oggetti XDM di esempio che acquisiscono il contenuto visualizzato e le identità degli utenti sul Sito di dimostrazione Luma.
IMPORTANT
I dati per questa lezione provengono da digitalData sul sito Luma. Per visualizzare il livello dati, apri la console per sviluppatori e digita digitalData per visualizzare l’intero livello dati disponibile. livello dati digitalData

Indipendentemente da Platform Web SDK, è necessario continuare a creare all’interno della proprietà tag elementi di dati che vengono mappati dalle variabili di raccolta dati del sito web, ad esempio un livello di dati, un attributo HTML o altri. Una volta creati, tali elementi dati devono essere mappati sullo schema XDM creato durante il configurare gli schemi lezione. A tal fine, l’estensione Platform Web SDK rende disponibile un nuovo tipo di elemento dati denominato oggetto XDM. Pertanto, la creazione di elementi dati consiste in due azioni:

  1. Mappatura delle variabili del sito web con elementi di dati e
  2. Mappatura di tali elementi dati a un oggetto XDM

Per il passaggio 1, continui a mappare il livello dati agli elementi dati nello stesso modo in cui lo mappi attualmente, utilizzando uno qualsiasi dei tipi di elementi dati dell’estensione tag Core. Per il passaggio 2, l’estensione Platform Web SDK crea un set di nuovi tipi di elementi dati non disponibili in precedenza:

  • ID unione evento
  • Mappa identità
  • Oggetto XDM

Questa lezione si concentra sui tipi di elementi dati di tipo Oggetto XDM e Mappa delle identità. Verranno creati oggetti XDM per acquisire l’attività e lo stato di autenticazione dei visitatori Luma.

Obiettivi di apprendimento

Alla fine di questa lezione, sarai in grado di:

  • Creare elementi di dati per acquisire contenuti e dati ID di accesso utente
  • Creare un elemento dati della mappa di identità
  • Mappare elementi dati a un elemento dati di oggetti XDM

Prerequisiti

Conoscere cos’è un livello dati, acquisire familiarità con Sito di dimostrazione Luma e sapere come fare riferimento agli elementi dati nei tag. Devi aver completato i seguenti passaggi precedenti nell’esercitazione

IMPORTANT
Il Estensione del servizio ID Experience Cloud non è necessario quando si implementa Adobe Experience Platform Web SDK, in quanto la funzionalità del servizio ID è integrata in Platform Web SDK.

Creare elementi dati per acquisire il livello dati

Prima di iniziare la creazione dell’oggetto XDM, crea il seguente set di elementi dati mappati su Sito di dimostrazione Luma livello dati:

  1. Vai a Elementi dati e seleziona Aggiungi elemento dati (o Creare un nuovo elemento dati se nella proprietà tag non sono presenti elementi dati)

    Crea elemento dati

  2. Denomina l’elemento dati page.pageInfo.pageName

  3. Utilizza il Variabile JavaScript Tipo di elemento dati per puntare a un valore nel livello dati di Luma: digitalData.page.pageInfo.pageName

  4. Seleziona le caselle per Forza valore minuscolo e Pulisci testo per standardizzare l'uso di maiuscole/minuscole e rimuovere spazi estranei

  5. Esci None come Durata archiviazione poiché questo valore è diverso su ogni pagina

  6. Seleziona Salva

    Elemento dati Nome pagina

Segui gli stessi passaggi per creare questi quattro elementi dati aggiuntivi:

  • page.pageInfo.server mappato a
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 mappato a
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username mappato a
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn mappato a
    digitalData.user.0.profile.0.attributes.loggedIn

  • cart.orderId mappato a digitalData.cart.orderId (utilizzerai durante il Configurazione analisi lezione)

CAUTION
Il Variabile JavaScript il tipo di elemento dati tratta i riferimenti di array come punti invece che come parentesi, facendo riferimento all’elemento dati username come digitalData.user[0].profile[0].attributes.username non funzionerà.

Creare un elemento dati di Identity Map

Successivamente puoi creare l’elemento dati Identity Map:

  1. Vai a Elementi dati e seleziona Aggiungi elemento dati

  2. Nome l’elemento dati identityMap.loginID

  3. Come Estensione, seleziona Adobe Experience Platform Web SDK

  4. Come Tipo di elemento dati, seleziona Identity map

  5. In questo modo viene visualizzata un'area dello schermo a destra all'interno del Interfaccia di Data Collection per configurare l’identità:

    Interfaccia di Data Collection

  6. Come Namespace, seleziona la Luma CRM Id spazio dei nomi creato in precedenza nel Configurare le identità lezione.

    note note
    NOTE
    Se non vedi il tuo Luma CRM Id spazio dei nomi, verifica di averlo creato anche nella sandbox di produzione predefinita. Solo gli spazi dei nomi creati nella sandbox di produzione predefinita vengono attualmente visualizzati nel menu a discesa dello spazio dei nomi.
  7. Dopo il Namespace deve essere impostato un ID. Seleziona la user.profile.attributes.username elemento dati creato in precedenza in questa lezione, che acquisisce un ID quando gli utenti vengono registrati nel sito Luma.

  8. Come Stato autenticato, seleziona Autenticato

  9. Seleziona Principale

  10. Seleziona Salva

    Interfaccia di Data Collection

TIP
L’Adobe consiglia di inviare identità che rappresentano una persona, come Luma CRM Id, come primario identità.
Se la mappa di identità contiene l’identificatore della persona (ad es. Luma CRM Id), l'identificatore della persona diventa primario identità. Altrimenti, ECID diventa primario identità.

Mappatura di elementi dati su oggetti XDM

Tutti gli elementi dati creati devono essere mappati su un oggetto XDM. Questo oggetto deve essere conforme allo schema XDM creato durante la Configurare uno schema lezione.

Esistono diversi modi per mappare gli elementi dati ai campi oggetto XDM. È possibile mappare singoli elementi dati a singoli campi XDM o mappare elementi dati a interi oggetti XDM, purché l’elemento dati corrisponda esattamente allo schema della coppia chiave-valore presente nell’oggetto XDM. In questa lezione verranno acquisiti i dati del contenuto mediante il mapping a singoli campi. Imparerai a mappare un elemento dati a un intero oggetto XDM nel Configurazione analisi lezione.

Crea un oggetto XDM per acquisire i dati del contenuto:

  1. Nel menu di navigazione a sinistra, seleziona Elementi dati

  2. Seleziona Aggiungi elemento dati

  3. Nome l’elemento dati xdm.content

  4. Come Estensione seleziona Adobe Experience Platform Web SDK

  5. Come Tipo di elemento dati seleziona XDM object

  6. Seleziona la piattaforma Sandbox in cui hai creato lo schema XDM in durante la Configurare uno schema XDM lezione, in questo esempio DEVELOPMENT Mobile and Web SDK Courses

  7. Come Schema, seleziona il tuo Luma Web Event Data schema:

    Oggetto XDM

    note note
    NOTE
    La sandbox corrisponde all’Experience Platform di sandbox in cui è stato creato lo schema. Nell’istanza di Experience Platform possono essere disponibili più sandbox, quindi assicurati di selezionare quella giusta. Lavora sempre prima nello sviluppo, poi nella produzione.
  8. Scorri verso il basso fino a raggiungere il web oggetto

  9. Seleziona per aprirlo

    Oggetto Web

  10. Mappa le seguenti variabili XDM web su elementi di dati

    • web.webPageDetials.name a %page.pageInfo.pageName%
    • web.webPageDetials.server a %page.pageInfo.server%
    • web.webPageDetials.siteSection a %page.pageInfo.hierarchie1%

    Oggetto XDM

  11. Quindi, trova il identityMap nello schema e selezionarlo

  12. Mappa su identityMap.loginID elemento dati

  13. Seleziona Salva

    Interfaccia di Data Collection

Al termine di questi passaggi, dovresti aver creato i seguenti elementi di dati:

Elementi dati dell'estensione CORE
Elementi dati di Platform Web SDK
cart.orderId
identityMap.loginID
page.pageInfo.hierarchie1
xdm.content
page.pageInfo.pageName
page.pageInfo.server
user.profile.attributes.loggedIn
user.profile.attributes.username

Una volta impostati questi elementi dati, puoi iniziare a inviare dati a Platform Edge Network tramite l’oggetto XDM creando una regola nei tag.

Successivo:

NOTE
Grazie per aver dedicato il tuo tempo all’apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere feedback generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4