DocumentazioneExperience PlatformAcquisire dati in streaming

Acquisire dati in streaming

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

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

In questa lezione, i dati verranno trasmessi in streaming utilizzando Adobe Experience Platform Web SDK.

Nell’interfaccia di Data Collection è necessario completare due attività principali:

  • Dobbiamo implementare Web SDK sul sito web Luma per inviare i dati sull’attività del visitatore dal sito web alla rete Adobe Edge. Verrà eseguita una semplice implementazione utilizzando i tag (precedentemente Launch)

  • Dobbiamo configurare un flusso di dati che indichi alla rete Edge dove inoltrare i dati. Verrà configurato per inviare i dati al set di dati Luma Web Events nella sandbox di Platform.

I Data Engineer dovranno acquisire i dati in streaming all'esterno di questa esercitazione. Quando si implementano gli SDK per web o dispositivi mobili di Adobe Experience Platform, in genere uno sviluppatore web o mobile è coinvolto nella creazione del livello dati e nella configurazione delle proprietà dei tag.

Prima di iniziare gli esercizi, guarda questi due brevi video per ulteriori informazioni sull’acquisizione di dati in streaming e Web SDK:

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

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

NOTE
Questo tutorial è incentrato sull'acquisizione in streaming da siti web con Web SDK, ma puoi anche eseguire lo streaming dei dati utilizzando Adobe Mobile SDK, Apache Kafka Connect e altri meccanismi.

Autorizzazioni richieste

Nella lezione Configurare le autorizzazioni è possibile impostare tutti i controlli di accesso necessari per completare la lezione.

Configurare lo stream di dati

Innanzitutto configureremo lo stream di dati. Un flusso di dati indica alla rete Adobe Edge dove inviare i dati dopo averli ricevuti dalla chiamata SDK web. Inviare i dati ad Experience Platform, Adobe Analytics o Adobe Target? Gli stream di dati vengono gestiti nell’interfaccia utente di Data Collection (precedentemente Launch) e sono fondamentali per la raccolta dei dati con Web SDK.

Per creare il flusso di dati:

  1. Accedi all'interfaccia utente di Experience Platform Data Collection

  2. Seleziona Datastreams nel menu di navigazione a sinistra

  3. Seleziona il pulsante Nuovo flusso di dati nell'angolo superiore destro

    Seleziona gli stream di dati nella navigazione a sinistra

  4. Per Nome descrittivo, immetti Luma Platform Tutorial (aggiungi il tuo nome alla fine, se più persone della tua azienda stanno seguendo questa esercitazione)

  5. Seleziona il pulsante Salva

    Denomina il datastram e salva

Nella schermata successiva, specifica dove desideri inviare i dati. Per inviare dati ad Experience Platform:

  1. Attiva Adobe Experience Platform per esporre campi aggiuntivi
  2. Per Sandbox, seleziona Luma Tutorial
  3. Per Set di dati evento, selezionare Luma Web Events Dataset
  4. Se utilizzi altre applicazioni Adobe, puoi esplorare le altre sezioni per vedere quali informazioni sono necessarie nella configurazione Edge di queste altre soluzioni. L’SDK per web è stato sviluppato non solo per inviare dati in streaming a Experience Platform, ma anche per sostituire tutte le librerie JavaScript precedenti utilizzate da altre applicazioni Adobe. La configurazione di Edge viene utilizzata per specificare i dettagli dell’account di ogni applicazione a cui si desidera inviare i dati.
  5. Seleziona Salva
    Configura lo stream di dati e salva

Una volta salvata la configurazione di Edge, nella schermata risultante vengono visualizzati tre ambienti creati per lo sviluppo, la gestione temporanea e la produzione. È possibile aggiungere altri ambienti di sviluppo:
Ogni configurazione di Edge può avere più ambienti
Tutti e tre gli ambienti contengono i dettagli della piattaforma appena immessi. Tuttavia, questi dettagli possono essere configurati in modo diverso in base all’ambiente. Ad esempio, ogni ambiente potrebbe inviare dati a una sandbox di Platform diversa. In questa esercitazione, non verranno effettuate ulteriori personalizzazioni del flusso di dati.

Installare l’estensione Web SDK

Aggiungi una proprietà

