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 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 se inscrever em webinars relacionados aos interesses do cliente.
A chave para medir as visualizações de página de SPAs corretamente é contar as visualizações de página de cada tela com que um usuário interage e receber o referenciador da página correto 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 uma 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 pela primeira vez. 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 exibição virtual de página:
Mudanças no histórico do navegador (recomendado): se o SPA usar a API History, especificamente o método
pushState()ereplaceState()para atualizar telas, use essa opção.Eventos personalizados: se o site usa o objeto
DocumentFragmentpara renderizar telas diferentes, use essa opção.
Implementação de mudanças no histórico do navegador
Ativar a medição otimizada no GA4
Para medir page_views automaticamente com base no histórico do navegador:
Abra o Google Analytics.
Em Administrador, em Coleta e modificação de dados, clique em Fluxos de dados > Web.
Em Medição otimizada, deslize a chave para Ativado para habilitar todas as opções.
Clique para editar as opções individuais. Em Visualizações de página, clique em Mostrar configurações avançadas. Ative os carregamentos de página e as mudanças de página com base nos eventos do histórico de navegação.
Salve as alterações.