As propriedades padrão do Universal Analytics (UA) pararam de processar dados em 1o de julho de 2023. As propriedades do UA 360 vão deixar de processar dados em 1o de julho de 2024, e alguns recursos do UA 360 vão ser descontinuados antes disso, à medida que migrarmos para o Google Analytics 4. Adicione o Google Analytics 4 à sua implementação atual.

Esta página foi traduzida pela API Cloud Translation.

Solução de problemas do código de acompanhamento

Para resolver problemas com o acompanhamento do Google Analytics, primeiro verifique se sua configuração básica está correta, conforme descrito na Central de Ajuda em Verificação da sua configuração.

A solução de problemas do acompanhamento do Google Analytics se concentra em dois tópicos importantes:

Erros/erros de digitação na sintaxe do código de acompanhamento (por exemplo, espaços, personalizações digitadas incorretamente, nomes de parâmetro incorretos)
Dados ausentes nos seus relatórios

O restante deste documento aborda como você pode usar ferramentas de solução de problemas para ajudar a identificar e corrigir esses dois problemas básicos.

Erros comuns de código de acompanhamento

Esteja você usando a sintaxe assíncrona ou a tradicional, lembre-se das informações a seguir para evitar os erros mais comuns ao personalizar ou ajustar o código de acompanhamento. Para saber como verificar facilmente esses erros, consulte Depuração com ga_debug.js.

Nomes de métodos usam letras maiúsculas e minúsculas incorretamente.
Lembre-se de que os métodos diferenciam maiúsculas de minúsculas. Se você usar um nome de método sem a capitalização adequada, as chamadas do método não funcionarão. Exemplos:
```
  _gaq.push(['_trackpageview']);   // wrong
  _gaq.push(['_trackPageView']);   // wrong
  _gaq.push(['_trackPageview']);   // correct
```
Nomes de métodos incorretos.
Se o acompanhamento não estiver funcionando corretamente, verifique se você está usando o nome correto do método. Exemplos:
```
  _gaq.push(['_setDomain', 'example.com']);       // wrong
  _gaq.push(['_setDomainName', 'example.com']);   // correct
```
Passar um valor que não seja uma string usando aspas.
Somente strings devem ser passadas entre aspas. Todos os outros tipos devem ser deixados se m aspas.
Qualquer valor que não seja uma string, como booleanos, literais de objeto, funções ou matrizes, precisam ser transmitidos sem aspas. Use aspas apenas quando estiver passando algo que deva ser interpretado como uma string. Se você estiver migrando da sintaxe tradicional, qualquer parâmetro de função que tenha sido transmitido sem aspas deverá permanecer sem aspas na sintaxe assíncrona. Exemplos:
```
  _gaq.push(['_setAllowLinker', 'false']);    // wrong
  _gaq.push(['_setAllowLinker', false]);      // correct
```

As strings contêm espaços em branco no início ou no fim.
Exemplos:

  _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
  _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

Voltar ao início

Problemas comuns de dados do relatório

Se faltarem dados nos seus relatórios, leia esta seção para ajudar a identificar os erros mais comuns e as ações recomendadas.

Alteração ou configuração não detectada do código de acompanhamento

Ao instalar o código de acompanhamento pela primeira vez em uma página ou adicionar outra funcionalidade de código (como no caso de comércio eletrônico), você pode verificar facilmente se a solicitação da página está configurada corretamente. Para isso, observe os seguintes elementos:

A página solicita o JavaScript ga.js.
A página solicita __utm.gif.
As variáveis utmac e utmcc estão sendo enviadas na solicitação __utm.gif
Todos os parâmetros de acompanhamento relevantes estão disponíveis para dados adicionais que você espera que sejam enviados. Consulte a lista de parâmetros da solicitação GIF abaixo.

Se todos esses elementos estiverem sendo enviados corretamente, os dados deverão aparecer nos seus relatórios em até 24 horas. No entanto, você também pode conferir se os dados aparecem antes. Basta alterar o período nos seus relatórios para "hoje".

Voltar ao início

Página ou evento não aparece nos relatórios

Se uma página que contém o código de acompanhamento não aparece nos Relatórios de conteúdo", verifique o seguinte:

Você está procurando a página correta?

O Google Analytics usa o valor do parâmetro utmp como a página solicitada. Portanto, se o URL da sua página for /test/myPage.html, verifique se você está procurando myPage.html nos relatórios de conteúdo. Verifique o valor do parâmetro utmp para ver qual solicitação de página está sendo enviada.

Você está procurando o evento correto?

O Google Analytics usa o valor do parâmetro utme para acompanhar eventos no formato 5(object*action*label)(value):

5 é uma constante
"object" e "action" são obrigatórios
"label" e "value" são opcionais

Para mais informações, consulte a documentação Rastreamento de eventos.