Innanzitutto, è necessario creare una proprietà tag (in precedenza una proprietà tag ). Una proprietà è un contenitore per tutte le JavaScript, le regole e le altre funzioni necessarie per raccogliere i dettagli da una pagina web e inviarli a varie posizioni.

Per creare una proprietà:

  1. Vai a Proprietà nel menu di navigazione a sinistra
  2. Seleziona il pulsante Nuova proprietà
    Aggiungi una nuova proprietà
  3. Come Nome, immetti Luma Platform Tutorial (aggiungi il tuo nome alla fine, se più persone della tua azienda stanno seguendo questa esercitazione)
  4. Come Domini, immetti enablementadobe.com (spiegato più tardi)
  5. Seleziona Salva
    Dettagli proprietà

Aggiungere l’estensione Web SDK

Ora che disponi di una proprietà puoi aggiungere l’SDK web utilizzando un’estensione. Un’estensione è un pacchetto di codice che estende l’interfaccia e la funzionalità di Data Collection. Per aggiungere l'estensione:

  1. Apri la proprietà tag
  2. Vai a Estensioni nel menu di navigazione a sinistra
  3. Passa alla scheda Catalogo
  4. Sono disponibili molte estensioni per i tag. Filtra il catalogo con il termine Web SDK
  5. Nell'estensione Adobe Experience Platform Web SDK, selezionare il pulsante Installa
    Installare lestensione Adobe Experience Platform Web SDK
  6. Sono disponibili diverse configurazioni per l’estensione Web SDK, ma ne verranno configurate solo due per questa esercitazione. Aggiorna il dominio Edge in data.enablementadobe.com. Questa impostazione ti consente di impostare i cookie di prime parti con l’implementazione dell’SDK web, il che è consigliato. Più avanti in questa lezione verrà mappato un sito Web del dominio enablementadobe.com alla proprietà tag. Il CNAME per il dominio enablementadobe.com è già stato configurato in modo che data.enablementadobe.com venga inoltrato ai server Adobe. Quando implementi Web SDK sul tuo sito Web, dovrai creare un CNAME per le tue finalità di raccolta dati, ad esempio data.YOUR_DOMAIN.com
  7. Dal menu a discesa Datastream, seleziona il tuo Luma Platform Tutorial datastream.
  8. Puoi esaminare le altre opzioni di configurazione (ma non modificarle!) e quindi seleziona Salva

Creare una regola per inviare dati

Ora creeremo una regola per inviare dati a Platform. Una regola è una combinazione di eventi, condizioni e azioni che indicano ai tag di eseguire un’operazione. Per creare una regola:

  1. Vai a Regole nel menu di navigazione a sinistra
  2. Seleziona il pulsante Crea nuova regola
    Crea una regola
  3. Denomina la regola All Pages - Library Loaded
  4. In Eventi, seleziona il pulsante Aggiungi
    Denomina la regola e aggiungi un evento
  5. Utilizza l'Core Estensione e seleziona Library Loaded (Page Top) come Event Type. Questa impostazione significa che la regola viene attivata ogni volta che la libreria Launch viene caricata su una pagina.
  6. Seleziona Mantieni modifiche per tornare alla schermata della regola principale
    Aggiungi evento Library Loaded
  7. Lascia vuote Condizioni, poiché vogliamo che questa regola venga attivata su tutte le pagine in base al nome che le abbiamo assegnato
  8. In Azioni, seleziona il pulsante Aggiungi
  9. Utilizza Adobe Experience Platform Web SDK Estensione e seleziona Invia evento come Tipo azione
  10. A destra, seleziona web.webpagedetails.pageViews dal menu a discesa Tipo. Questo è uno dei campi XDM in Luma Web Events Schema
  11. Seleziona Mantieni modifiche per tornare alla schermata della regola principale
    Aggiungi azione Invia evento
  12. Seleziona Salva per salvare la regola
    Salva la regola

Publish la regola in una libreria

Ora pubblicheremo la regola nel nostro ambiente di sviluppo in modo da poter verificare che funzioni.

