Misura le applicazioni con una sola pagina

Questo documento è destinato agli sviluppatori che vogliono misurare le visualizzazioni di pagina nella loro 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 di avere un modulo per acquisire alcuni lead. Il modulo ha tre schermate:

• La 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 correlati agli interessi del cliente.

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

Prima di iniziare

Questa pagina presuppone che tu disponga già di:

• 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 si attiva quando la pagina viene caricata inizialmente. 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 alla 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'oggetto DocumentFragment per 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. Nella sezione Visualizzazioni di pagina, fai clic su Mostra impostazioni avanzate. Assicurati di abilitare 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 "Modifiche alla pagina in base agli eventi della cronologia del browser", Google Analytics rileva automaticamente gli eventi della cronologia (come quelli utilizzati nelle SPA) e invia eventi page_view. Non devi configurare variabili o attivatori di cronologia specifici in Google Tag Manager allo scopo di inviare visualizzazioni di pagina a GA4.

Utilizzare i trigger di Google Tag Manager per gli eventi della cronologia

Se devi attivare altri tipi di tag in Google Tag Manager in base alle modifiche alla 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 funzionare con il trigger 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 stato cronologia.
• History Old State: il vecchio oggetto di stato della cronologia.
• History Source: l'origine dell'evento della cronologia (ad esempio popstate, pushState, replaceState).

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

Per ulteriori dettagli su questo trigger, vedi Trigger 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 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 evento page_view con l'evento page_view precedente per verificare se il referrer 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 i cambi di schermata, Google Analytics considera la SPA come una singola pagina, il che comporta 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, rendendo impossibile analizzare il tempo trascorso sulle singole schermate.

Quando la misurazione delle visualizzazioni di pagina virtuali viene 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 pagina virtuale nuova.
• Altri eventi, come clic o scorrimenti, sono associati al page_location della pagina virtuale che l'utente sta visualizzando.

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 customer journey.