Trasmettere i dati per dare Experience Platform con Web SDK

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:

  1. Vai all'interfaccia Experience Platform o Journey Optimizer

  2. Conferma di trovarti nella sandbox di sviluppo che stai utilizzando per questa esercitazione

  3. Apri Gestione dati > Set di dati dal menu di navigazione a sinistra

  4. Seleziona Crea set di dati

    Crea schema

  5. Seleziona l'opzione Crea set di dati dallo schema

    Crea set di dati dallo schema

  6. Seleziona lo schema Luma Web Event Data creato nella lezione precedente, quindi seleziona Successivo

    Set di dati, seleziona schema

  7. Fornisci un Nome e una Descrizione facoltativi per il set di dati. Per questo esercizio, utilizza Luma Web Event Data, quindi seleziona Fine

    Nome set di dati

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.

  1. Apri l'interfaccia Raccolta dati

  2. Seleziona Datastreams dal menu di navigazione a sinistra

  3. Apri lo stream di dati creato nella lezione Configurare uno stream di dati, Luma Web SDK

    Seleziona lo stream di dati di Luma Web SDK

  4. Seleziona Aggiungi servizio
    Aggiungi un servizio allo stream di dati

  5. Seleziona Adobe Experience Platform come Servizio

  6. Seleziona Luma Web Event Data come Set di dati evento

  7. Seleziona Salva.

    Configurazione flusso di dati

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:

  1. Apri il sito di dimostrazione Luma e seleziona l'icona dell'estensione Experience Platform Debugger

  2. Configura il debugger per mappare la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione Convalida con debugger

    Il tuo ambiente di sviluppo di Launch mostrato in Debugger

  3. Accedi al sito Luma utilizzando le credenziali test@adobe.com/test

  4. Torna alla home page di Luma

  5. 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

    SDK Web nel debugger

  6. Cerca "identityMap" all’interno del pop-up. Qui dovresti trovare lumaCrmId con tre chiavi di authenticatedState, id e primary
    SDK Web nel debugger

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.

  1. 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.

  2. Seleziona il set di dati Luma Web Event Data per aprirne la schermata Attività set di dati.

    Evento Web Luma 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.

  3. 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.

    Anteprima set di dati

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

    Anteprima set di dati 1

Eseguire una query sui dati

  1. Nell'interfaccia Experience Platform, seleziona Gestione dati > Query nel menu di navigazione a sinistra per aprire la schermata Query.
  2. Seleziona Crea query
  3. 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.
  4. Nei risultati, il nome della tabella sarà simile a luma_web_event_data
  5. 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"
  6. 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:

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:

  1. Apri il set di dati creato, Luma Web Event Data

  2. Seleziona Attiva/Disattiva profilo per attivarlo

    Cambia profilo

  3. Conferma di voler abilitare il set di dati

    Attiva/Disattiva profilo

Per abilitare lo schema:

  1. Apri lo schema creato, Luma Web Event Data

  2. Seleziona Attiva/Disattiva profilo per attivarlo

    Cambia profilo

  3. 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.
  4. Seleziona Abilita

    Attiva/Disattiva profilo

  5. 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.

  1. Nell'interfaccia Experience Platform, seleziona Cliente > Profili nell'area di navigazione a sinistra

  2. Poiché lo spazio dei nomi Identity utilizza lumaCRMId

  3. Copia e incolla il valore di lumaCRMId passato nella chiamata esaminata nel debugger Experience Platform, in questo caso 112ca06ed53d3db37e4cea49cc45b71e.

    Profilo

  4. Se nel profilo di lumaCRMId è presente un valore valido, nella console viene popolato un ID profilo:

    Profilo

  5. 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
    Profilo cliente

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

  1. Crea un nuovo schema

  2. Scegli Profilo individuale come classe base

  3. Denomina lo schema Luma Loyalty Schema

  4. Aggiungi il gruppo di campi Dettagli fedeltà

  5. Aggiungi il gruppo di campi Dettagli demografici

  6. Selezionare il campo Person ID e contrassegnarlo come Identità e Identità primaria utilizzando lo spazio dei nomi Luma CRM Id Identità.

  7. 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.

  8. Salvare lo schema

    Schema fedeltà

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

  1. Crea un nuovo set di dati da Luma Loyalty Schema

  2. Denomina il set di dati Luma Loyalty Dataset

  3. Abilita il set di dati per Profilo

  4. Scarica il file di esempio luma-loyalty-forWeb.json

  5. Trascinare il file nel set di dati

  6. Conferma che i dati siano stati acquisiti correttamente

    Schema fedeltà

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:

  1. Nell'interfaccia di Experience Platform o Journey Optimizer, vai a Cliente > Tipi di pubblico nel menu di navigazione a sinistra

  2. Seleziona Crea pubblico

  3. Seleziona Genera regola

  4. Seleziona Crea

    Creazione di un pubblico

  5. Seleziona Attributi

  6. Trova il campo Fedeltà > Livello e trascinalo nella sezione Attributi

  7. Definisci il pubblico come utenti il cui tier è gold

  8. Denomina il pubblico Luma Loyalty Rewards – Gold Status

  9. Seleziona Edge come metodo di valutazione

  10. Seleziona Salva

    Definire il pubblico

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.

Successivo:

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