Per creare una libreria:

  1. Vai a Flusso di pubblicazione nel menu di navigazione a sinistra
  2. Seleziona Aggiungi libreria
    Seleziona Aggiungi libreria
  3. Per Name, immetti Luma Platform Tutorial
  4. Per l'ambiente, selezionare Development
  5. Selezionare il pulsante Aggiungi tutte le risorse modificate. Oltre all'estensione Adobe Experience Platform Web SDK e alla regola All Pages - Library Loaded, verrà aggiunta l'estensione Core che contiene il JavaScript di base richiesto da tutte le proprietà Web di Launch.
  6. Seleziona il pulsante Salva e genera per sviluppo
    Crea e genera la libreria

La creazione della libreria potrebbe richiedere alcuni minuti e al termine viene visualizzato un punto verde a sinistra del nome della libreria:
Build completata

Come puoi vedere nella schermata Flusso di pubblicazione, il processo di pubblicazione richiede molto di più, il che va oltre l'ambito di questa esercitazione. Utilizzeremo un’unica libreria nel nostro ambiente di sviluppo.

Convalidare i dati nella richiesta

Aggiungi l’Adobe Experience Platform Debugger

Experience Platform Debugger è un’estensione disponibile per i browser Chrome e Firefox che consente di visualizzare la tecnologia Adobe implementata nelle pagine web. Scarica la versione per il browser preferito:

Se non hai mai utilizzato il debugger prima, e questo è diverso dal precedente Adobe Experience Cloud Debugger, potresti voler guardare questo video di panoramica di cinque minuti:

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

Apri il sito web Luma.

Per questo tutorial, utilizziamo una versione del sito web demo Luma in hosting pubblico. Apriamolo e aggiungiamo un segnalibro:

  1. In una nuova scheda del browser, apri il sito Web Luma.
  2. Aggiungi ai segnalibri la pagina da utilizzare nel resto dell’esercitazione

Per questo sito in hosting abbiamo utilizzato enablementadobe.com nel campo Domains della configurazione iniziale della proprietà tag e data.enablementadobe.com come dominio di prime parti nell'estensione Adobe Experience Platform Web SDK. Vedi, avevo un piano!

Home page Luma

Utilizza Experience Platform Debugger per eseguire il mapping alla proprietà tag

Experience Platform Debugger dispone di una funzione interessante che consente di sostituire una proprietà tag esistente con una diversa. Questo è utile per la convalida e ci consente di saltare molti passaggi di implementazione in questa esercitazione.

  1. Assicurati di avere aperto il sito Luma e seleziona l’icona dell’estensione Experience Platform Debugger

  2. Debugger si aprirà e mostrerà alcuni dettagli dell’implementazione hardcoded, che non è correlata a questa esercitazione (potrebbe essere necessario ricaricare il sito Luma dopo aver aperto Debugger)

  3. Verifica che il debugger sia "connesso a Luma" come illustrato di seguito, quindi seleziona l'icona "blocca" per bloccare il debugger sul sito Luma.

  4. Seleziona il pulsante Accedi in alto a destra per eseguire l'autenticazione.

  5. Vai ora a Launch nel menu di navigazione a sinistra

  6. Seleziona la scheda Configurazione.

  7. A destra della visualizzazione dei Codici di incorporamento pagina, apri il menu a discesa Azioni e seleziona Sostituisci
    Seleziona Azioni > Sostituisci

  8. Poiché sei autenticato, il Debugger estrae le proprietà e gli ambienti di Launch disponibili. Seleziona la proprietà Luma Platform Tutorial

  9. Seleziona l'ambiente Development

  10. Seleziona il pulsante Applica
    Selezionare la proprietà tag alternativa

  11. Il sito Web Luma ricaricherà con la tua proprietà tag. Aiuto, sono stato attaccato! Sto scherzando.
    proprietà tag sostituita

  12. Vai a Riepilogo nella barra di navigazione a sinistra per visualizzare i dettagli della proprietà Launch
    Scheda Riepilogo

  13. Vai ora a AEP Web SDK nell'area di navigazione a sinistra per visualizzare le richieste di rete

  14. Apri la riga events

    Richiesta Adobe Experience Platform Web SDK

  15. Nota come è possibile visualizzare il tipo di evento web.webpagedetails.pageView specificato nell'azione Invia evento e altre variabili predefinite conformi al formato AEP Web SDK ExperienceEvent Mixin
    Dettagli evento

  16. Questi tipi di dettagli della richiesta sono visibili anche nella scheda Network degli strumenti per sviluppatori Web del browser. Apri e ricarica la pagina. Filtra le chiamate con interact per individuare la chiamata, selezionala e cerca nella scheda Intestazioni, Payload richiesta.
    Scheda Rete

  17. Vai alla scheda Risposta e osserva come il valore ECID è incluso nella risposta. Copia questo valore così come lo utilizzerai per convalidare le informazioni sul profilo nell’esercizio successivo.
    Scheda Rete

