Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento è rivolto agli sviluppatori che vogliono misurare le visualizzazioni di pagina nella loro applicazione a pagina singola utilizzando Google Analytics.
Le app a pagina singola (APS) sono siti web che caricano un documento HTML una volta e recuperano eventuali contenuti aggiuntivi utilizzando le API JavaScript.
Esempio: supponiamo che tu abbia un modulo per acquisire alcuni lead. Il modulo è composto da tre
schermate:
Prima schermata per acquisire i dati del cliente.
Seconda schermata in cui i clienti indicano il loro interesse per determinati servizi.
Terza pagina dello schermo per registrarsi ai webinar relativi agli interessi del cliente.
La chiave per misurare correttamente le visualizzazioni di pagina provenienti dalle SPA è conteggiarle 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.
Un tag Google implementato sul tuo sito web che si attiva 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 alla cronologia del browser (opzione consigliata): se la tua SPA utilizza l'API History, in particolare il metodo pushState() e replaceState() per aggiornare le schermate, utilizza questa opzione.
Eventi personalizzati: se il tuo sito web utilizza l'oggetto DocumentFragment per visualizzare schermate diverse, utilizza questa opzione.
Verificare la configurazione della misurazione
Per verificare che l'applicazione a pagina singola misuri correttamente le visualizzazioni di pagina:
Attiva la modalità di debug per ogni tag nella configurazione della misurazione della tua SPA. Scopri come monitorare gli eventi in DebugView.
Fai clic per navigare nell'applicazione a pagina singola. Quando fai clic su una nuova schermata virtuale, dovresti vedere 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 e la posizione della pagina sono stati aggiornati correttamente.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-04-29 UTC."],[[["\u003cp\u003eThis guide helps developers track page views within single-page applications using Google Analytics 4.\u003c/p\u003e\n"],["\u003cp\u003eAccurate tracking involves counting views for each screen a user interacts with and ensuring correct referral data for user journey analysis.\u003c/p\u003e\n"],["\u003cp\u003eImplementation relies on leveraging browser history changes or custom events to trigger virtual page views for different screens within the application.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you have a Google Analytics 4 account and a Google tag implemented on your website.\u003c/p\u003e\n"],["\u003cp\u003eVerification involves enabling debug mode and confirming that new \u003ccode\u003epage_view\u003c/code\u003e events are triggered with updated page referrer and location data upon screen transitions.\u003c/p\u003e\n"]]],["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"],null,[]]
