DocumentazioneExperience PlatformTutorial su Web SDK

Configurare Adobe Analytics con Adobe Experience Platform Web SDK

Last update: Fri Apr 26 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Beginner
  • Intermediate
  • Developer

Scopri come configurare Adobe Analytics utilizzando Adobe Experience Platform Web SDK, crea regole di tag per inviare dati ad Adobe Analytics e verifica che Analytics stia acquisendo i dati come previsto.

Adobe Analytics è un'applicazione leader di settore che ti consente di comprendere i tuoi clienti come persone e gestire la tua attività grazie alle informazioni sul cliente.

Diagramma da SDK per web ad Adobe Analytics

Obiettivi di apprendimento

Alla fine di questa lezione, potrai:

  • Configurare uno stream di dati per abilitare Adobe Analytics
  • Scopri quali campi XDM standard vengono mappati automaticamente sulle variabili di Analytics
  • Impostare variabili Analytics personalizzate utilizzando il gruppo di campi Modello Adobe Analytics ExperienceEvent o le regole di elaborazione
  • Inviare dati a un’altra suite di rapporti ignorando lo stream di dati
  • Convalidare le variabili di Adobe Analytics utilizzando Debugger e Assurance

Prerequisiti

Per completare questa lezione, devi prima:

  • Acquisisci familiarità con Adobe Analytics e accedi ad esso.

  • Avere almeno un ID suite per report test/dev. Se non hai una suite per report test/dev che puoi usare per questa esercitazione, creane uno.

  • Completa le lezioni precedenti nelle sezioni Configurazione iniziale e Configurazione tag di questa esercitazione.

Configurare lo stream di dati

Platform Web SDK invia i dati dal sito web all’Edge Network di Platform. Lo stream di dati comunica quindi all’Edge Network di Platform le suite di rapporti di Adobe Analytics a cui devono essere inviati i dati.

  1. Vai a Raccolta dati Interfaccia

  2. Nel menu di navigazione a sinistra, seleziona Flussi di dati

  3. Seleziona il creato in precedenza Luma Web SDK: Development Environment flusso di dati

    Seleziona lo stream di dati dell’SDK web Luma

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

  5. Seleziona Adobe Analytics come Servizio

  6. Inserisci il ID suite di rapporti della suite di rapporti per lo sviluppo

  7. Seleziona Salva

    Analisi del salvataggio dello stream di dati

    note tip
    TIP
    Aggiunta di più suite di rapporti selezionando Aggiungi suite di rapporti equivale all’assegnazione tag per più suite.
WARNING
In questa esercitazione, puoi configurare solo la suite di rapporti di Adobe Analytics per il tuo ambiente di sviluppo. Quando crei flussi di dati per il tuo sito web, devi creare flussi di dati e suite di rapporti aggiuntivi per gli ambienti di staging e produzione.

Schemi XDM e variabili Analytics

Congratulazioni! Hai già configurato uno schema compatibile con Adobe Analytics in Configurare uno schema lezione!

Ma vi starete chiedendo, come posso impostare tutte le mie proprietà, eVar ed eventi?

Esistono diversi approcci che possono essere utilizzati simultaneamente:

  1. Imposta i campi XDM standard; alcuni verranno mappati automaticamente sulle variabili di Analytics.
  2. Mappa ulteriori campi XDM sulle variabili Analytics nelle regole di elaborazione Analytics.
  3. Mappa sulle variabili di Analytics direttamente nello schema XDM.

Campi mappati automaticamente

Molti campi XDM vengono mappati automaticamente alle variabili di Analytics.

Lo schema creato in Configurare uno schema La lezione contiene alcune variabili mappate automaticamente su Analytics, come descritto in questa tabella:

Variabili mappate automaticamente da XDM ad Analytics
Variabile Adobe Analytics
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
acquisto
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=;product name;;;; (primario - vedi nota sotto)
productListItems[].name
s.products=;product name;;;; (fallback - vedi la nota seguente)
productListItems[].quantity
s.products=;;quantità prodotto;;;
productListItems[].priceTotal
s.product=;;;;prezzo del prodotto;;

