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. * Terza schermata pagina 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 della pagina 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 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 app 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 cronologia del browser Implementazione di eventi personalizzati

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.

Punto chiave: se configuri i tag utilizzando Google Tag Manager, non attivare il monitoraggio automatico della cronologia in GA4, in quanto ciò può comportare il doppio conteggio delle visualizzazioni di pagina. Consulta invece il tutorial Misurare le applicazioni a pagina singola con Google Tag Manager.

Attivare la misurazione avanzata in Google Analytics

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.

Verificare la configurazione della misurazione

Per verificare che la tua 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 sulla tua applicazione a una sola pagina. 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.

Considerazioni aggiuntive per le SPA

Oltre a inviare eventi page_view, prendi in considerazione questi aspetti aggiuntivi per un'integrazione SPA solida con Google Analytics e una migliore esperienza utente:

Gestire la posizione di scorrimento

Quando gli utenti navigano tra le visualizzazioni in una SPA, il browser in genere mantiene la posizione di scorrimento corrente. Ciò può significare che gli utenti non vedono la parte superiore della nuova pagina virtuale e può influire sul monitoraggio della profondità di scorrimento.

Consiglio:reimposta a livello di programmazione la posizione di scorrimento nella parte superiore della pagina o nel contenitore dei contenuti principali dopo ogni transizione di pagina virtuale.

// Example: Reset window scroll position on a route change in your SPA
window.scrollTo(0, 0);

// Or, if your content is within a specific element:
// document.getElementById('main-content').scrollTo(0, 0);

Con questa modifica, gli utenti inizieranno dalla parte superiore dei nuovi contenuti, il che consente al monitoraggio dello scorrimento di Google Analytics di misurare con precisione il coinvolgimento nella nuova pagina virtuale.

Garantire l'accessibilità dei contenuti per le funzionalità del browser

Se gli utenti segnalano problemi con le funzionalità del browser, ad esempio la ricerca nella pagina (Ctrl+F) che non funziona dopo il caricamento pagina virtuale, ciò potrebbe indicare il modo in cui la tua APS aggiorna il DOM.

Consiglio:assicurati che il framework SPA e la logica di routing aggiornino completamente e in modo sincrono le parti pertinenti del DOM con i contenuti della nuova pagina. Il rendering ritardato o i contenuti nascosti all'albero DOM principale potrebbero non essere indicizzabili immediatamente dalla funzione di ricerca del browser. Testa la ricerca sulla pagina dopo le navigazioni virtuali per verificare l'accessibilità dei contenuti.

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 dello schermo, 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 iniziale della pagina, rendendo impossibile analizzare il tempo trascorso su 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 a un'altra.
• La durata del coinvolgimento per la pagina virtuale precedente viene calcolata e inviata insieme all'evento user_engagement, in genere poco prima che venga elaborato l'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 singole schermate o sezioni all'interno della tua SPA, ottenendo una comprensione più accurata del percorso dell'utente.