Questo documento è rivolto agli sviluppatori che vogliono misurare le visualizzazioni di pagina sul loro
un'applicazione a pagina singola utilizzando Google Analytics.
Applicazioni a pagina singola
(APS) sono siti web che caricano un documento HTML una volta e recuperano altri
utilizzando le API JavaScript.
Esempio: supponiamo di avere un modulo per acquisire alcuni lead. Il modulo contiene tre
schermate:
Prima schermata per acquisire i dati del cliente.
Seconda schermata in cui i clienti indicano il proprio interesse per determinati servizi.
Pagina terza schermata per iscriversi ai webinar relativi agli interessi del cliente.
Per misurare correttamente le visualizzazioni di pagina provenienti dalle APS, è fondamentale conteggiare le visualizzazioni di pagina per
ogni schermata con cui un utente interagisce e che recupera il referrer di pagina corretto, per permetterti di fare correttamente riferimento
per tracciare il percorso dell'utente.
Prima di iniziare
In questa pagina si presuppone che tu abbia già:
Un account e una proprietà Google Analytics 4 per il tuo sito web. Scopri come
Configurare Google
Analisi.
Un tag Google implementato sul tuo sito web che si attiva all'inizio della pagina
viene caricato automaticamente. Scopri come configurare il
del tag.
Implementa la misurazione delle applicazioni a pagina singola
Per implementare una misurazione accurata dello SPA, utilizza uno di questi metodi per attivare una nuova
visualizzazione di pagina virtuale:
Modifiche alla cronologia del browser (consigliato): se il tuo SPA utilizza la Cronologia
API, nello specifico
i metodi pushState() e replaceState() per aggiornare le schermate, usa questo
.
Eventi personalizzati: se il tuo sito web utilizza DocumentFragment
per eseguire il rendering di diverse schermate, utilizza questa opzione.
Verifica la configurazione della misurazione
Per verificare che la tua applicazione a pagina singola misuri correttamente le visualizzazioni di pagina:
Attiva la modalità di debug per ogni tag nella configurazione della misurazione SPA. Scopri come
Monitora gli eventi in
DebugView.
Fai clic sull'applicazione a pagina singola. Quando fai clic su una nuova
nella schermata iniziale, dovresti vedere un nuovo evento page_view in DebugView. Confronta
page_view parametro evento con l'evento page_view precedente da verificare
se il referrer della pagina e la posizione della pagina sono stati aggiornati correttamente.
[null,null,["Ultimo aggiornamento 2024-08-22 UTC."],[[["This guide helps developers track page views within single-page applications using Google Analytics 4."],["Accurate tracking involves counting views for each screen a user interacts with and ensuring correct referral data for user journey analysis."],["Implementation relies on leveraging browser history changes or custom events to trigger virtual page views for different screens within the application."],["Before starting, ensure you have a Google Analytics 4 account and a Google tag implemented on your website."],["Verification involves enabling debug mode and confirming that new `page_view` events are triggered with updated page referrer and location data upon screen transitions."]]],["Developers using Google Analytics to measure page views on single-page applications (SPAs) should count page views for each user-interacted screen and accurately track the page referrer. To implement this, they can trigger virtual page views via browser history changes using the History API's `pushState()` and `replaceState()` methods, or through custom events with the `DocumentFragment` object. After implementation, debug mode should be enabled to verify new `page_view` events for each virtual screen, ensuring referrer and location data updates correctly.\n"]]