Le singole sezioni della stringa di prodotto Analytics sono impostate tramite diverse variabili XDM sotto productListItems oggetto.

Dal 18 agosto 2022, productListItems[].SKU ha priorità nella mappatura al nome del prodotto nella variabile s.products.
Il valore impostato su productListItems[].name è mappato al nome del prodotto solo se productListItems[].SKU non esiste. In caso contrario, non è mappato ed è disponibile nei dati contestuali.
Non impostare una stringa vuota o null su productListItems[].SKU. Questo ha l’effetto indesiderato di mappare al nome del prodotto nella variabile s.products.

Per un elenco aggiornato delle mappature, consulta Mappatura delle variabili di Analytics in Adobe Experience Edge.

Mappare alle variabili di Analytics con regole di elaborazione

Tutti i campi nello schema XDM diventano disponibili per Adobe Analytics come variabili di dati contestuali con il seguente prefisso a.x.. Ad esempio, a.x.web.webinteraction.region

In questo esercizio mapperai una variabile XDM su una proprietà. Segui questi stessi passaggi per qualsiasi mappatura personalizzata che devi eseguire per qualsiasi eVar, prop, event, o variabile accessibile tramite Regole di elaborazione.

  1. Passa all’interfaccia di Analytics

  2. Vai a Amministratore > Strumenti di amministrazione > Suite di rapporti

  3. Seleziona la suite di rapporti per sviluppo/test che utilizzi per l’esercitazione > Modifica impostazioni > Generale > Regole di elaborazione

    Acquisto Analytics

  4. Crea una regola per Sovrascrivi valore di Product SKU (prop1) a a.x.productlistitems.0.sku. Ricorda di aggiungere una nota sul motivo per cui stai creando la regola e assegna un nome al titolo della regola. Seleziona Salva

    Acquisto Analytics

    note important
    IMPORTANT
    La prima volta che esegui il mapping a una regola di elaborazione, l’interfaccia utente non mostra le variabili di dati di contesto dall’oggetto XDM. Per risolvere il problema, seleziona un valore qualsiasi, Salva e torna per modificarlo. Verranno visualizzate tutte le variabili XDM.

Mappare sulle variabili di Analytics utilizzando il gruppo di campi Adobe Analytics

In alternativa alle regole di elaborazione, è possibile eseguire il mapping alle variabili di Analytics nello schema XDM utilizzando Adobe Analytics ExperienceEvent Template gruppo di campi. Questo approccio ha guadagnato popolarità perché molti utenti lo trovano più semplice rispetto alla configurazione delle regole di elaborazione, tuttavia, aumentando la dimensione del payload XDM potrebbe a sua volta aumentare la dimensione del profilo in altre applicazioni come Real-Time CDP.

Per aggiungere Adobe Analytics ExperienceEvent Template gruppo di campi allo schema:

  1. Apri Raccolta dati Interfaccia
  2. Seleziona Schemi dal menu di navigazione a sinistra
  3. Assicurati di trovarti nella sandbox che utilizzi dall’esercitazione
  4. Apri il Luma Web Event Data schema
  5. In Gruppi di campi sezione, seleziona Aggiungi
  6. Trova il Adobe Analytics ExperienceEvent Template e aggiungerlo allo schema

Ora, imposta un eVar di merchandising nella stringa di prodotto. Con il Adobe Analytics ExperienceEvent Template gruppo di campi, puoi mappare le variabili a eVar o eventi di merchandising all’interno della stringa di prodotto. Questa operazione è nota anche come impostazione Merchandising con sintassi prodotto.

  1. Torna alla proprietà tag

  2. Apri la regola ecommerce - library loaded - set product details variables - 20

  3. Apri Imposta variabile azione

  4. Seleziona per aprire _experience > analytics > customDimensions > eVars > eVar1

  5. Imposta il Valore a %product.productInfo.title%

  6. Seleziona Mantieni modifiche

    Variabile oggetto XDM SKU del prodotto

  7. Seleziona Salva per salvare la regola

