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.

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

SDK per web e diagramma di Adobe Experience Platform

Experienci 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. A 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 a Experience Platform o Journey Optimizer Interfaccia

  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 la Crea set di dati dallo schema opzione

    Crea set di dati dallo schema

  6. Seleziona la Luma Web Event Data schema creato in lezione precedente e quindi seleziona Successivo

    Set di dati, seleziona lo schema

  7. Fornisci un Nome e opzionale Descrizione 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 Raccolta dati Interfaccia

  2. Seleziona Flussi di dati dal menu di navigazione a sinistra

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

    Seleziona lo stream di dati dell’SDK web Luma

  4. Seleziona Aggiungi servizio
    Aggiungere 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 si genera traffico sul Sito dimostrativo Luma mappati alla proprietà tag, i dati popolano il set di dati in Experienci 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 Debugger Experienci Platform
  • Convalida tramite Anteprima set di dati
  • Convalida tramite Servizio query

Experience Platform Debugger

Questi passaggi sono più o meno gli stessi di quelli eseguiti nel Lezione su 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 Sito di dimostrazione Luma e seleziona la Debugger Experienci Platform icona dell’estensione

  2. Configura Debugger per mappare la proprietà tag su tuo Ambiente di sviluppo, come descritto nella sezione Convalida con Debugger lezione

    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 per web nel debugger

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

Ora, i dati devono essere compilati in Luma Web Event Data e pronto per la convalida "Anteprima set di dati".

Visualizzare l’anteprima del set di dati

Per confermare che i dati sono arrivati nel data lake di Platform, un’opzione rapida consiste nell’utilizzare Anteprima set di dati funzionalità. 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. In Experience Platform interfaccia, seleziona Gestione dati > Set di dati nel menu di navigazione a sinistra per aprire Set di dati dashboard.

    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 Luma Web Event Data set di dati per aprirne i Attività set di dati schermo.

    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 sezione Attività set di dati schermata, seleziona Anteprima set di dati nell’angolo in alto a destra 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. In Experience Platform interfaccia, seleziona Gestione dati > Query nel menu di navigazione a sinistra per aprire Query schermo.
  2. Seleziona Crea query
  3. Eseguire innanzitutto una query per visualizzare tutti i nomi delle tabelle nel data lake. Invio SHOW TABLES nell’editor delle query e fai clic sull’icona play per eseguire la query.
  4. Nei risultati, noterai che il nome della tabella è simile a luma_web_event_data
  5. Eseguire una query sulla tabella con una semplice query che fa riferimento alla tabella (si noti che 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, consulta 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 la Attiva/disattiva profilo per accenderlo

    Attiva/disattiva profilo

  3. Conferma che desideri Abilita il set di dati

    Attiva/disattiva profilo

Per abilitare lo schema:

  1. Apri lo schema creato, Luma Web Event Data

  2. Seleziona la Attiva/disattiva profilo per accenderlo

    Attiva/disattiva profilo

  3. Seleziona 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 l’SDK web per Platform per assicurarsi che invii dati con lumaCRMId.

  1. In Experience Platform interfaccia, seleziona Cliente > Profili nel menu di navigazione a sinistra

  2. Come Spazio dei nomi dell’identità utilizzare lumaCRMId

  3. Copia e incolla il valore del lumaCRMId ha passato la chiamata esaminata nel debugger di Experienci Platform, in questo caso 112ca06ed53d3db37e4cea49cc45b71e.

    Profilo

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

    Profilo

  5. Per visualizzare l'intero Profilo cliente per ogni ID, seleziona la 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 vedere tutte le identità collegate al 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 Experienci 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 Dettagli fedeltà gruppo di campi

  5. Aggiungi il Dettagli demografici gruppo di campi

  6. Seleziona la Person ID e contrassegnarlo come Identità e Identità primaria utilizzando Luma CRM Id Spazio dei nomi dell’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. Creare 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 Creare un pubblico

  3. Seleziona Genera regola

  4. Seleziona Crea

    Creazione di un pubblico

  5. Seleziona Attributi

  6. Trova il Fedeltà > Livello e trascinarlo sulla Attributi sezione

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

  8. Assegna un nome al pubblico Luma Loyalty Rewards – Gold Status

  9. Seleziona Bordo 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 Edge valutano il Edge di, quindi, nella stessa richiesta effettuata dall’SDK 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 su questo Experience League post di discussione community
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4