Medir aplicativos de página única

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.

Antes de começar

Nesta página, presume-se que você já tenha:

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.

Implementação de alterações no histórico do navegador

Ativar a medição otimizada no GA4

Para medir page_views automaticamente com base no histórico de navegação:

  1. Abra o Google Analytics.

  2. Em Administrador, Coleta e modificação de dados: clique em Fluxos de dados > Web.

  3. Em Medição otimizada, deslize a chave para Ativado para habilitar todas as opções.

  4. Clique para editar opções individuais. Em Visualizações de página, clique em Exibir configurações avançadas. Ative as opções Carregamentos de página e Carregamento de página com base nos eventos do histórico de navegação.

    Uma imagem mostrando a configuração de visualizações de página

  5. Salve as alterações.

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:

  1. Ative o modo de depuração para todas as tags na configuração de medição de SPA. Saiba como Monitore eventos no DebugView.

  2. 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.