Come hai appena visto, fondamentalmente tutte le variabili di Analytics possono essere impostate nel Adobe Analytics ExperienceEvent Template gruppo di campi.

NOTE
Osserva _experience oggetto in productListItems > Item 1. Impostazione di qualsiasi variabile in questo oggetto imposta le eVar o gli eventi di sintassi prodotto.

Inviare dati a una suite di rapporti diversa

Puoi modificare i dati della suite di rapporti di Adobe Analytics a cui vengono inviati i visitatori quando si trovano su determinate pagine. Questo richiede una configurazione sia nello stream di dati che in una regola.

Configurare lo stream di dati per una sostituzione della suite di rapporti

Per configurare l’impostazione di sostituzione della suite di rapporti di Adobe Analytics nello stream di dati:

  1. Apri lo stream di dati

  2. Modifica il Adobe Analytics mediante l'apertura della altro menu e selezione Modifica

    Sovrascrivere lo stream di dati

  3. Seleziona la Opzioni avanzate per aprire Sostituzioni suite di rapporti

  4. Seleziona le suite di rapporti da ignorare. In questo caso, Web SDK Course Dev e Web SDK Course Stg

  5. Seleziona Salva

    Sovrascrivere lo stream di dati

Configurare una regola per una sostituzione della suite di rapporti

Creiamo una regola per inviare una chiamata aggiuntiva di visualizzazione della pagina a una suite di rapporti diversa. Utilizza la funzione di sostituzione dello stream di dati per modificare la suite di rapporti per una pagina utilizzando Invia evento Azione.

  1. Crea una nuova regola, denominala homepage - library loaded - AA report suite override - 51

  2. Seleziona il segno più sotto Evento per aggiungere un nuovo trigger

  3. Sotto Estensione, seleziona Core

  4. Sotto Tipo di evento, seleziona libreria caricata

  5. Seleziona per aprire Opzioni avanzate, digitare 51. In questo modo la regola viene eseguita dopo il all pages - library loaded - send event - 50 che imposta l'XDM della linea di base con Aggiorna variabile tipo di azione.

    Override suite di rapporti di Analytics

  6. Sotto Condizioni, seleziona per Aggiungi

  7. Esci Tipo di logica as Normale

  8. Esci Estensioni as Core

  9. Seleziona Tipo di condizione as Percorso senza stringa di query

  10. A destra, lascia il Regex interruttore disabilitato

  11. Sotto path è uguale a set /content/luma/us/en.html. Per il sito di dimostrazione Luma, assicura che la regola venga attivata solo sulla pagina Home

  12. Seleziona Mantieni modifiche

    Condizione di esclusione suite di rapporti di Analytics

  13. Sotto Azioni seleziona Aggiungi

  14. Come Estensione, seleziona Adobe Experience Platform Web SDK

  15. Come Tipo di azione, seleziona Invia evento

  16. Come Tipo, seleziona web.webpagedetails.pageViews

  17. Come Dati XDM, seleziona la xdm.variable.content elemento dati creato in Creare elementi dati lezione

    Sostituzione dello stream di dati di Analytics

  18. Scorri verso il basso fino a Override delle configurazioni dello stream di dati sezione

  19. Lascia Sviluppo scheda selezionata.

    note tip
    TIP
    Questa scheda determina in quale ambiente di tag si verifica l’esclusione. Per questo estratto, specifichi solo l’ambiente di sviluppo, ma quando lo distribuisci in produzione ricorda di farlo anche nel Produzione ambiente.

  20. Seleziona la Datastream, in questo caso Luma Web SDK: Development Environment

  21. Sotto Suite di rapporti, seleziona il sito di report che desideri utilizzare per la sostituzione. In questo caso, tmd-websdk-course-stg.

  22. Seleziona Mantieni modifiche

  23. E Salva regola

    Sostituzione dello stream di dati di Analytics