Você monitora mais de 50.000 URLs exclusivos ou páginas virtuais por dia?

O Google Analytics coleta tudo o que é enviado de um site e gera relatórios sobre as 50 mil principais páginas (classificadas por visualizações de página) por dia. Todas as páginas restantes são agregadas em uma seção separada denominada (other) nos relatórios de conteúdo. Para ver informações detalhadas dos relatórios de exibições de página com tráfego mais baixo, configure uma nova vista da propriedade (perfil) com um filtro para remover todas as exibições de página com tráfego mais alto, o que permite que as páginas restantes sejam incluídas nos 50.000 URLs principais.

Verifique se você está acessando a conta e a vista da propriedade (perfil) corretas na interface do usuário de relatórios.

O Google Analytics distingue contas diferentes de acordo com os IDs de domínio, que estão no formato UA-123456-1. Esse ID de domínio é inserido no código de acompanhamento, que é o modo como os dados de uma página são associados a uma determinada conta. Verifique se a conta e a vista da propriedade (perfil) que você está visualizando (Configurações do Google Analytics -> editar -> verificar status) têm o mesmo ID de domínio enviado no parâmetro utmac para a solicitação GIF.

Voltar ao início

Problemas de acompanhamento de campanha

Para que uma campanha de publicidade seja acompanhada no Google Analytics, os parâmetros de acompanhamento precisam ser adicionados aos links de publicidade para seu website. O código GATC usa então uma combinação de URL de página e parâmetros de referência para identificar a campanha enviada. Em seguida, essas informações são armazenadas no cookie do seu site e enviadas no parâmetro utmcc da solicitação GIF. Em muitos casos, redirecionamentos de URL de website removem os parâmetros de acompanhamento ou os dados de referência desses links. Isso acarreta relatórios de campanha incorretos.

Para testar se os redirecionamentos estão causando problemas no acompanhamento da campanha, clique em um link de referência ou marcado que direciona para seu site e procure os dados corretos da campanha no parâmetro utmcc. Para saber mais sobre como encontrar e ler o parâmetro utmcc, consulte Parâmetros da solicitação GIF e Depuração com ga_debug.js.

Atribuição de meta (conversão) incorreta

Uma conversão é uma meta que está associada a uma campanha específica. Para ter certeza de que uma meta foi corretamente associada a uma determinada campanha ou referência, você pode:

Clicar em uma referência ao seu site: isso define os cookies da campanha.
Clicar no site até a página de conversão ou de meta.
Verifique os dados enviados no parâmetro utmcc para garantir que o cookie da campanha seja mantido.

Depois que o código de acompanhamento captura todas as informações da campanha, ele é armazenado em um cookie que é mantido com o usuário durante várias sessões. Para cada página que executa as funções de acompanhamento, as informações da campanha são enviadas na solicitação GIF. Assim, cada visualização de página tem dados de campanha/referência associados a ela. Se uma dessas visualizações de página estiver configurada como uma meta, a campanha de visualização de página associada será associada à meta. Para saber mais sobre como encontrar e ler o parâmetro utmcc, consulte Parâmetros da solicitação GIF e Depuração com ga_debug.js.

Voltar ao início

Etapas básicas de depuração

Sempre que o código de acompanhamento do Google Analytics é executado, ele solicita uma imagem GIF de um único pixel dos servidores de coleta do Google Analytics chamada __utm.gif.Todos os parâmetros que o Google captura sobre uma solicitação de página específica estão anexados à string de solicitação da imagem, incluindo:

Informações de exibição de página do URL
Informações da campanha
Dados de comércio eletrônico
Propriedades do navegador
IDs de cliente

Os dados contidos na solicitação GIF correspondem exatamente aos dados enviados para os servidores do Google Analytics, que, em seguida, são processados e incluídos nos seus relatórios. Portanto, ao visualizar os dados enviados na solicitação __utm.gif, é possível determinar se o código de acompanhamento está funcionando e, o mais importante, se ele está enviando dados incorretos para seus relatórios.

Para depurar seu código de acompanhamento, siga estas etapas básicas:

Para usar uma ferramenta de depuração de terceiros com o objetivo de inspecionar a solicitação GIF para o Google Analytics, clique no link relevante no seu website.
Verifique se o código de acompanhamento não contém nenhum dos erros comuns do código de acompanhamento.
Verifique se o parâmetro utmp está presente.
Verifique se o parâmetro utmcc está presente e não está vazio.
No caso de um parâmetro utmcc vazio, os dados do cookie não são enviados, e a solicitação é ignorada.
Repita o teste várias vezes para garantir que a solicitação GIF seja enviada sempre.

Voltar ao início

Ferramentas de depuração

A solicitação GIF tem parâmetros de nome/valor anexados a seu URL. Em vez de tentar analisar essa string por completo, você pode usar uma ferramenta sem custo financeiro para exibir a solicitação GIF em um formato mais legível. A tabela a seguir lista várias ferramentas que podem ser usadas com os navegadores mais comuns.

