Documentazione Experience Platform Tutorial su Web SDK

Trasmettere i dati per dare Experience Platform con Web SDK

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Principiante
Intermedio
Sviluppatore

Scopri come trasferire i dati web in streaming a Adobe Experience Platform con Platform Web SDK.

Experience Platform è la spina dorsale di tutte le nuove applicazioni Experience Cloud, come Adobe Real-time Customer Data Platform, Adobe Customer Journey Analytics e Adobe Journey Optimizer. Queste applicazioni sono progettate per utilizzare Platform Web SDK come metodo ottimale per la raccolta di dati web.

Diagramma Web SDK e Adobe Experience Platform

Experience Platform utilizza lo stesso schema XDM creato in precedenza per acquisire i dati dell’evento dal sito web Luma. Quando tali dati vengono inviati all’Edge Network di Platform, la configurazione dello stream di dati può inoltrarli all’Experience Platform.

Obiettivi di apprendimento

Alla fine di questa lezione, potrai:

Creare un set di dati in Adobe Experience Platform
Configurare lo stream di dati per inviare dati Web SDK a Adobe Experience Platform
Abilitare lo streaming dei dati web per Real-Time Customer Profile
Convalidare i dati sono stati inseriti sia nel set di dati di Platform che nel profilo cliente in tempo reale
Acquisire i dati del programma fedeltà di esempio in Platform
Creare un pubblico di Platform semplice

Prerequisiti

Per completare questa lezione, devi prima:

Accedere a un’applicazione Adobe Experience Platform come Real-time Customer Data Platform, Journey Optimizer o Customer Journey Analytics
Completa le lezioni precedenti nelle sezioni Configurazione iniziale e Configurazione tag di questa esercitazione.

NOTE

Se non disponi di applicazioni Platform, puoi saltare questa lezione o continuare a leggerla.

Creare un set di dati

Tutti i dati acquisiti correttamente in Adobe Experience Platform vengono memorizzati nel data lake come set di dati. Un set di dati è un costrutto di archiviazione e gestione per una raccolta di dati, in genere una tabella che contiene uno schema (colonne) e campi (righe). I set di dati contengono anche metadati che descrivono vari aspetti dei dati memorizzati.

Configuriamo un set di dati per i dati dell’evento web Luma:

Vai all'interfaccia Experience Platform o Journey Optimizer
Conferma di trovarti nella sandbox di sviluppo che stai utilizzando per questa esercitazione
Apri Gestione dati > Set di dati dal menu di navigazione a sinistra
Seleziona Crea set di dati
Seleziona l'opzione Crea set di dati dallo schema
Seleziona lo schema Luma Web Event Data creato nella lezione precedente, quindi seleziona Successivo
Fornisci un Nome e una Descrizione facoltativi per il set di dati. Per questo esercizio, utilizza Luma Web Event Data, quindi seleziona Fine

Ora è configurato un set di dati per iniziare a raccogliere dati dall’implementazione di Platform Web SDK.

Configurare lo stream di dati

Ora puoi configurare il flusso di dati per inviare dati a Adobe Experience Platform. Lo stream di dati è il collegamento tra la proprietà tag, l’Edge Network di Platform e il set di dati di Experience Platform.

Apri l'interfaccia Raccolta dati
Seleziona Datastreams dal menu di navigazione a sinistra
Apri lo stream di dati creato nella lezione Configurare uno stream di dati, Luma Web SDK
Seleziona Aggiungi servizio
Seleziona Adobe Experience Platform come Servizio
Seleziona Luma Web Event Data come Set di dati evento
Seleziona Salva.

Quando generi traffico sul sito demo Luma mappato alla proprietà tag, i dati popolano il set di dati in Experience Platform.

Convalidare il set di dati

Questo passaggio è fondamentale per assicurarsi che i dati siano arrivati nel set di dati. Esistono due aspetti della convalida dei dati inviati al set di dati.

Convalida tramite Experience Platform Debugger
Convalida tramite Anteprima set di dati
Convalida tramite Query Service

Experience Platform Debugger

Questi passaggi sono più o meno gli stessi della lezione di Debugger. Tuttavia, poiché i dati verranno inviati a Platform solo dopo averli abilitati nello stream di dati, devi generare altri dati di esempio:

Apri il sito di dimostrazione Luma e seleziona l'icona dell'estensione Experience Platform Debugger
Configura il debugger per mappare la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione Convalida con debugger
Accedi al sito Luma utilizzando le credenziali test@adobe.com/test
Torna alla home page di Luma
All’interno dei beacon di rete di Platform Web SDK mostrati dal debugger, seleziona la riga "events" (eventi) per espandere i dettagli in un pop-up
Cerca "identityMap" all’interno del pop-up. Qui dovresti trovare lumaCrmId con tre chiavi di authenticatedState, id e primary

Ora i dati devono essere inseriti nel set di dati Luma Web Event Data e pronti per la convalida "Anteprima set di dati".

Visualizzare l’anteprima del set di dati

