Este documento é para desenvolvedores que querem medir as visualizações de página nos seus
aplicativo de página única usando o Google Analytics.
Aplicativos de página única
(SPA) são sites que carregam um documento HTML uma vez e buscam
conteúdo usando APIs JavaScript.
Exemplo: suponha que você tenha um formulário para adquirir alguns leads. O formulário tem três
telas:
Primeira tela para capturar as informações do cliente.
Segunda tela em que os clientes indicam interesse em determinados serviços.
Terceira página da tela para inscrição em webinars relacionados aos interesses do cliente.
A chave para medir corretamente as visualizações de página dos SPAs é contar as visualizações de página dos
cada tela com a qual um usuário interage e acerta o referenciador da página. Assim, você pode
acompanhar a jornada do usuário.
Uma tag do Google implementada no seu site que é disparada quando a página é exibida
carrega. Saiba como configurar o Google
tag.
Implementar a medição de aplicativos de página única
Para implementar uma medição precisa de SPA, use um destes métodos para acionar uma nova
visualização de página virtual:
Alterações no histórico do navegador (recomendado): se o seu SPA usa o campo Histórico
API, especificamente
pushState() e replaceState() para atualizar telas, use este
é a melhor opção.
Eventos personalizados: se o site usa o DocumentFragment
para renderizar telas diferentes, use esta opção.
Verificar a configuração de medição
Para verificar se o aplicativo de uma única página mede as visualizações de página corretamente:
Ative o modo de depuração para todas as tags na configuração de medição de SPA. Saiba como
Monitore eventos no
DebugView.
Clique no seu aplicativo de página única. Quando você clica em uma nova
vai aparecer um novo evento page_view no DebugView. Compare os
Parâmetros de evento page_view com o evento page_view anterior a ser verificado
se o referenciador e o local da página tiverem sido atualizados corretamente.
[null,null,["Última atualização 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"]]
