Aggiungere Adobe Analytics

Ultimo aggiornamento: 5 maggio 2025
  • Argomenti:

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

In questa lezione, implementerai l’estensione Adobe Analytics e creerai regole per inviare dati ad Adobe Analytics.

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

NOTA
Adobe Experience Platform Launch viene integrato in Adobe Experience Platform come suite di tecnologie per la raccolta dati. Nell’interfaccia sono state introdotte diverse modifiche terminologiche di cui tenere conto quando si utilizza questo contenuto:

Finalità di apprendimento

Alla fine di questa lezione, potrai:

  1. Aggiungere l’estensione Adobe Analytics
  2. Imposta le variabili globali tramite l'estensione
  3. Aggiungi il beacon di visualizzazione pagina
  4. Aggiungi variabili aggiuntive tramite le regole
  5. Aggiungi il tracciamento dei clic e altri beacon basati su eventi
  6. Aggiungere i plug-in di Analytics

Puoi implementare molti elementi per Analytics nei tag. Questa lezione non è esaustiva, ma fornisce una panoramica delle tecniche principali necessarie da implementare nel tuo sito.

Prerequisiti

Devi avere già completato le lezioni in Configura tag e Aggiungi il servizio Identity.

Inoltre, devi disporre di almeno un ID suite per report e del tracking server. Se non hai una suite per report test/dev che puoi usare per questa esercitazione, creane una. Se non sai come farlo, consulta la documentazione. Puoi recuperare il tracking server dalla tua implementazione corrente dall’Adobe Consultant o dal rappresentante dell’Assistenza clienti.

Aggiungi l’estensione Analytics

L’estensione di Analytics consiste in due parti principali:

  1. La configurazione dell'estensione, che gestisce le impostazioni della libreria principale AppMeasurement.js e può impostare variabili globali

  2. Azioni di regola per eseguire le operazioni seguenti:

    1. Imposta variabili
    2. Cancella variabili
    3. Inviare il beacon di Analytics

Aggiungere l’estensione Analytics

  1. Vai a Estensioni > Catalogo

  2. Individua l’estensione Adobe Analytics

  3. Fai clic su Installa

    Installare l’estensione Analytics

  4. In Gestione libreria > Suite per report, immetti gli ID suite per report che desideri utilizzare con ogni ambiente di tag. Se gli utenti hanno accesso ad Adobe Analytics, tieni presente che quando inizi a digitare nella casella verrà visualizzato un elenco precompilato di tutte le suite di rapporti. (È possibile utilizzare una suite per report per tutti gli ambienti in questa esercitazione, ma in uno scenario reale dovresti utilizzare suite per report separate, come illustrato nell’immagine seguente).

    Inserire gli ID delle suite per report

    SUGGERIMENTO
    È consigliabile utilizzare l'opzione Gestisci la libreria per me come impostazione Gestione libreria, in quanto consente di mantenere la libreria AppMeasurement.js aggiornata in modo molto più semplice.

  5. In Generale > Server di monitoraggio, immettere il server di monitoraggio, ad esempio tmd.sc.omtrdc.net. Immetti Server di tracciamento SSL se il sito supporta https://.

    Immettere i server di tracciamento

  6. Nella sezione Variabili globali, in Impostazioni aggiuntive, imposta la variabile Nome pagina utilizzando l'elemento dati Page Name. Fai clic sull’icona icona dell’elemento dati per aprire il modale e scegli l’Page Nameelemento dati della pagina).

  7. Fai clic su Salva nella libreria

    Impostare la variabile del nome della pagina e salvare

NOTA
Le variabili globali possono essere impostate nella configurazione dell’estensione o nelle azioni di regola. Tieni presente che quando imposti variabili nella configurazione dell'estensione, il livello dati deve essere definito prima dei codici di incorporamento dei tag.

Invia il beacon Vista pagina

Ora creerai una regola per attivare il beacon di Analytics, che invierà la variabile Page Name impostata nella configurazione dell’estensione.