Convalidare i dati in Experience Platform

È possibile verificare che i dati siano in arrivo in Platform osservando i batch di dati in arrivo in Luma Web Events Dataset. (Lo so, si chiama acquisizione di dati in streaming, ma ora sto dicendo che arriva in batch! Viene inviato in streaming al profilo in tempo reale, quindi può essere utilizzato per la segmentazione e l’attivazione in tempo reale, ma viene inviato in batch ogni 15 minuti al data lake.)

Per convalidare i dati:

  1. Nell'interfaccia utente di Platform, vai a Set di dati nell'area di navigazione a sinistra
  2. Aprire Luma Web Events Dataset e verificare che sia arrivato un batch. Ricordati che vengono inviati ogni 15 minuti, quindi potrebbe essere necessario attendere la visualizzazione del batch.
  3. Seleziona il pulsante Anteprima set di dati
    Apri il set di dati
  4. Nella finestra modale di anteprima, tieni presente come selezionare diversi campi dello schema a sinistra per visualizzare in anteprima tali punti dati specifici:
    Visualizza lanteprima dei campi

Puoi anche verificare che il nuovo profilo sia visualizzato:

  1. Nell'interfaccia utente di Platform, vai a Profili nell'area di navigazione a sinistra
  2. Seleziona lo spazio dei nomi ECID e cerca il valore ECID (copialo dalla risposta). Il profilo avrà un proprio ID, separato dall’ECID.
  3. Seleziona ID profilo per aprire il profilo
    Trova e apri il profilo
  4. Seleziona la scheda Eventi per visualizzare le pagine visualizzate
    Eventi profilo \

Aggiungere dati personalizzati all’evento

Creare un elemento dati per nome pagina

  1. Nell'interfaccia dei tag di raccolta dati, nell'angolo in alto a destra della proprietà Luma Platform Tutorial, apri il menu a discesa Seleziona una libreria di lavoro e seleziona la libreria Luma Platform Tutorial. Questa impostazione semplifica la pubblicazione di aggiornamenti aggiuntivi alla libreria.

  2. Vai ora a Elementi dati nel menu di navigazione a sinistra

  3. Seleziona il pulsante Crea nuovo elemento dati

    Crea un nuovo elemento dati

  4. Come Nome, immetti Page Name

  5. Come Tipo di elemento dati, selezionare JavaScript Variable

  6. Come nome variabile JavaScript, immetti digitalData.page.pageInfo.pageName

  7. Per semplificare la standardizzazione del formato dei valori, selezionare le caselle per Forza valori minuscoli e Pulisci testo

  8. Assicurarsi che Luma Platform Tutorial sia selezionato come libreria di lavoro

  9. Seleziona Salva nella libreria
    Crea un elemento dati per il nome pagina

Mappare il nome della pagina all’elemento dati Oggetto XDM

Ora mapperemo il nome della nostra pagina all’SDK per web.

IMPORTANT
Per completare questa attività, è necessario assicurarsi che l’utente abbia prima accesso alla sandbox di Prod. Se non hai già accesso alla sandbox Prod da un profilo di prodotto diverso, apri rapidamente il profilo Luma Tutorial Platform e aggiungi l'elemento di autorizzazione Sandbox > Prod. Dopo aver eseguito questa operazione, effettua un MAIUSC-Ricarica nella pagina Elementi dati per cancellare la cache
Aggiungi la sandbox Prod