Per verificare che i dati siano stati inseriti nel data lake di Platform, un'opzione rapida consiste nell'utilizzare la funzione Anteprima set di dati. I dati dell’SDK per web vengono inviati in micro-batch al data lake e aggiornati periodicamente nell’interfaccia di Platform. Potrebbero essere necessari 10-15 minuti per visualizzare i dati generati.

Nell'interfaccia Experience Platform, seleziona Gestione dati > Set di dati nel menu di navigazione a sinistra per aprire il dashboard Set di dati.

Il dashboard elenca tutti i set di dati disponibili per l’organizzazione. Vengono visualizzati i dettagli di ciascun set di dati elencato, compreso il nome, lo schema a cui il set di dati aderisce e lo stato dell’esecuzione di acquisizione più recente.
Seleziona il set di dati Luma Web Event Data per aprirne la schermata Attività set di dati.

La schermata dell’attività include un grafico che visualizza la frequenza dei messaggi utilizzati e un elenco dei batch riusciti e non riusciti.
Dalla schermata Attività set di dati, seleziona Anteprima set di dati nell'angolo superiore destro dello schermo per visualizzare in anteprima fino a 100 righe di dati. Se il set di dati è vuoto, il collegamento di anteprima viene disattivato.

Nella finestra di anteprima, a destra viene visualizzata la vista gerarchica dello schema per il set di dati.

Eseguire una query sui dati

Nell'interfaccia Experience Platform, seleziona Gestione dati > Query nel menu di navigazione a sinistra per aprire la schermata Query.
Seleziona Crea query
Eseguire innanzitutto una query per visualizzare tutti i nomi delle tabelle nel data lake. Immettere SHOW TABLES nell'editor delle query e fare clic sull'icona di riproduzione per eseguire la query.
Nei risultati, il nome della tabella sarà simile a luma_web_event_data
Eseguire una query sulla tabella con una semplice query che fa riferimento alla tabella (per impostazione predefinita la query è limitata a 100 risultati): SELECT * FROM "luma_web_event_data"
Dopo alcuni istanti dovresti vedere dei record di esempio dei tuoi dati web.

ERROR

Se ricevi un errore di tipo "Tabella non predisposta", controlla nuovamente il nome della tabella. Potrebbe anche darsi che il microbatch di dati non sia ancora approdato nel data lake. Riprova tra 10-15 minuti.

INFO

Per ulteriori dettagli sul servizio query di Adobe Experience Platform, vedi Esplora i dati nella sezione Esercitazioni di Platform.

Abilitare il set di dati e lo schema per Real-Time Customer Profile

Per i clienti di Real-time Customer Data Platform e Journey Optimizer, il passaggio successivo consiste nell’abilitare il set di dati e lo schema per Real-Time Customer Profile. Lo streaming di dati da Web SDK sarà una delle molte origini dati che fluiranno in Platform e desideri unire i tuoi dati web con altre origini dati per creare profili cliente a 360 gradi. Per ulteriori informazioni su Real-Time Customer Profile, guarda questo breve video:

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

CAUTION

Quando lavori con il tuo sito web e i tuoi dati, ti consigliamo di convalidarli in modo più affidabile prima di abilitarli per Real-Time Customer Profile.

Per abilitare il set di dati:

Apri il set di dati creato, Luma Web Event Data
Seleziona Attiva/Disattiva profilo per attivarlo
Conferma di voler abilitare il set di dati

Per abilitare lo schema:

Apri lo schema creato, Luma Web Event Data
Seleziona Attiva/Disattiva profilo per attivarlo

Selezionare I dati per questo schema conterranno un'identità primaria nel campo identityMap.

note important
IMPORTANT
Le identità primarie sono necessarie in ogni record inviato a Real-Time Customer Profile. In genere, i campi di identità sono etichettati all’interno dello schema. Quando si utilizzano le mappe di identità, tuttavia, i campi di identità non sono visibili all’interno dello schema. Questa finestra di dialogo conferma che hai in mente un’identità primaria e che la specificherai in una mappa di identità al momento dell’invio dei dati. Come sai, Web SDK utilizza una mappa di identità con l’ID Experience Cloud (ECID) come identità primaria predefinita e un ID autenticato come identità primaria, se disponibile.

note important

IMPORTANT

Le identità primarie sono necessarie in ogni record inviato a Real-Time Customer Profile. In genere, i campi di identità sono etichettati all’interno dello schema. Quando si utilizzano le mappe di identità, tuttavia, i campi di identità non sono visibili all’interno dello schema. Questa finestra di dialogo conferma che hai in mente un’identità primaria e che la specificherai in una mappa di identità al momento dell’invio dei dati. Come sai, Web SDK utilizza una mappa di identità con l’ID Experience Cloud (ECID) come identità primaria predefinita e un ID autenticato come identità primaria, se disponibile.

Seleziona Abilita
Seleziona Salva per salvare lo schema aggiornato

Ora lo schema è abilitato anche per il profilo.

IMPORTANT

Una volta abilitato lo schema per il profilo, non è possibile disattivarlo o eliminarlo senza reimpostare o eliminare l’intera sandbox. Inoltre, i campi non possono essere rimossi dallo schema dopo questo punto.

