Misura le applicazioni con una sola pagina

Questo documento è destinato agli sviluppatori che vogliono misurare le visualizzazioni di pagina nella propria applicazione a pagina singola utilizzando Google Analytics.

Le applicazioni a pagina singola (SPA) sono siti web che caricano un documento HTML una sola volta e recuperano qualsiasi contenuto aggiuntivo utilizzando le API JavaScript.

Esempio: supponiamo che tu abbia un modulo per acquisire alcuni lead. Il modulo ha tre schermate:

• Prima schermata per acquisire i dati del cliente.
• Seconda schermata in cui i clienti indicano il loro interesse per determinati servizi.
• Pagina della terza schermata per registrarsi ai webinar relativi agli interessi del cliente.

La chiave per misurare correttamente le visualizzazioni di pagina dalle SPA è contare le visualizzazioni di pagina per ogni schermata con cui un utente interagisce e ottenere il referrer della pagina corretto, in modo da poter tracciare correttamente il percorso dell'utente.

Prima di iniziare

Questa pagina presuppone che tu abbia già:

• Un account e una proprietà Google Analytics 4 per il tuo sito web. Scopri come configurare Google Analytics.

• Un tag Google implementato sul tuo sito web che viene attivato al caricamento iniziale della pagina. Scopri come configurare il tag Google.

Implementare la misurazione delle applicazioni a pagina singola

Per implementare una misurazione accurata delle SPA, utilizza uno di questi metodi per attivare una nuova visualizzazione di pagina virtuale:

• Modifiche della cronologia del browser (consigliato): se la tua SPA utilizza l'API History, in particolare i metodi pushState() e replaceState() per aggiornare le schermate, utilizza questa opzione.

• Eventi personalizzati: se il tuo sito web utilizza l' DocumentFragment oggetto per eseguire il rendering di schermate diverse, utilizza questa opzione.

Implementazione della modifica della cronologia del browser

Se la tua SPA utilizza l'API History, puoi attivare la misurazione avanzata in Google Analytics per monitorare automaticamente le visualizzazioni di pagina in base agli eventi della cronologia del browser.

Attivare la misurazione avanzata in GA4

Per misurare page_views automaticamente in base alla cronologia del browser:

1. Apri Google Analytics.

2. In Amministrazione, in Raccolta e modifica dei dati, fai clic su Stream di dati > Web.

3. In Misurazione avanzata, imposta l'opzione su On per abilitare tutte le opzioni.

4. Fai clic per modificare le singole opzioni. In Visualizzazioni di pagina, fai clic su Mostra impostazioni avanzate. Assicurati di attivare sia Caricamenti di pagina sia Cambi di pagina in base agli eventi della cronologia del browser.

   

5. Salva le modifiche.

Nota:quando la misurazione avanzata è attivata per "Cambi di pagina in base agli eventi della cronologia del browser", Google Analytics rileva automaticamente gli eventi della cronologia (come quelli utilizzati nelle SPA) e invia gli eventi page_view. Non devi configurare attivatori o variabili della cronologia specifici in Google Tag Manager allo scopo di inviare visualizzazioni di pagina a GA4.

Utilizzare gli attivatori di Google Tag Manager per gli eventi della cronologia

Se devi attivare altri tipi di tag in Google Tag Manager in base alle modifiche della cronologia del browser, ad esempio per inviare dati ad altre piattaforme di marketing, puoi utilizzare il tipo di attivatore "Modifica cronologia".

Quando configuri tag o variabili per l'utilizzo con l'attivatore Modifica cronologia, assicurati di utilizzare le variabili integrate corrette fornite da Google Tag Manager:

• History New URL Fragment: il frammento dell'URL dopo l'evento della cronologia.
• History Old URL Fragment: il frammento dell'URL prima dell'evento della cronologia.
• History New State: il nuovo oggetto dello stato della cronologia.
• History Old State: il vecchio oggetto dello stato della cronologia.
• History Source: l'origine dell'evento della cronologia (ad esempio popstate, pushState, replaceState).

Potrebbe essere necessario attivare queste variabili integrate in Google Tag Manager in Variabili > Configura.

Per ulteriori dettagli su questo attivatore, consulta l'articolo Attivatore Modifica cronologia.

Verificare la configurazione della misurazione

Per verificare che l'applicazione a pagina singola misuri correttamente le visualizzazioni di pagina:

1. Attiva la modalità di debug per ogni tag nella configurazione della misurazione della SPA. Scopri come monitorare gli eventi in DebugView.

2. Fai clic sull'applicazione a pagina singola. Quando fai clic su una nuova schermata virtuale, dovresti visualizzare un nuovo evento page_view in DebugView. Confronta i parametri dell'evento page_view con l'evento page_view precedente per verificare se il referrer della pagina e la posizione della pagina sono stati aggiornati correttamente.

Impatto sugli eventi automatici

Se implementi correttamente la misurazione delle visualizzazioni di pagina virtuali nella tua SPA, Google Analytics gestirà correttamente gli altri eventi automatici. Se le visualizzazioni di pagina virtuali non vengono registrate per le modifiche della schermata, Google Analytics tratta la SPA come una singola pagina, il che porta a metriche distorte.

Ad esempio, l'evento user_engagement misura il tempo che un utente trascorre attivamente su una pagina. Senza le visualizzazioni di pagina virtuali, tutta la durata del coinvolgimento viene attribuita al caricamento pagina iniziale, il che rende impossibile analizzare il tempo trascorso sulle singole schermate.

Quando la misurazione delle visualizzazioni di pagina virtuali è implementata correttamente:

• L'evento user_engagement viene inviato quando l'utente passa da una pagina virtuale all'altra.
• La durata del coinvolgimento per la pagina virtuale precedente viene calcolata e inviata insieme all'evento user_engagement, in genere poco prima dell'elaborazione dell'evento page_view per la nuova pagina virtuale.
• Altri eventi, come clic o scorrimenti, sono associati a page_location della pagina virtuale attualmente visualizzata dall'utente.

In questo modo puoi analizzare il coinvolgimento degli utenti e altre metriche per le singole schermate o sezioni all'interno della tua SPA, ottenendo una comprensione più accurata del percorso dell'utente.