Creare l’ambiente di sviluppo

Aggiungi nuovi elementi dati e regole al tuo Luma Web SDK Tutorial libreria di tag e ricreare l’ambiente di sviluppo.

Congratulazioni! Il passaggio successivo consiste nel convalidare l’implementazione di Adobe Analytics tramite Experienci Platform Web SDK.

Convalidare Adobe Analytics con Debugger

Scopri come verificare che Adobe Analytics acquisisca ECID, visualizzazioni di pagina, la stringa di prodotto e gli eventi di e-commerce con la funzione Edge Trace di Experienci Platform Debugger.

In Debugger lezione, hai imparato a verificare la richiesta XDM lato client con Platform Debugger e la console per sviluppatori del browser, in modo simile a come si esegue il debug di un’ AppMeasurement.js Implementazione di Analytics. Hai anche imparato a convalidare le richieste lato server di Edge Network di Platform inviate alle applicazioni Adobe e a visualizzare un payload completamente elaborato utilizzando Assurance.

Per verificare che Analytics acquisisca correttamente i dati tramite Experienci Platform Web SDK, devi effettuare due passaggi ulteriori:

  1. Convalida il modo in cui i dati vengono elaborati dall’oggetto XDM nell’Edge Network di Platform, utilizzando la funzione Edge Trace di Experienci Platform Debugger
  2. Convalidare il modo in cui i dati vengono completamente elaborati da Analytics utilizzando Adobe Experience Platform Assurance

Convalida dell’ID Experience Cloud

  1. Vai a Sito di dimostrazione Luma

  2. Seleziona il pulsante di accesso in alto a destra e utilizza le credenziali u: test@adobe.com p: test per autenticare

  3. Apri Experienci Platform Debugger e modifica la proprietà tag sul sito con la tua proprietà di sviluppo

  4. Per abilitare Edge Trace, passa a Debugger di Experienci Platform e, nel menu di navigazione a sinistra, seleziona Registri, quindi seleziona la Bordo e seleziona Connetti

    Connetti traccia spigolo

  5. Per ora sarà vuoto

    Traccia bordi connessi

  6. Aggiorna la pagina Luma e controlla di nuovo Debugger Experience Platform: dovresti vedere i dati arrivare. La riga che inizia con Mappatura automatica di Analytics è il beacon di Adobe Analytics

  7. Seleziona per aprire entrambi mappedQueryParams e il secondo a discesa per visualizzare le variabili di Analytics

    Traccia Edge beacon di Analytics

    note tip
    TIP
    Il secondo elenco a discesa corrisponde all’ID suite di rapporti di Analytics a cui stai inviando i dati. Deve corrispondere alla tua suite di rapporti, non a quella nella schermata.

  8. Scorri verso il basso per trovare c.a.x.identitymap.ecid.[0].id. È una variabile di dati contestuali che acquisisce ECID

  9. Continua a scorrere verso il basso fino a visualizzare il pannello Analytics mid variabile. Entrambi gli ID corrispondono all’ID Experience Cloud del dispositivo.

  10. Sul sito Luma,

    ECID di Analytics

    note note
    NOTE
    Dopo l'accesso, attendere alcuni istanti per convalidare l'ID autenticato 112ca06ed53d3db37e4cea49cc45b71e per l’utente test@adobe.com viene acquisito anche in c.a.x.identitymap.lumacrmid.[0].id

Convalida dell’override della suite di rapporti

Sopra hai configurato una sostituzione dello stream di dati per Home page Luma. Per convalidare questa configurazione

  1. Cerca una riga con Configurazione dello stream di dati dopo l’applicazione della sostituzione. Qui puoi trovare la suite di rapporti principale e le suite di rapporti aggiuntive configurate per le sostituzioni della suite di rapporti.

    Convalida elenco di sostituzione suite di rapporti di Analytics

  2. Scorri verso il basso fino alla riga che inizia con Mappatura automatica di Analytics e verifica che reportSuiteIds mostra la suite di rapporti specificata nelle configurazioni di sostituzione

    Convalida della chiamata di sostituzione della suite di rapporti di Analytics