Quando lavori con i tuoi dati, ti consigliamo di eseguire le operazioni nel seguente ordine:

Innanzitutto, acquisisci alcuni dati nei set di dati.
Risolvi eventuali problemi che sorgono durante il processo di acquisizione dei dati (ad esempio, problemi di convalida o mappatura dei dati).
Abilitare i set di dati e gli schemi per il profilo
Riacquisire i dati, se necessario

Convalidare un profilo

Puoi cercare un profilo cliente nell’interfaccia di Platform (o nell’interfaccia di Journey Optimizer) per verificare che i dati siano stati inseriti nel profilo cliente in tempo reale. Come suggerisce il nome, i profili si popolano in tempo reale, quindi non si verifica alcun ritardo come con la convalida dei dati nel set di dati.

Innanzitutto devi generare più dati campione. Ripeti i passaggi precedenti di questa lezione per accedere al sito web Luma quando è mappato alla proprietà tag. Inspect richiede Platform Web SDK per assicurarsi che invii dati con lumaCRMId.

Nell'interfaccia Experience Platform, seleziona Cliente > Profili nell'area di navigazione a sinistra
Poiché lo spazio dei nomi Identity utilizza lumaCRMId
Copia e incolla il valore di lumaCRMId passato nella chiamata esaminata nel debugger Experience Platform, in questo caso 112ca06ed53d3db37e4cea49cc45b71e.
Se nel profilo di lumaCRMId è presente un valore valido, nella console viene popolato un ID profilo:

Per visualizzare il Profilo cliente completo per ogni ID, seleziona il ID profilo nella finestra principale.

note note
NOTE
Nota: è possibile selezionare il collegamento ipertestuale dell’ID profilo oppure, se si seleziona la riga, viene visualizzato un menu a destra in cui è possibile selezionare il collegamento ipertestuale ID profilo

Qui puoi visualizzare tutte le identità collegate a lumaCRMId, ad esempio ECID.

Profilo cliente

Ora hai abilitato Platform Web SDK, ad Experience Platform (e Real-Time CDP! E Journey Optimizer! E Customer Journey Analytics!).

Creare uno schema Fedeltà e acquisire dati di esempio

Il completamento di questo esercizio è previsto per i clienti di Real-time Customer Data Platform e Journey Optimizer.

Quando i dati dell’SDK web vengono acquisiti in Adobe Experience Platform, possono essere arricchiti da altre origini dati acquisite in Platform. Ad esempio, quando un utente accede al sito Luma, in Experience Platform viene creato un grafico delle identità e tutti gli altri set di dati abilitati per il profilo possono essere potenzialmente uniti per creare profili cliente in tempo reale. Per vedere questo in azione, crea rapidamente un altro set di dati in Adobe Experience Platform con alcuni dati di fedeltà di esempio, in modo da poter utilizzare i profili cliente in tempo reale con Real-time Customer Data Platform e Journey Optimizer. Poiché hai già fatto esercizi simili, le istruzioni saranno brevi.

Creare lo schema fedeltà:

Crea un nuovo schema
Scegli Profilo individuale come classe base
Denomina lo schema Luma Loyalty Schema
Aggiungi il gruppo di campi Dettagli fedeltà
Aggiungi il gruppo di campi Dettagli demografici
Selezionare il campo Person ID e contrassegnarlo come Identità e Identità primaria utilizzando lo spazio dei nomi Luma CRM Id Identità.
Abilita lo schema per Profilo. Se non riesci a trovare l’interruttore Profilo, prova a fare clic sul nome dello schema in alto a sinistra.
Salvare lo schema

Per creare il set di dati e acquisire i dati di esempio:

Crea un nuovo set di dati da Luma Loyalty Schema
Denomina il set di dati Luma Loyalty Dataset
Abilita il set di dati per Profilo
Scarica il file di esempio luma-loyalty-forWeb.json
Trascinare il file nel set di dati
Conferma che i dati siano stati acquisiti correttamente

Creazione di un pubblico

I tipi di pubblico raggruppano i profili in base alle caratteristiche comuni. Crea un pubblico rapido da utilizzare nella campagna web:

Nell'interfaccia di Experience Platform o Journey Optimizer, vai a Cliente > Tipi di pubblico nel menu di navigazione a sinistra
Seleziona Crea pubblico
Seleziona Genera regola
Seleziona Crea
Seleziona Attributi
Trova il campo Fedeltà > Livello e trascinalo nella sezione Attributi
Definisci il pubblico come utenti il cui tier è gold
Denomina il pubblico Luma Loyalty Rewards – Gold Status
Seleziona Edge come metodo di valutazione
Seleziona Salva

Poiché si tratta di un pubblico molto semplice, possiamo utilizzare il metodo di valutazione Edge. I tipi di pubblico di Edge valutano al limite, quindi nella stessa richiesta effettuata dall’SDK per web all’Edge Network di Platform, possiamo valutare la definizione del pubblico e confermare immediatamente se l’utente sarà idoneo.

NOTE

Grazie per aver dedicato il tuo tempo all’apprendimento di Adobe Experience Platform Web SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo Experience League post di discussione della community

recommendation-more-help

8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4