Nella pagina Elementi dati:

  1. Creare un nuovo elemento dati
  2. Come Nome, immetti XDM Object
  3. Come Estensione, seleziona Adobe Experience Platform Web SDK
  4. Come Tipo di elemento dati, selezionare XDM object
  5. Seleziona la sandbox Luma Tutorial come Sandbox
  6. Come Schema, seleziona Luma Web Events Schema
  7. Seleziona il campo web.webPageDetails.name
  8. Come Valore, seleziona l'icona per aprire la selezione modale dell'elemento dati e scegli l'elemento dati Page Name
  9. Seleziona Salva nella libreria
    Mappa il nome della pagina allelemento dati delloggetto XDM

Lo stesso processo viene utilizzato per mappare dati personalizzati aggiuntivi sul sito web ai campi XDM.

Aggiungere i dati XDM all’azione Invia evento

Ora che hai mappato i dati sui campi XDM, puoi includerli nell’azione Invia evento:

  1. Vai alla schermata Regole
  2. Apri la regola All Pages - Library Loaded
  3. Apri l'azione Adobe Experience Platform Web SDK - Send Event
  4. Come dati XDM, seleziona l'icona per aprire la selezione modale dell'elemento dati e scegli l'elemento dati XDM Object
  5. Seleziona il pulsante Mantieni modifiche
    Aggiungi i dati XDM allazione Invia evento
  6. Ora, poiché hai selezionato Luma Platform Tutorial come libreria di lavoro per gli ultimi esercizi, le modifiche recenti sono state salvate direttamente nella libreria. Invece di pubblicare le modifiche tramite la schermata Flusso di pubblicazione, puoi aprire il menu a discesa sul pulsante blu e selezionare Salva nella libreria e genera
    Salva nella libreria e genera

Inizia a creare una nuova libreria di tag con le tre modifiche appena apportate.

Convalidare i dati XDM

Ora dovresti essere in grado di ricaricare la pagina home di Luma, mentre sei mappato sulla proprietà tag utilizzando il Debugger come hai imparato in precedenza, e vedere che il campo del nome pagina si popola nella richiesta.
Convalida dati XDM

Puoi anche verificare che i dati del nome della pagina siano stati ricevuti in Platform, visualizzando in anteprima il set di dati e il profilo.

Invia identità aggiuntive

L’implementazione dell’SDK per web sta ora inviando eventi con l’ID Experience Cloud (ECID) come identificatore primario. L’ECID viene generato automaticamente dall’SDK per web ed è univoco per dispositivo e browser. Un singolo cliente può avere più ECID a seconda del dispositivo e del browser in uso. Come possiamo ottenere una visione unificata di questo cliente e collegare la sua attività online ai nostri dati di gestione delle relazioni con i clienti, fedeltà e acquisto offline? Lo facciamo raccogliendo identità aggiuntive durante la loro sessione e collegando in modo deterministico il loro profilo tramite l’unione di identità.

Se ricordi, ho detto che avremmo utilizzato l'ECID e l'ID del sistema di gestione delle relazioni con i clienti come identità per i nostri dati web nella lezione Mappa identità. Quindi raccogliamo l’ID del sistema di gestione delle relazioni con i clienti con l’SDK per web!

Aggiungi elemento dati per l’ID CRM

Innanzitutto, memorizziamo l’ID del sistema di gestione delle relazioni con i clienti in un elemento dati:

  1. Nell'interfaccia dei tag, aggiungere un elemento dati denominato CRM Id
  2. Come Tipo di elemento dati, seleziona Variabile JavaScript
  3. Come nome variabile JavaScript, immetti digitalData.user.0.profile.0.attributes.username
  4. Seleziona il pulsante Salva nella libreria (Luma Platform Tutorial deve essere ancora la libreria di lavoro)
    Aggiungi elemento dati per ID CRM

Aggiungere l’ID del sistema di gestione delle relazioni con i clienti all’elemento dati della Mappa identità