Convalida delle visualizzazioni della pagina del contenuto

Vai a una pagina di prodotto come Pagina prodotto Didi Sport Watch. Verifica che le visualizzazioni della pagina di contenuto siano acquisite da Analytics.

  1. Cerca c.a.x.web.webpagedetails.pageviews.value=1.

  2. Scorri verso il basso per visualizzare gn variabile. È la sintassi dinamica di Analytics per s.pageName variabile. Acquisisce il nome della pagina dal livello dati.

    Stringa di prodotto di Analytics

Convalida della stringa di prodotto e degli eventi di e-commerce

Poiché ti trovi già in una pagina di prodotto, questo esercizio continua a utilizzare la stessa traccia Edge per convalidare i dati del prodotto acquisiti da Analytics. Sia la stringa di prodotto che gli eventi di e-commerce vengono mappati automaticamente le variabili XDM su Analytics. Se hai mappato al corretto productListItem Variabile XDM durante configurazione di uno schema XDM per Adobe Analytics, l’Edge Network di Platform si occupa della mappatura dei dati sulle variabili di analisi appropriate.

Verifica innanzitutto che il Product String è impostato

  1. Cerca c.a.x.productlistitems.[0].sku. La variabile acquisisce il valore dell'elemento dati mappato al productListItems.item1.sku all'inizio di questa lezione

  2. Cerca anche c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. La variabile acquisisce il valore dell’elemento dati su cui hai eseguito il mapping productListItems.item1._experience.analytics.customdimensions.evars.evar1

  3. Scorri verso il basso per visualizzare pl variabile. È la sintassi dinamica della variabile della stringa di prodotto Analytics

  4. Il nome del prodotto dal livello dati è mappato sia al c.a.x.productlistitems.[0].sku e product parametro della stringa prodotti. Inoltre, il titolo del prodotto dal livello dati viene mappato su evar1 merchandising nella stringa prodotti.

    Stringa di prodotto di Analytics

    La traccia Edge tratta commerce eventi leggermente diversi rispetto a productList dimensioni. Non viene visualizzata una variabile di dati contestuali mappata nello stesso modo in cui viene visualizzato il nome del prodotto mappato a c.a.x.productlistitem.[0].name sopra. La traccia Edge mostra invece la mappatura automatica finale dell’evento in Analytics event variabile. Platform Edge Network lo mappa di conseguenza, purché mappato sul modello XDM corretto commerce variabile durante configurazione dello schema per Adobe Analytics; in questo caso il commerce.productViews.value=1.

  5. Nella finestra di Experienci Platform Debugger, scorri verso il basso fino a events variabile, è impostato su prodView

  6. Nota anche c.a.x.eventType è impostato su commerce.productViews da quando ti trovi su una pagina di prodotto.

    note tip
    TIP
    Il ecommerce - pdp library loaded - AA (order 20) la regola sta sovrascrivendo il valore di eventType impostato da all pages global content variables - library loaded - AA (order 1) regola impostata per essere attivata successivamente nella sequenza

    Visualizzazione prodotto di Analytics

Convalida che gli altri eventi di e-commerce e le stringhe di prodotto siano impostati per Analytics

  1. Aggiungi Orologio Didi Sport al carrello

  2. Vai a Pagina carrello, verifica traccia spigolo per

    • eventType imposta su commerce.productListViews
    • events: "scView", e
    • la stringa di prodotto è impostata

    Vista carrello di Analytics

  3. Procedi con il pagamento, controlla Edge Trace per

    • eventType imposta su commerce.checkouts
    • events: "scCheckout", e
    • la stringa di prodotto è impostata

    Pagamento Analytics

  4. Compila solo il Nome e Cognome campi nel modulo di spedizione e selezionare Continua. Nella pagina successiva, seleziona Inserisci ordine

  5. Nella pagina di conferma, seleziona Edge Trace per

    • eventType imposta su commerce.purchases
    • Evento di acquisto in fase di impostazione events: "purchase"
    • Variabile codice valuta impostata cc: "USD"
    • ID acquisto impostato in pi
    • Stringa di prodotto pl impostazione del nome, della quantità e del prezzo del prodotto

    Acquisto Analytics