Hai già creato una regola "All Pages - Library Loaded" in Aggiungi un elemento dati, una regola e una libreria lezione di questa esercitazione, che viene attivata su ogni pagina al caricamento della libreria di tag. è possibile utilizzare questa regola anche per Analytics, tuttavia questa configurazione richiede che tutti gli attributi del livello dati utilizzati nel beacon di Analytics siano definiti prima dei codici di incorporamento dei tag. Per consentire una maggiore flessibilità con la raccolta dati, crea una nuova regola “all pages” attivata sul DOM Ready per attivare il beacon Analytics.

Inviare il beacon Vista pagina

  1. Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola

    Aggiungi regola

  2. Denomina la regola All Pages - DOM Ready

  3. Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

    Denominare la regola e aggiungere un evento

  4. Seleziona Tipo evento > DOM Ready (tieni presente che l'ordine della regola è "50")

  5. Fai clic su Mantieni modifiche
    Configurare l’evento

  6. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Fare clic sull’icona Più per aggiungere una nuova azione

  7. Seleziona Estensione > Adobe Analytics

  8. Seleziona Tipo azione > Invia beacon

  9. Lascia Tracking impostato su s.t(). Tieni presente che se desideri effettuare una chiamata s.tl() in una regola di evento clic, puoi farlo utilizzando anche l’azione Invia beacon.

  10. Fai clic sul pulsante Mantieni modifiche

    Fare clic sull’icona Più per aggiungere una nuova azione

  11. Fai clic su Salva nella libreria e genera

    Fare clic su Salva nella libreria e genera

Convalidare il beacon Vista pagina

Dopo aver creato una regola per inviare un beacon Analytics, dovresti essere in grado di visualizzare la richiesta in Experience Cloud Debugger.

  1. Apri il sito Luma nel browser Chrome.

  2. Fai clic sull'icona Debugger Apri il Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger

  3. Accertati che Debugger mappi la proprietà tag nell'ambiente di sviluppo your, come descritto nella lezione precedente

    Lambiente di sviluppo dei tag visualizzato in Debugger

  4. Fai clic per aprire la scheda Analytics.

  5. Espandi il nome della suite per report per mostrare tutte le richieste ad essa effettuate.

  6. Conferma l’avvio della richiesta con la variabile e il valore Nome pagina.

    Convalidare l’hit pagina

NOTA
Se Nome pagina non viene visualizzato, torna indietro nei passaggi della pagina per assicurarti di non aver tralasciato nulla.

Aggiungi variabili con regole

Una volta configurata l’estensione Analytics, hai popolato la variabile pageName nella configurazione dell’estensione. Si tratta di una posizione ideale per compilare altre variabili globali, come eVar e proprietà, a condizione che il valore sia disponibile sulla pagina prima del caricamento del codice di incorporamento del tag.

Una posizione più flessibile per impostare le variabili, così come gli eventi, si trova nelle regole, utilizzando l’azioneSet Variables. Le regole consentono di impostare variabili di Analytics ed eventi differenti in condizioni diverse. Ad esempio, puoi impostare prodView solo sulle pagine di dettaglio del prodotto e l’evento purchase solo nelle pagine di conferma degli ordini. In questa sezione ti viene illustrato come impostare le variabili utilizzando le regole.

Caso d'uso

Product Detail Pages (PDP) sono punti importanti per la raccolta di dati sui siti di vendita al dettaglio. In genere, si desidera che Analytics registri la visualizzazione di un prodotto e il prodotto visualizzato. Questo è utile per capire i prodotti più popolari tra i clienti. Su un sito multimediale, le pagine di articolo o video potrebbero utilizzare tecniche di tracciamento simili a quelle che utilizzerai in questa sezione. Quando carichi una pagina di dettagli del prodotto, potrebbe essere utile inserire tale valore in un “Page Type” eVar e impostare alcuni eventi e l’ID prodotto. Questo consente di visualizzare quanto segue nell’analisi:

  1. Quante volte vengono caricate le pagine dei dettagli del prodotto
  2. Quali prodotti specifici vengono visualizzati e quante volte
  3. Come incidono gli altri fattori (campagne, ricerca, ecc.) sul numero di persone PDP che caricano

Crea elemento dati per tipo di pagina

Innanzitutto devi identificare quali sono le pagine dei dettagli prodotto. Puoi farlo con un elemento dati.

Creare l’elemento dati per Page Type

  1. Fai clic su Elementi dati nel menu di navigazione a sinistra

  2. Fai clic su Aggiungi elemento dati

    Aggiungere un nuovo elemento dati

  3. Denomina l’elemento dati Page Type

  4. Seleziona Tipo elemento dati > Variabile JavaScript

  5. Utilizza digitalData.page.category.type come nome variabile JavaScript

  6. Controlla le opzioni Pulisci testo e Forza lettere minuscole

  7. Fai clic su Salva nella libreria

    Aggiungere un nuovo elemento dati per Page Type

Creare un elemento dati per ID prodotto

Quindi, raccogli l’ID prodotto della pagina dettagli prodotto corrente con un elemento dati.

Creare l’elemento dati per l’ID prodotto

  1. Fai clic su Elementi dati nel menu di navigazione a sinistra

  2. Fai clic su Aggiungi elemento dati

    Aggiungere un nuovo elemento dati

  3. Denomina l’elemento dati Product Id

  4. Seleziona Tipo elemento dati > Variabile JavaScript

  5. Utilizza digitalData.product.0.productInfo.sku come nome variabile JavaScript

  6. Controlla le opzioni Pulisci testo e Forza lettere minuscole

  7. Fai clic su Salva nella libreria

    Aggiungere un nuovo elemento dati per Page Type

Aggiungi l’estensione Adobe Analytics Product String

Se conosci le implementazioni di Adobe Analytics, probabilmente hai già familiarità con le variabili dei prodotti. La variabile dei prodotti ha una sintassi specifica e viene utilizzata modi leggermente diversi a seconda del contesto. Per semplificare la popolazione della variabile dei prodotti nei tag, sono state create tre estensioni aggiuntive nel marketplace dell’estensione tag. In questa sezione viene aggiunta un’estensione creata da Adobe Consulting per l’utilizzo nella pagina Product Detail.

Aggiungere l’Adobe Analytics Product Stringestensione

  1. Vai alla pagina Estensioni > Catalogo.

  2. Trova l'estensione Adobe Analytics Product String dai servizi Adobe Consulting e fai clic su Installa
    Aggiungere l’estensione Adobe Analytics Product String di Adobe Consulting

  3. Leggi le istruzioni.

  4. Fai clic su Salva nella libreria

    Salvare l’estensione e generarla nella libreria

Crea la regola per le pagine dettagli prodotto

Adesso, utilizza i nuovi elementi di dati e l’estensione per generare la regola per la pagina Product Detail. Per questa funzionalità, creerai un’altra regola di caricamento della pagina, attivata da DOM Ready. Tuttavia, utilizzerai una condizione per attivare solo le pagine di dettaglio del prodotto e l’impostazione dell’ordine in modo che venga attivato prima della regola che invia il beacon.

Creare la regola della pagina Dettagli prodotto

  1. Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola

    Aggiungi regola

  2. Denomina la regola Product Details - DOM Ready - 40

  3. Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

    Denominare la regola e aggiungere un evento

  4. Seleziona Tipo evento > DOM Ready

  5. Imposta Ordine su 40, in modo che la regola venga eseguita prima della regola contenente l'azione Analytics > Invia beacon

  6. Fai clic su Mantieni modifiche
    Configurare l’evento

  7. In Condizioni, fai clic su Fai clic sullicona Più per aprire la schermata Condition Configuration
    Fare clic sull’icona Più per aggiungere una nuova condizione

    1. Seleziona Tipo condizione > Confronto valori

    2. Utilizza il selettore degli elementi dati, scegli Page Type nel primo campo.

    3. Seleziona Contiene dal menu a discesa operatore di confronto

    4. Nel tipo di campo successivo, digita product-page (questa è la parte univoca del valore di Page Type estratto dal livello dati su PDP).

    5. Fai clic su Mantieni modifiche

      Definire la condizione

  8. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Fare clic sull’icona Più per aggiungere una nuova azione

  9. Seleziona Estensione > Adobe Analytics Product String

  10. Seleziona Tipo azione > Imposta s.products

  11. Nella sezione Analytics E-commerce Event, seleziona prodView

  12. Nella sezione Variabili del livello dati per i dati del prodotto, utilizza il selettore Elemento dati per scegliere l'elemento dati Product Id

  13. Fai clic su Mantieni modifiche

    Aggiungere la variabile Product String utilizzando l’estensione Adobe Analytics Product String

  14. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

    Aggiungere un’altra azione per Product String

  15. Seleziona Estensione > Adobe Analytics

  16. Seleziona Tipo azione > Imposta variabili

  17. Seleziona eVar1 > Imposta come e immetti product detail page

  18. Imposta event1, lasciando vuoti i valori facoltativi

  19. In Eventi, fai clic sul pulsante Aggiungi un altro

  20. Imposta l'evento prodView, lasciando vuoti i valori facoltativi

  21. Fai clic su Mantieni modifiche

    Impostare le variabili di Analytics nella regola PDP

  22. Fai clic su Salva nella libreria e genera

    Salva la regola

Convalida i dati della pagina di dettagli prodotto

È stata appena creata una regola che imposta le variabili prima dell’invio del beacon. Ora dovresti essere in grado di vedere i nuovi dati che escono nell’hit in Experience Cloud Debugger.

Convalidare i dati della pagina di dettagli prodotto

  1. Apri il sito Luma nel browser Chrome.

  2. Vai a qualsiasi pagina dei dettagli del prodotto.

  3. Fai clic sull'icona Debugger Apri il Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger

  4. Fai clic sulla scheda Analytics.

  5. Espandi la suite per report.

  6. Nota le variabili Product Detail attualmente presenti nel debugger, in particolare che eVar1 è stato impostato su “product detail page”, che la variabile Events è stata impostata su “event1” e “prodView” e che la variabile prodotti è impostata con l’ID prodotto del prodotto che stai visualizzando e che il nome pagina è ancora impostato dall’estensione di Analytics.

    Convalidare l’hit pagina

Quando viene caricata una pagina, in genere viene attivato un beacon di caricamento della pagina dalla funzione s.t(). Questo incrementa automaticamente una metrica page view per la pagina indicata nella variabile pageName.

Tuttavia, a volte è meglio non incrementare le visualizzazioni di pagina sul sito, perché l’azione che avviene è più piccola, o forse solo diversa, rispetto alla visualizzazione di una pagina. In questo caso, utilizza la funzione s.tl(), comunemente definita richiesta di collegamento di tracciamento. Anche se è definita richiesta di collegamento di tracciamento, non deve essere attivata su un clic di collegamento. Può essere attivato da qualsiasi degli eventi disponibili nel generatore di regole di tag, incluso JavaScript personalizzato.

In questa esercitazione, verrà attivata una chiamata s.tl() utilizzando uno degli eventi JavaScript più interessanti, un evento Enters Viewport.

Caso d’utilizzo

Per questo caso d'uso, vuoi sapere se le persone stanno scorrendo sulla nostra home page Luma, fino ad arrivare alla sezione Prodotti in primo piano della nostra pagina. Nella nostra azienda c’è qualche disaccordo interno sulla possibilità che le persone vedano o meno quella sezione, per cui vuoi usare Analytics per scoprire la verità.

Creare la regola nei tag

  1. Vai alla sezione Regole nel menu di navigazione a sinistra, quindi fai clic su Aggiungi regola
    Aggiungi regola

  2. Denomina la regola Homepage - Featured Products enters Viewport

  3. Fai clic su Eventi > Aggiungi per aprire la schermata Event Configuration

    Aggiungi regola prodotti in primo piano

  4. Selezionare Tipo evento > Enters Viewport. Viene visualizzato un campo in cui è necessario inserire il selettore CSS che identificherà l’elemento nella pagina che dovrebbe attivare la regola, quando si entra nella visualizzazione nel browser.

  5. Torna alla home page di Luma e scorri verso il basso fino alla sezione Prodotti in primo piano.

  6. Fare clic con il pulsante destro del mouse sullo spazio tra il titolo "PRODOTTI IN PRIMO PIANO" e gli elementi di questa sezione e selezionare Inspect dal menu di scelta rapida. Questo ti porterà vicino a ciò che desideri.

  7. Proprio lì intorno, possibilmente sotto la sezione selezionata, devi trovare un div con class="we-productgrid aem-GridColumn aem-GridColumn--default--12". Individua questo elemento.

  8. Fai clic con il pulsante destro del mouse su questo elemento e seleziona Copia > Copia selettore

    Configurare l’evento Enters Viewport

  9. Torna ai tag e incolla questo valore dagli Appunti nel campo con etichetta Elements matching the CSS selector.

    1. Per inciso, spetta a te decidere come identificare i selettori CSS. Questo metodo è un po’ fragile, in quanto alcune modifiche sulla pagina potrebbero interrompere il selettore. Tienilo presente quando utilizzi qualsiasi selettore CSS nei tag.

  10. Fai clic su Mantieni modifiche
    Configurare l’evento Enters Viewport

  11. In Condizioni, fai clic su fai clic sull’icona Più per aggiungere una nuova condizione.

  12. Seleziona Tipo condizione > Confronto valori

  13. Utilizza il selettore degli elementi dati, scegli Page Name nel primo campo.

  14. Seleziona Uguale a dal menu a discesa dell'operatore di confronto

  15. Nel campo successivo, digita content:luma:us:en (si tratta del nome della pagina principale che è stato estratto dal livello dati, vogliamo che questa regola venga eseguita solo sulla pagina iniziale).

  16. Fai clic su Mantieni modifiche

    Configurare la condizione della pagina iniziale

  17. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

  18. Seleziona Estensione > Adobe Analytics

  19. Seleziona Tipo azione > Imposta variabili

  20. Imposta eVar3 su Home Page - Featured Products.

  21. Imposta prop3 su Home Page - Featured Products.

  22. Imposta la variabile Events su event3.

  23. Fai clic su Mantieni modifiche

    Configurare l’evento Enters Viewport

  24. In Azioni, fai clic su fai clic sull’icona Più per aggiungere una nuova azione.

  25. Seleziona Estensione > Adobe Analytics

  26. Seleziona Tipo azione > Invia beacon

  27. Scegli l'opzione di tracciamento s.tl()

  28. Nel campo Nome collegamento immettere Scrolled down to Featured Products. Questo valore verrà inserito nel report Collegamenti personalizzati in Analytics.

  29. Fai clic su Mantieni modifiche

    Configurazione beacon prodotti in primo piano

  30. Fai clic su Salva nella libreria e genera

    Salvare la regola e generare

Ora è necessario assicurarsi che questo hit venga inserito quando si scorre verso il basso fino alla sezione Prodotti in primo piano della home page del nostro sito. Quando carichi la pagina iniziale, la richiesta non dovrebbe essere effettuata, ma dopo lo scorrimento verso il basso e la visualizzazione della sezione, l’hit dovrebbe venire attivato con i nuovi valori specificati.

  1. Apri il sito Luma nel browser Chrome e accertati di essere nella parte superiore della pagina iniziale.

  2. Fai clic sull'icona debugger Apri il Experience Cloud Debugger per aprire Adobe Experience Cloud Debugger

  3. Fai clic sulla scheda Analytics.

  4. Espandi l’hit della suite per report.

  5. Osservate l’hit della visualizzazione pagina normale per la pagina iniziale con il nome della pagina, ecc. (ma niente in eVar3 o prop3).

    Debugger con visualizzazione pagina

  6. Lasciando aperto Debugger, scorri verso il basso sul sito fino a visualizzare la sezione Prodotti in primo piano

  7. Visualizza di nuovo il Debugger, ora dovrebbe essere presente un altro hit Analytics. Questo hit deve avere i parametri associati all’hit s.tl() configurato, ovvero:

    1. LinkType = "link_o" (questo significa che l’hit è un hit di collegamento personalizzato, non un hit di visualizzazione della pagina).

    2. LinkName = "Scrolled down to Featured Products"

    3. prop3 = "Home Page - Featured Products"

    4. eVar3 = "Home Page - Featured Products"

    5. Events = "event3"

      Debugger con visualizzazione pagina