DocumentazioneExperience PlatformTutorial su Web SDK

Configurare Adobe Analytics con Adobe Experience Platform Web SDK

Last update: Tue Jul 16 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, creare regole di tag per inviare dati ad Adobe Analytics e verificare 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 Web SDK-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 una.

  • 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 all'interfaccia Raccolta dati

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

  3. Seleziona lo stream di dati Luma Web SDK: Development Environment creato in precedenza

    Seleziona lo stream di dati di Luma Web SDK

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

  5. Seleziona Adobe Analytics come Servizio

  6. Immetti l'ID suite di rapporti della tua suite di rapporti per lo sviluppo

  7. Seleziona Salva

    Analisi salvataggio flusso di dati

    note tip
    TIP
    L'aggiunta di altre suite di rapporti selezionando Aggiungi suite di rapporti equivale all'assegnazione di tag multisuite.
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 nell'oggetto data (scelta consigliata).
  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. L'oggetto data (e l'elemento dati data.variable creato nella lezione Creare elementi dati) possono essere utilizzati 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 l'elenco aggiornato dei mapping, vedere Mappatura delle variabili di Analytics in Adobe Experience Edge.

Ciò si verifica se anche se non hai definito uno schema personalizzato. Experience 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 l'oggetto productListItems.

NOTE
A partire dal 18 agosto 2022, productListItems[].SKU ha la priorità per il mapping 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? L'impostazione delle variabili nell'oggetto data è 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.

Innanzitutto, qual è l'oggetto data? In qualsiasi evento Web SDK è possibile inviare due oggetti con dati personalizzati, l'oggetto xdm e l'oggetto data. Entrambi vengono inviati all'Edge Network di Platform, ma solo l'oggetto xdm viene inviato al set di dati di Experience Platform. Le proprietà nell'oggetto data possono essere mappate sui campi di Edge a xdm utilizzando la funzione Preparazione per la raccolta dati, ma in caso contrario non vengono inviate ad Experience Platform. Questo lo rende un modo ideale per inviare dati ad applicazioni come Analytics, che non sono native di Experience 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à nell'oggetto data.__adobe.analytics e utilizzarle per le variabili di Analytics.

Ora vediamo come funziona. Impostiamo eVar1 e prop1 con il nome della nostra pagina e vediamo 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 una nuova azione
  3. Seleziona estensione Adobe Experience Platform Web SDK
  4. Seleziona Tipo azione come Aggiorna variabile
  5. Seleziona data.variable come elemento dati
  6. Seleziona l'oggetto analytics
  7. Imposta eVar1 come elemento dati page.pageInfo.pageName
  8. Imposta prop1 per copiare il valore di eVar1
  9. Per verificare la sovrascrittura dei valori mappati XDM, nella sezione 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 l'azione Invia evento
  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 la configurazione di Adobe Analytics aprendo il menu ulteriori e selezionando Modifica

    Sovrascrivi 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

    Sovrascrivi 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 l'azione Invia evento.

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

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

  3. In Estensione, seleziona Core

  4. In Tipo evento, seleziona Libreria caricata (parte superiore della pagina)

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

  6. Seleziona Mantieni modifiche

    Sostituzione suite di rapporti di Analytics

  7. In Condizioni, seleziona Aggiungi

  8. Lascia Tipo di logica come Normale

  9. Lascia Estensioni come Core

  10. Seleziona Tipo condizione come Percorso senza stringa di query

  11. A destra, lascia l'opzione Regex disabilitata

  12. In 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. In Azioni selezionare Aggiungi

  15. Come Estensione, seleziona Adobe Experience Platform Web SDK

  16. Come Tipo azione, seleziona Invia evento

  17. Come dati XDM, seleziona l'elemento dati xdm.variable.content creato nella lezione Creare elementi dati

  18. Come Dati, seleziona l'elemento dati data.variable creato nella lezione Creare elementi dati

    Override dello stream di dati di Analytics

  19. Scorri verso il basso fino alla sezione Override configurazioni stream di dati

  20. Lascia selezionata la scheda Sviluppo.

    note tip
    TIP
    Questa scheda determina in quale ambiente di tag si verifica l’esclusione. Per questa esercitazione, si specifica solo l'ambiente di sviluppo, ma quando si distribuisce questo a produzione ricordare di farlo anche nell'ambiente Produzione.

  21. Seleziona Sandbox in uso per l'esercitazione

  22. Seleziona lo stream di dati, in questo caso Luma Web SDK: Development Environment

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

  24. Seleziona Mantieni modifiche

  25. E Salva la regola

    Override dello stream di dati di Analytics

Creare l’ambiente di sviluppo

Aggiungi le regole aggiornate alla libreria di tag Luma Web SDK Tutorial e rigenera l'ambiente di sviluppo.

Congratulazioni! Il passaggio successivo consiste nel convalidare l’implementazione di Adobe Analytics tramite Experience 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 Experience Platform Debugger.

