Este documento é destinado a desenvolvedores que querem medir as visualizações de página no aplicativo de página única usando o Google Analytics.
Os aplicativos de página única (SPA) são sites que carregam um documento HTML uma vez e buscam qualquer conteúdo adicional 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.
- Página da terceira tela para se inscrever em webinars relacionados aos interesses do cliente.
A chave para medir corretamente as visualizações de página de SPAs é contar as visualizações de cada tela com que um usuário interage e identificar o referrer da página corretamente, para que você possa rastrear corretamente a jornada do usuário.
Antes de começar
Nesta página, presume-se que você já:
Uma conta e propriedade do Google Analytics 4 para seu site. Saiba como configurar o Google Analytics.
Uma tag do Google implementada no seu site que é disparada quando a página é carregada inicialmente. Saiba como configurar a tag do Google.
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 SPA usar a API History, especificamente os métodos
pushState()
ereplaceState()
para atualizar telas, use essa opção.Eventos personalizados: se o site usa o objeto
DocumentFragment
para renderizar telas diferentes, escolha essa opção.