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.
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.
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.
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:
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:
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.
Alla fine di questa lezione, sarai in grado di:
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
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.
Prima di iniziare la creazione dell’oggetto XDM, crea il seguente set di elementi dati mappati su Sito di dimostrazione Luma livello dati:
Vai a Elementi dati e seleziona Aggiungi elemento dati (o Creare un nuovo elemento dati se nella proprietà tag non sono presenti elementi dati)
Denomina l’elemento dati page.pageInfo.pageName
Utilizza il Variabile JavaScript Tipo di elemento dati per puntare a un valore nel livello dati di Luma: digitalData.page.pageInfo.pageName
Seleziona le caselle per Forza valori minuscoli e Pulisci testo per standardizzare l’uso di maiuscole/minuscole e rimuovere spazi estranei
Esci None
come Durata archiviazione poiché questo valore è diverso su ogni pagina
Seleziona Salva
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)
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à.
Successivamente puoi creare l’elemento dati Identity Map:
Vai a Elementi dati e seleziona Aggiungi elemento dati
Nome l’elemento dati identityMap.loginID
Come Estensione, seleziona Adobe Experience Platform Web SDK
Come Tipo di elemento dati, seleziona Identity map
In questo modo viene visualizzata un'area dello schermo a destra all'interno del Interfaccia di Data Collection per configurare l’identità:
Come Namespace, seleziona la Luma CRM Id
spazio dei nomi creato in precedenza nel Configurare le identità lezione.
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.
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.
Come Stato autenticato, seleziona Autenticato
Seleziona Principale
Seleziona Salva
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à.
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, acquisirai 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:
Nel menu di navigazione a sinistra, seleziona Elementi dati
Seleziona Aggiungi elemento dati
Denomina l’elemento dati xdm.content
Come Estensione seleziona Adobe Experience Platform Web SDK
Come Tipo di elemento dati seleziona XDM object
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
Come Schema, seleziona il tuo Luma Web Event Data
schema:
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.
Scorri verso il basso fino a raggiungere il web
oggetto
Seleziona per aprirlo
Mappa le seguenti variabili XDM web su elementi di dati
web.webPageDetials.name
in %page.pageInfo.pageName%
web.webPageDetials.server
in %page.pageInfo.server%
web.webPageDetials.siteSection
in %page.pageInfo.hierarchie1%
Quindi, trova il identityMap
nello schema e selezionarlo
Mappa su identityMap.loginID
elemento dati
Seleziona Salva
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.
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