Por conveniência, desenvolvemos o Depurador do código de acompanhamento do Google Analytics, que ajuda a resolver problemas no código de acompanhamento sem que você precise fazer alterações no código. Basta ativar essa extensão e você poderá verificar se há erros nas suas páginas em produção. Saiba mais sobre o ga_debug.js.

Navegador	Ferramenta
All	Chromebook Lite (link em inglês)
Chrome	Depurador do código de acompanhamento do Google Analytics Novo
Chrome	Ferramentas de desenvolvedor integradas (por exemplo, Recursos)
Firefox	Cabeçalhos HTTP Live
Firefox	Kit de lembretes
Firefox	Carlos
Internet Explorer	Vinculador
Internet Explorer	Carlos
Safari	Janela Activity integrada
Safari	Carlos

Depois de instalar e configurar a ferramenta, é possível abrir a página da Web em que você quer resolver problemas e ver a análise do GIF na ferramenta. Primeiro, verifique se a página em questão está realmente enviando uma solicitação __utm.gif. Se a solicitação estiver sendo exibida, isso significa que os servidores do Google Analytics estão coletando dados da página em questão. O restante desta seção fornece instruções básicas para usar o Live HTTP Header e o PWA, para que você tenha uma noção de como é fácil usar ferramentas integradas ou complementos com o navegador da Web.

Uso do Live HTTP Headers

Faça o download do LiveHTTPHeaders para Firefox e instale-o. Reinicie o navegador.
Abra o Live HTTP Headers (Ferramentas > LiveHTTPHeaders).
Clique na guia Gerator.
Navegue até seu site (ou qualquer página que tenha o código de acompanhamento do Google Analytics instalado).
Verifique se uma solicitação é feita para urchin.js ou ga.js.
Verifique se é feita uma solicitação para __utm.gif.

Uso do Firebug

A extensão PWA apresenta uma visualização mais estruturada da solicitação de código de acompanhamento (urchin.js ou ga.js) e da solicitação GIF (__utm.gif). Essas etapas mostram como usar o RHEL para ver os detalhes da solicitação GIF.

Faça o download do Firebug para Firefox e instale-o. Reinicie seu navegador.
Navegue até seu site.
No Firefox, selecione Ferramentas> Firebug> Abrir o Firebug> Ativar o Firebug para este website.
Clique em Rede e em Imagens.
Atualize a página e verifique se uma nova solicitação para "__utm.gif" aparece na lista.
Verifique os componentes da solicitação na guia Parâmetros.

Voltar ao início

Depuração com ga_debug.js

Além do ga.js padrão, a equipe do Google Analytics implantou uma versão alternativa do JavaScript do Google Analytics chamada ga_debug.js. A finalidade desse script é ajudar os usuários do Google Analytics a resolver problemas nas instalações. Ele será especialmente útil se você estiver começando a usar o Google Analytics ou se estiver migrando seu site para a nova sintaxe assíncrona.

O script fornece detalhes sobre cada solicitação GIF e registrará mensagens de erro e de aviso quando detectar problemas no código de acompanhamento. Ele faz isso exibindo mensagens no objeto window.console. Você pode então usar uma das ferramentas a seguir para visualizar esses erros:

Firebug (para Firefox)
Ferramentas incorporadas para Chrome e/ou Safari
Firebug Lite (para outros navegadores)

Para usar o script ga_debug.js, você pode modificar a referência do código de acompanhamento para uma página da Web à qual tem acesso e que pode editar. Para isso, substitua todas as referências a /ga.js por /u/ga_debug.js no código de acompanhamento da página em questão. Se estiver usando o script de depuração para um site de grande escala, recomendamos que você faça isso apenas no seu ambiente de teste. Como alternativa, se você estiver depurando um site menor, recomendamos testar somente algumas páginas selecionadas, e não o site inteiro.

Importante: não modifique o site de produção para usar essa versão do JavaScript. O script ga_debug.js é maior do que o código de acompanhamento ga.js e normalmente não é armazenado em cache. Por isso, o uso dele em todo o site de produção vai deixar o site mais lento para todos os usuários. Novamente, isso deve ser usado apenas para testes.

Se você usa o Universal Analytics (analytics.js) para acompanhar seus sites, pode ativar a analytics_debug.js, a versão de depuração do analytics.js, para resolver problemas do código de acompanhamento. Para mais informações sobre analytics_debug.js, consulte Depuração.

Uso do depurador do código de acompanhamento do Google Analytics