Dopo aver acquisito il valore ID CRM, è necessario associarlo a un tipo di elemento dati speciale denominato elemento dati Identity Map:

  1. Aggiungi un elemento dati denominato Identities

  2. Come Estensione, seleziona Adobe Experience Platform Web SDK

  3. Come Tipo elemento dati, selezionare Mappa identità

  4. Come Spazio dei nomi, immetti Luma CRM Id, che è lo spazio dei nomi creato in una lezione precedente

    note warning
    WARNING
    La versione 2.2 dell’estensione Adobe Experience Platform Web SDK consente di selezionare Spazio dei nomi da un elenco a discesa precompilato utilizzando i valori effettivi nell’account Platform. Sfortunatamente, questa funzione non è ancora in grado di riconoscere la sandbox e pertanto il valore Luma CRM Id potrebbe non essere visualizzato nel menu a discesa. Questo potrebbe impedirti di completare questo esercizio. Una volta confermata, verrà pubblicata una soluzione alternativa.

  5. Come ID, seleziona l'icona per aprire la selezione modale dell'elemento dati e scegli l'elemento dati CRM Id

  6. Come Stato autenticato, selezionare Stato autenticato

  7. Lascia Primario deselezionato. Poiché l'ID del sistema di gestione delle relazioni con i clienti non è presente per la maggior parte dei visitatori del sito Web Luma, non desideri ignorare l'ECID come identificatore primario. Sarebbe un caso d’uso raro utilizzare qualcosa di diverso dall’ECID come identificatore primario. Di solito non menziono le impostazioni predefinite in queste istruzioni, ma sto chiamando questo per aiutarti a evitare problemi più avanti nella tua implementazione.

  8. Seleziona il pulsante Salva nella libreria (Luma Platform Tutorial deve essere ancora la libreria di lavoro)
    Aggiungere lID CRM allelemento dati Identity Map

NOTE
È possibile trasmettere più identificatori utilizzando il tipo di dati Identity map.

Aggiungere l’elemento dati Identity Map all’oggetto XDM

È necessario aggiornare un altro elemento dati: l’elemento dati Oggetto XDM. Può sembrare strano dover aggiornare tre elementi di dati separati per passare questa identità, ma questo processo è progettato per scalare per più identità. Non preoccuparti, questa lezione è quasi finita!

  1. Aprire l’elemento dati Oggetto XDM
  2. Apri il campo XDM di IdentityMap
  3. Come Elemento dati, seleziona l'icona per aprire la selezione modale dell'elemento dati e scegli l'elemento dati Identities
  4. Ora, poiché hai selezionato Luma Platform Tutorial come libreria di lavoro per gli ultimi esercizi, le modifiche recenti sono state salvate direttamente nella libreria. Invece di pubblicare le modifiche tramite la schermata Flusso di pubblicazione, puoi aprire il menu a discesa sul pulsante blu e selezionare Salva nella libreria e genera
    Aggiungere lelemento dati IdentityMap alloggetto XDM

Convalidare l’identità

Per verificare che l’ID del sistema di gestione delle relazioni con i clienti sia ora inviato dall’SDK Web:

  1. Apri il sito Web Luma
  2. Mappare il file alla proprietà tag utilizzando Debugger, come indicato nelle istruzioni precedenti
  3. Seleziona il collegamento Accesso in alto a destra nel sito Web Luma
  4. Accedi utilizzando le credenziali test@adobe.com/test
  5. Una volta autenticata, esamina la chiamata Experience Platform Web SDK nel debugger (Adobe Experience Platform Web SDK > Richieste di rete > eventi della richiesta più recente) e dovresti visualizzare lumaCrmId:
    Convalidare lidentità nel debugger
  6. Cerca di nuovo il profilo utente utilizzando lo spazio dei nomi e il valore ECID. Nel profilo troverai l’ID del sistema di gestione delle relazioni con i clienti, l’ID fedeltà e i dettagli del profilo, come il nome e il numero di telefono. Tutte le identità e i dati sono stati uniti in un unico profilo cliente in tempo reale.
    Convalida identità in Platform

Risorse aggiuntive

Ottimo lavoro! Queste erano molte informazioni su Web SDK e Launch. L’implementazione completa richiede molto più lavoro, ma queste sono le nozioni di base per aiutarti a iniziare e visualizzare i risultati in Platform.

NOTE
Ora che hai terminato la lezione Streaming Ingestion, puoi rimuovere la sandbox Prod dal tuo profilo di prodotto Luma Tutorial Platform

Ingegneri dati, se lo desideri puoi passare alla lezione eseguire query.

Architetti di dati, puoi passare a criteri di unione.

recommendation-more-help
513160b6-bf42-4c58-abdd-4f817b1cccad