Convalidare Adobe Analytics utilizzando Assurance

Adobe Experience Platform Assurance consente di ispezionare, verificare, simulare e convalidare le modalità di raccolta dei dati o di gestione delle esperienze con il sito web e l’app mobile.

Nell’esercizio precedente hai verificato che Adobe Analytics acquisisce l’ECID, le visualizzazioni di pagina, la stringa di prodotto e gli eventi di e-commerce con la funzione Edge Trace di Experienci Platform Debugger. Successivamente, convalida gli stessi eventi utilizzando Adobe Experience Platform Assurance, un’interfaccia alternativa per accedere agli stessi dati in Edge Trace.

Come hai imparato nella Assurance In questa lezione sono disponibili diversi modi per avviare una sessione Assurance. Poiché hai già aperto un Adobe Experience Platform Debugger con una sessione Edge Trace avviata dall’ultimo esercizio, ti consigliamo di accedere ad Assurance tramite il debugger:
Garanzia tramite la raccolta dati di Adobe Experience Platform

All'interno del "Esercitazione Web SDK 3" Invio sessione di garanzia "hitdebugger" nella barra di ricerca degli eventi per filtrare i risultati in base ai dati post-elaborati di Adobe Analytics.
Dati post-elaborati di analisi dell’Adobe della garanzia

Convalida dell’ID Experience Cloud

Per verificare che Adobe Analytics acquisisca l’ECID, seleziona un beacon e apri il Payload. Il fornitore per questo beacon deve essere com.adobe.analytics.hitdebugger
Convalida Adobe Analytics con Assurance

Quindi scorri verso il basso fino a mcvisId per verificare che l’ECID sia stato acquisito correttamente
Convalida dell’ID Experience Cloud con Assurance

Convalida delle visualizzazioni della pagina del contenuto

Utilizzando lo stesso beacon, verifica che le visualizzazioni della pagina di contenuto siano mappate sulla variabile Adobe Analytics corretta.
Scorri verso il basso fino a pageName per verificare che Page Name viene acquisito correttamente
Convalida del nome della pagina con Assurance

Convalida della stringa di prodotto e degli eventi di e-commerce

Seguendo gli stessi casi di utilizzo di convalida utilizzati per la convalida con Experienci Platform Debugger, continua a utilizzare lo stesso beacon per convalidare Ecommerce Events e Product String.

  1. Cerca payload in cui Eventi contain prodView
    Convalida della stringa di prodotto con Assurance
  2. Scorri verso il basso fino a product-string per convalidare Product String.
    • Osserva Product SKU e Merchandizing eVar1.
  3. Scorri verso il basso e verifica che prop1, configurato utilizzando le regole di elaborazione nella sezione precedente, contiene Product SKU
    Stringa di prodotto con convalida delle variabili merchandizing con Assurance

Continua a convalidare la tua implementazione rivedendo il carrello, gli eventi di pagamento e gli eventi di acquisto.

  1. Cerca payload in cui Eventi contain scView e convalida la stringa di prodotto.
    Convalida della stringa di prodotto con Assurance
  2. Cerca payload in cui Eventi contain scCheckout e convalida la stringa di prodotto.
    Convalida della stringa di prodotto con Assurance
  3. Cerca payload in cui Eventi contain purchase
    Convalida della stringa di prodotto con Assurance
  4. Durante la convalida del purchase evento, tieni presente che Product String deve contenere Product SKU, Product Quantity , e Product Total Price.
  5. Inoltre, per purchase verificare che purchase-id e/o purchaseId sono impostati

Congratulazioni! Ce l'hai fatta! Questa è la fine della lezione e ora sei pronto a implementare Adobe Analytics con Platform Web SDK per il tuo sito Web.

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