O Depurador do código de acompanhamento do Google Analytics é uma extensão do navegador Chrome que ativa o ga_debug.js sem que você precise fazer mudanças na codificação. Provavelmente, a maneira mais simples de usar o ga_debug.js é para resolver problemas e analisar o comportamento de acompanhamento do seu site. Basta ativar essa extensão para verificar se há erros nas suas páginas de produção sem precisar modificar as referências de acompanhamento no próprio código.

Para usar essa extensão, clique no ícone dela à direita da barra de endereço para ativá-la. Em seguida, abra o console do Chrome JavaScript para ver mensagens.

No Windows e no Linux, clique em [Ícone da página] -> Desenvolvedor -> Console Javascript ou pressione Control-Shift-J.
No Mac, clique em Visualizar -> Desenvolvedor -> Console Javascript ou pressione Command-Option-J.

Voltar ao início

Parâmetros da solicitação GIF

A solicitação GIF é muito longa. Veja um exemplo de apenas parte de uma solicitação GIF:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...

Esta tabela contém uma lista dos muitos parâmetros passados por meio da solicitação GIF. Nem todos os parâmetros são passados em cada execução do código de acompanhamento, pois alguns se aplicam somente a determinadas condições, como referências de campanha ou carrinhos de compras. Quando você usar essa referência, lembre-se de que estará procurando as variáveis que se aplicam com mais frequência à página/solicitação que está sendo investigada.

Variável	Descrição	Exemplo de valor
utmac	String da conta. Aparece em todas as solicitações.	utmac=UA-2202604-2
utmcc	Valores dos cookies. Este parâmetro de solicitação envia todos os cookies solicitados da página.	utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(referral)%7C%cmd%cmd%referralDissue3D(referral)%7C%cmd%cmd%referralDissue
utmcn	Inicia uma nova sessão de campanha. Em toda solicitação, a variável "utmcn" ou "utmcr" está presente. Altera os dados de acompanhamento da campanha, mas não inicia uma nova sessão	utmcn=1
utmcr	Indica uma visita de campanha repetida. Isso é definido quando ocorrem cliques subsequentes no mesmo link. Em toda solicitação, a variável "utmcn" ou "utmcr" está presente.	utmcr=1
UTM	Codificação de linguagem para o navegador. Alguns navegadores não definem essa opção. Nesse caso, ela é definida como "-"	utmcs=ISO-8859-1
UTM	Título da página, que é uma string codificada pelo URL.	utmdt=analytics%20page%20test
utme	Parâmetro extensível.	O valor é codificado. Ele é usado para eventos e variáveis personalizadas.
UTM	Versão do Flash.	utmfl=9,0%20r48&
UTM	Nome do host, que é uma string codificada pelo URL.	utmhn=x343.gmodules.com
utmhid	Número aleatório usado para vincular solicitações GIF do Google Analytics ao Google AdSense.	utmhid=2059107202
UTM	Código do produto. Trata-se do código SKU de um determinado produto.	utmipc=989898ajssi
UTM	Nome do produto, que é uma string codificada pelo URL.	utmipn=tee%20camiseta
utmipr	Preço unitário. Definido no nível do item. O valor é definido apenas com números e no formato da moeda dos Estados Unidos.	utmipr=17.100,32
UTM	Quantidade.	utmiqt=4
utmiva	Variações de um item. Por exemplo: large, medium, small, pink, white, black, green. A string é codificada pelo URL.	utmiva=red;
UTM	Indica se o navegador está ativado para Java. 1 é verdadeiro.	utmje=1
UTM	ID exclusivo gerado para cada solicitação GIF para impedir o armazenamento no cache da imagem GIF.	utmn=1142651215
UTM	Solicitação de página da página atual.	utmp=/testDirectory/myPage.html
UTM	Referência, URL completo.	utmr=http://www.example.com/aboutUs/index.php?var=selected
UTM	Profundidade de cor da tela.	utmsc=24 bits
UTM	Resolução da tela.	utmsr=2.400 x 1.920
UTM	Indica o tipo de solicitação, que pode ser: event, transaction, item ou custom variable. Se esse valor não estiver presente na solicitação GIF, a solicitação será classificada como page.	utmt=event
utmtci	Cidade de faturamento.	utmtci=San%20Diego
utmtco	País de faturamento.	utmtco=United%20Kingdom
utmtid	ID do pedido, string codificada pelo URL.	utmtid=a2343898
UTM	Região de faturamento, string codificada pelo URL.	utmtrg=New%20Brunswick
UTM	Custo de envio. Valores para unidade e preço.	utmtsp=23.95
UTM	Afiliação. Geralmente usado para aplicativos de lojas físicas em comércio eletrônico.	utmtst=google%20mtv%20store
UTM	Total. Valores para unidade e preço.	utmtto=334.56
utmttx	Imposto. Valores para unidade e preço.	utmttx=29.16
UTM	Linguagem do navegador.	utmul=pt-br
UTM	Versão do código de acompanhamento.	utmwv=1

Voltar ao início