Nella lezione Debugger, hai imparato a esaminare 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'implementazione di Analytics AppMeasurement.js. 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 Experience Platform Web SDK, devi effettuare due passaggi ulteriori:

  1. Convalidare il modo in cui i dati vengono elaborati dall’oggetto XDM nell’Edge Network di Platform, utilizzando la funzione di traccia di Edge di Experience 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 al sito demo 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 Experience Platform Debugger e imposta la proprietà del tag sul sito sulla tua proprietà di sviluppo

  4. Per abilitare Edge Trace, vai a Debugger Experience Platform, nella navigazione a sinistra seleziona Registri, quindi seleziona la scheda Edge e infine seleziona Connetti

    Connetti traccia Edge

  5. Per ora sarà vuoto

    Traccia Edge connessa

  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 sia il menu a discesa mappedQueryParams che il secondo per visualizzare le variabili di Analytics

    Beacon di Analytics Edge Trace

    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. Continuare a scorrere verso il basso fino a visualizzare la variabile mid di Analytics. 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 acquisito anche in c.a.x.identitymap.lumacrmid.[0].id

Convalida dell’override della suite di rapporti

Qui sopra hai configurato una sostituzione dello stream di dati per la home page Luma. Per convalidare questa configurazione

  1. Cerca una riga con Configurazione dello stream di dati dopo l'applicazione dell'override. 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 mostri la suite di rapporti specificata nelle configurazioni di sostituzione

    Convalida chiamata di sostituzione suite di rapporti di Analytics

Convalida delle visualizzazioni della pagina del contenuto

Vai a una pagina di prodotto come 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. Scorrere verso il basso per visualizzare la variabile gn. Sintassi dinamica di Analytics per la variabile s.pageName. Acquisisce il nome della pagina dal livello dati.

    Stringa prodotto 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 di 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 eseguito il mapping alla variabile XDM productListItem corretta durante la configurazione di uno schema XDM per Adobe Analytics, l'Edge Network di Platform si occupa di mappare i dati alle variabili di analisi appropriate.

Verificare innanzitutto che Product String sia impostato

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

  2. Cerca anche c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1. La variabile acquisisce il valore elemento dati mappato a productListItems.item1._experience.analytics.customdimensions.evars.evar1

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

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

    Stringa prodotto Analytics

    Edge Trace tratta gli eventi commerce in modo leggermente diverso rispetto alle dimensioni productList. 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 di Edge mostra invece il mapping automatico dell'evento finale nella variabile event di Analytics. L'Edge Network della piattaforma ne esegue il mapping in base alla variabile XDM commerce corretta durante la configurazione dello schema per Adobe Analytics; in questo caso commerce.productViews.value=1.

  5. Nella finestra di Experience Platform Debugger, scorri verso il basso fino alla variabile events, è impostata su prodView

  6. Nota inoltre che c.a.x.eventType è impostato su commerce.productViews poiché ci si trova in una pagina di prodotto.

    note tip
    TIP
    La regola ecommerce - pdp library loaded - AA (order 20) sovrascrive il valore di eventType impostato dalla regola all pages global content variables - library loaded - AA (order 1) in quanto è impostato per l'attivazione in un secondo momento della sequenza

    Visualizzazione prodotto Analytics

Convalidare il resto degli eventi di e-commerce e le stringhe di prodotto impostate per Analytics

  1. Aggiungi Didi Sport Watch al carrello

  2. Vai alla pagina carrello, controlla Edge Trace per

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

    Visualizzazione carrello di Analytics

  3. Procedi con il pagamento, controlla Edge Trace per

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

    Estrazione di Analytics

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

  5. Nella pagina di conferma, seleziona Edge Trace per

    • eventType impostato 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 che imposta il nome, la quantità e il prezzo del prodotto

    Acquisto di 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 Experience Platform Debugger. Successivamente, puoi convalidare gli stessi eventi utilizzando Adobe Experience Platform Assurance, un’interfaccia alternativa per accedere agli stessi dati in Edge Trace.

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

All'interno del "Esercitazione Web SDK 3" Sessione di controllo immettere "hitdebugger" nella barra di ricerca degli eventi per filtrare i risultati sui dati elaborati di Adobe Analytics Post.
Dati elaborati da Post per analisi Adobe affidabilità

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 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 sia 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 della convalida utilizzati durante la convalida con Experience Platform Debugger precedente, continua a utilizzare lo stesso beacon per convalidare Ecommerce Events e Product String.

  1. Cerca payload in cui eventi contengono prodView
    Convalida della stringa di prodotto con Assurance
  2. Scorri verso il basso fino a product-string per convalidare Product String.
    • Annotare Product SKU e Merchandizing eVar1.
  3. Scorri verso il basso e verifica che prop1, configurato utilizzando le regole di elaborazione nella sezione precedente, contenga 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 il payload in cui eventi contengono scView e convalida la stringa di prodotto.
    Convalida della stringa di prodotto con Assurance
  2. Cerca il payload in cui eventi contengono scCheckout e convalida la stringa di prodotto.
    Convalida della stringa di prodotto con Assurance
  3. Cerca payload in cui eventi contengono purchase
    Convalida della stringa di prodotto con Assurance
  4. Durante la convalida dell'evento purchase, tenere 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 siano 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 in questo Experience League post di discussione della community
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4