DocumentazioneExperience PlatformTutorial su Web SDK

Configurare Adobe Analytics con Adobe Experience Platform Web SDK

Last update: Sat Jun 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

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 le variabili di Analytics nell’oggetto dati
  • 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.

Impostare le variabili di Analytics

Esistono diversi modi per impostare le variabili di Analytics in un’implementazione Web SDK:

  1. Mappatura automatica dei campi XDM sulle variabili di Analytics (automatica).
  2. Impostare i campi in data oggetto (consigliato).
  3. Mappa i campi XDM sulle variabili di Analytics nelle regole di elaborazione di Analytics (non più consigliato).
  4. Mappa sulle variabili di Analytics direttamente nello schema XDM (non più consigliato).

A partire da maggio 2024, non è più necessario creare uno schema XDM per implementare Adobe Analytics con Platform Web SDK. Il data oggetto (e data.variable elemento dati creato in Creare elementi dati lezione) può essere utilizzato per impostare tutte le variabili di Analytics personalizzate. L’impostazione di queste variabili nell’oggetto dati sarà familiare ai clienti Analytics esistenti, è più efficiente dell’utilizzo dell’interfaccia delle regole di elaborazione e impedisce che dati non necessari occupino spazio in Real-Time Customer Profiles (importante se si dispone di Real-time Customer Data Platform o Journey Optimizer).

Campi mappati automaticamente

Molti campi XDM vengono mappati automaticamente alle variabili di Analytics. Per un elenco aggiornato delle mappature, consulta Mappatura delle variabili di Analytics in Adobe Experience Edge.

Ciò si verifica se anche se non hai definito uno schema personalizzato. Experienci Platform Web SDK raccoglie automaticamente alcuni dati e li invia a Platform Edge Network come campi XDM. Ad esempio, Web SDK legge l’URL della pagina corrente e lo invia come campo XDM web.webPageDetails.URL. Questo campo viene inoltrato ad Adobe Analytics e automaticamente popola i rapporti URL pagina in Adobe Analytics.

Se implementi Web SDK per Adobe Analytics con uno schema XDM, come hai fatto in questa esercitazione, alcuni dei campi XDM che hai implementato sono mappati automaticamente alle variabili 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.

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

Impostare le variabili nell’oggetto dati

Ma cosa dire di eVar, prop ed eventi? Impostazione delle variabili in data L’oggetto è il metodo consigliato per impostare queste variabili di Analytics con Web SDK. L’impostazione delle variabili nell’oggetto dati può inoltre sovrascrivere qualsiasi variabile mappata automaticamente.

Prima di tutto, qual è la data oggetto? In qualsiasi evento Web SDK è possibile inviare due oggetti con dati personalizzati, il xdm oggetto e data oggetto. Entrambi vengono inviati all’Edge Network di Platform, ma solo xdm L’oggetto viene inviato al set di dati Experienci Platform. Proprietà in data L'oggetto può essere mappato sul server Edge a xdm I campi che utilizzano la funzione Preparazione per la raccolta dati, ma che in caso contrario non vengono inviati ad Experienci Platform. Questo lo rende un modo ideale per inviare dati ad applicazioni come Analytics, che non sono native di Experienci Platform.

Di seguito sono riportati i due oggetti in una chiamata Web SDK generica:

dati e oggetti xdm

Adobe Analytics è configurato per cercare eventuali proprietà in data.__adobe.analytics e utilizzarli per le variabili di Analytics.

Ora vediamo come funziona. Impostiamo eVar1 e prop1 con il nome della pagina e scopri come il valore mappato da XDM può essere sovrascritto

  1. Apri la regola di tag all pages - library loaded - set global variables - 1
  2. Aggiungi un nuovo Azione
  3. Seleziona Adobe Experience Platform Web SDK estensione
  4. Seleziona Tipo di azione as Aggiorna variabile
  5. Seleziona data.variable come Elemento dati
  6. Seleziona la analisi oggetto
  7. Imposta eVar1 come page.pageInfo.pageName elemento dati
  8. Imposta prop1 per copiare il valore di eVar1
  9. Per verificare la sovrascrittura dei valori mappati XDM, in Proprietà aggiuntiva impostare il nome della pagina come valore statico test
  10. Salva la regola

Ora è necessario includere l’oggetto dati nella regola dell’evento di invio.

  1. Apri la regola di tag all pages - library loaded - send event - 50
  2. Apri Invia evento azione
  3. Seleziona data.variable come Dati
  4. Seleziona Mantieni modifiche
  5. Seleziona Salva

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 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 Library Loaded (Page Top)

  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.

  6. Seleziona Mantieni modifiche

    Override suite di rapporti di Analytics

  7. Sotto Condizioni, seleziona per Aggiungi

  8. Esci Tipo di logica as Normale

  9. Esci Estensioni as Core

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

  11. A destra, lascia il Regex interruttore disabilitato

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

  13. Seleziona Mantieni modifiche

    Condizione di esclusione suite di rapporti di Analytics

  14. Sotto Azioni seleziona Aggiungi

  15. Come Estensione, seleziona Adobe Experience Platform Web SDK

  16. Come Tipo di azione, seleziona Invia evento

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

  18. Come Dati, seleziona la data.variable elemento dati creato in Creare elementi dati lezione

    Sostituzione dello stream di dati di Analytics

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

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

  21. Seleziona la Sandbox stai utilizzando per l’esercitazione

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

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

  24. Seleziona Mantieni modifiche

  25. E Salva regola

    Sostituzione dello stream di dati di Analytics

Creare l’ambiente di sviluppo

Aggiungi le regole aggiornate 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