Este guia ajuda você a confirmar se a tag do Google Analytics está instalada corretamente e enviando dados. Ele também mostra as etapas para diagnosticar problemas comuns caso você não esteja vendo os dados esperados.
Métodos de verificação imediata
Essas ferramentas ajudam você a verificar se a tag está sendo disparada assim que é configurada:
- DebugView do Google Analytics:ative o DebugView para ver eventos em tempo real enquanto interage com seu site ou app. Essa é a melhor maneira de confirmar se os eventos e parâmetros estão sendo enviados corretamente. Consulte Monitorar eventos no DebugView.
- Tag Assistant Companion:essa extensão do navegador ajuda a validar a implementação da tag do Google (gtag.js) em sites. Ela mostra quais
tags estão sendo disparadas e os dados que estão sendo transmitidos. Consulte Sobre o Assistente de tags.
- Ferramentas do navegador para desenvolvedores:
- Guia "Rede":abra as ferramentas para desenvolvedores do navegador (por exemplo, o Chrome
DevTools) e procure solicitações de rede para
google-analytics.com/g/collectenquanto navega pelo site. Essas solicitações devem ser disparadas em cada carregamento de página e para eventos. Um código de status200 OKindica uma transmissão bem-sucedida. - Guia "Console":verifique se há erros de JavaScript relacionados a
gtag.jsou ao código do seu site que possam impedir a execução da tag.
Verificar relatórios do Google Analytics
- Relatório de tempo real:os dados começam a aparecer no Relatório de tempo real alguns minutos depois que a tag é disparada corretamente. Você vai encontrar visualizações de página, eventos e usuários ativos.
- Relatórios padrão:a maioria dos dados nos relatórios padrão leva de 24 a 48 horas para ser totalmente processada e disponibilizada. Não se preocupe se você não encontrar dados completos imediatamente fora da exibição em tempo real e da DebugView.
Problemas comuns de configuração e como corrigi-los
- ID de métricas incorreto:verifique se o ID de métricas na chamada
gtag('config', 'G-XXXXXX')corresponde exatamente ao ID nas configurações do fluxo de dados da Web do Google Analytics. Erros de digitação no ID de métricas são um dos erros de configuração mais comuns e fáceis de cometer. Por isso, verifique com atenção. - A tag não está em todas as páginas:o snippet de tag do Google precisa estar na seção
<head>de todas as páginas que você quer rastrear. - Posicionamento incorreto da tag:a tag global do site (gtag.js) precisa ser colocada o mais alto possível no
<head>do seu HTML. - Problemas com o modo de consentimento:se você implementou o modo de consentimento, verifique se as tags não estão sendo bloqueadas indevidamente. As tags só serão disparadas depois que o usuário der o consentimento necessário. Use o Assistente de tags para depurar os estados de consentimento. Consulte Solução de problemas do modo de consentimento.
- Bloqueadores de anúncios e extensões de privacidade:algumas extensões do navegador podem impedir a execução de scripts do Google Analytics. Teste em uma janela anônima ou em um navegador diferente com as extensões desativadas.
- Filtros do Google Analytics:verifique se há filtros de dados ativos nas configurações da propriedade do Google Analytics (Administrador > Configurações de dados > Filtros de dados) que possam estar excluindo os dados que você procura.
- Armazenamento em cache:o armazenamento em cache do navegador ou do lado do servidor pode veicular versões mais antigas da página sem a tag. Limpe os caches depois de adicionar a tag.
O que esperar: dados iniciais
Quando os dados começarem a fluir, você vai ver:
- Eventos coletados automaticamente:
page_view,session_start,first_visiteuser_engagementsão coletados por padrão. - Dimensões básicas:nos relatórios, você vai começar a ver dados de dimensões como Caminho da página, Origem/mídia, Categoria do dispositivo, País etc.
Quanto tempo leva para os dados aparecerem?
- DebugView:os eventos aparecem em segundos.
- Relatórios de tempo real:os dados aparecem em minutos.
- Relatórios padrão:aguarde de 24 a 48 horas para o processamento e a geração de relatórios de dados completos.
Se você seguiu essas etapas e ainda não vê os dados, verifique novamente a implementação de tags e consulte a Central de Ajuda do Google Analytics.