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

Se você quiser resolver problemas com o acompanhamento do Google Analytics, primeiro verifique se a configuração básica está correta, conforme descrito na Central de Ajuda em Como verificar sua configuração.

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

  1. Erros/erros de digitação na sintaxe do código de acompanhamento (por exemplo, espaços em branco, personalizações grafadas incorretamente, nomes de parâmetros incorretos)
  2. Dados ausentes dos seus relatórios

No restante deste documento, explicamos como usar as ferramentas de solução de problemas para identificar e corrigir esses dois problemas básicos.

Erros comuns de código de acompanhamento

Ao usar a sintaxe assíncrona ou tradicional, lembre-se do seguinte para evitar os erros mais comuns ao personalizar ou ajustar o código de acompanhamento. Para saber como verificar esses erros facilmente, consulte Depurar com o ga_debug.js.

  • Os nomes dos métodos usam letras maiúsculas e minúsculas incorretas.
    Lembre-se de que os métodos diferenciam maiúsculas de minúsculas. Se você usar um nome de método sem o uso adequado de maiúsculas e minúsculas, 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étodo 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.
    Apenas strings são transmitidas entre aspas. Todos os outros tipos devem ser deixados se m aspas.
    Todos os valores que não são uma string, como booleanos, literais de objeto, funções ou matrizes, precisam ser transmitidos sem aspas. Use somente aspas ao transmitir algo que deve 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 à esquerda ou à direita.
    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 você não tiver 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 outras funcionalidades de código de acompanhamento (como de comércio eletrônico), você pode verificar facilmente se a solicitação de página está configurada corretamente verificando os seguintes elementos:

  • A página solicita o JavaScript ga.js.
  • A página solicita o __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 enviar (consulte a lista de parâmetros de solicitação GIF abaixo).

Se todos esses elementos estiverem sendo enviados corretamente, os dados devem aparecer nos seus relatórios no máximo em 24 horas. No entanto, você também pode verificar se os dados aparecem mais cedo alterando o período nos relatórios para "quot;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, procure 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 na forma de 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 de Eventos de acompanhamento.
  • Você monitora mais de 50.000 URLs exclusivos ou páginas virtuais por dia?
  • O Google Analytics coleta todos os dados enviados de um site e gera relatórios sobre as 50.000 páginas principais (classificadas por visualizações de página) por dia. Todas as páginas restantes são agregadas em uma seção separada com o rótulo (other) nos relatórios de conteúdo. Para ver informações de relatório detalhadas para visualizações de página de tráfego mais baixo, configure uma nova vista (perfil) com um filtro para remover todas as visualizações de página de 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 diferencia contas diferentes por IDs de domínio, que têm o 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 (perfil) que você está analisando (Configurações do Google Analytics -> editar -> verificar status) têm o mesmo ID do domínio que está sendo 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. 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 de rastreamento de campanha, clique em um link de referência ou de tag que aponta para seu site e procure os dados adequados da campanha no parâmetro utmcc. Para saber mais sobre como encontrar e ler o parâmetro utmcc, consulte Os parâmetros da solicitação GIF e Como depurar 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:

  1. Clicar em uma referência ao seu site: isso define os cookies da campanha.
  2. Clicar no site até a página de conversão ou de meta.
  3. 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 persiste com o usuário em 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. Portanto, cada visualização de página tem dados de campanhas/referências associados a elas. 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 Os parâmetros da solicitação GIF e Como depurar com ga_debug.js.

Voltar ao início

Etapas básicas de depuração

Cada vez que o código de acompanhamento do Google Analytics é executado, ele solicita uma imagem GIF de um pixel único dos servidores de coleta do Google Analytics, chamada __utm.gif.Anexados à string de solicitação da imagem estão todos os parâmetros que o Google captura sobre uma solicitação de página específica, 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 de GIF correspondem exatamente aos dados enviados aos servidores do Google Analytics, que são processados e processados nos seus relatórios. Dessa forma, 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 aos seus relatórios.

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

  1. 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.
  2. Verifique se o código de acompanhamento não contém nenhum dos erros comuns do código de acompanhamento.
  3. Verifique se o parâmetro utmp está presente.
  4. Verifique se o parâmetro utmcc está presente e não está vazio.
    No caso de um parâmetro utmcc vazio, nenhum dado de cookie é enviado, e a solicitação é ignorada.
  5. 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 você a solucionar problemas de código de acompanhamento sem que você precise alterar o código. Basta ativar essa extensão e verifique se há erros nas suas páginas de produção. Leia mais sobre ga_debug.js.

Navegador Ferramenta
Todos WebKit Lite
Google Chrome Depurador do código de acompanhamento do Google Analytics Novo
Chrome Ferramentas de desenvolvedor integradas (por exemplo, Recursos)
Firefox Cabeçalhos HTTP ativos
Firefox StreetView
Firefox Carlos
Internet Explorer Vitrine
Internet Explorer Carlos
Safari Janela Activity integrada
Safari Carlos

Depois de instalar e configurar a ferramenta, abra a página da Web com problemas e veja a análise de GIFs na ferramenta. Primeiro, confira se a página em questão está realmente enviando uma solicitação __utm.gif. Se você vir a solicitação, terá certeza de que os servidores do Google Analytics estão coletando dados dessa página. O restante desta seção fornece instruções básicas para o uso do Live HTTP Header e do WebKit, para que você tenha uma noção de como é fácil usar ferramentas integradas ou complementos com seu navegador da Web.

Uso do Live HTTP Headers

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

Uso do Firebug

A extensão PageSpeed 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 a PageSpeed para visualizar os detalhes da solicitação GIF.

  1. Faça o download do Firebug para Firefox e instale-o. Reinicie seu navegador.
  2. Navegue até seu site.
  3. No Firefox, selecione Ferramentas> Firebug> Abrir o Firebug> Ativar o Firebug para este website.
  4. Clique em Rede e em Imagens.
  5. Atualize a página e verifique se uma nova solicitação para "__utm.gif" aparece na lista.
  6. 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. O objetivo desse script é ajudar os usuários do Analytics a solucionar problemas nas instalações deles. Ela é útil principalmente 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 registra mensagens de aviso e de erro quando detecta problemas no código de acompanhamento. Isso é feito com a impressão de 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 de uma página da Web à qual tem acesso e que pode editar. Para fazer isso, substitua todas as referências a /ga.js por /u/ga_debug.js no código de acompanhamento dessa página. Recomendamos que, se você usar o script de depuração em um site de grande escala, use-o somente no seu ambiente de teste. Como alternativa, se você estiver depurando um site menor, recomendamos testar somente as páginas selecionadas em vez do site inteiro dessa maneira.

Importante: não modifique seu site de produção para usar essa versão do JavaScript. O script ga_debug.js é maior do que o código de acompanhamento de ga.js e normalmente não é armazenado em cache. Portanto, o uso dela em todo o site de produção deixa 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, é possível ativar analytics_debug.js, a versão de depuração de analytics.js, para resolver problemas do código de acompanhamento. Para ver 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 para você sem que você precise alterar o código. Provavelmente, a maneira mais simples de usar ga_debug.js é solucionar problemas e analisar o comportamento de rastreamento do site. Basta ativar essa extensão para verificar se há erros nas 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...   

Essa tabela contém uma lista com muitos dos parâmetros transmitidos pela solicitação de GIF. Nem todos os parâmetros são transmitidos com cada execução do código de acompanhamento, já que alguns se aplicam apenas 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%2D3C%2D3c%2D3C3
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
utmcs
Codificação de linguagem para o navegador. Alguns navegadores não definem essa configuração, nesse caso, ela é definida como "quot;-"
utmcs=ISO-8859-1
utmdt
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.
utmfl
Versão do Flash. utmfl=9,0%20r48&
utmhn

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
utmipc
Código do produto. Trata-se do código SKU de um determinado produto.

utmipc=989898ajssi
utmipn
Nome do produto, que é uma string codificada pelo URL. utmipn=camisetae
%
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=17100,32
utmiqt
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;
utmje
Indica se o navegador está ativado para Java. 1 é verdadeiro. utmj=1
milho
ID exclusivo gerado para cada solicitação GIF para impedir o armazenamento no cache da imagem GIF. utmn=1142651215
utmp
Solicitação de página da página atual. utmp=/testDirectory/myPage.html
REM
Referência, URL completo. utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc
Profundidade de cor da tela. utmsc=24 bits
utmsr
Resolução da tela. utmsr=2.400 x 1.920
noz
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á digitada 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
utmtrg
Região de faturamento, string codificada pelo URL. utmtrg=New%20Brunswick
utmtsp
Custo de envio. Valores para unidade e preço. utmtsp=23.95
utmtst
Afiliação. Geralmente usado para aplicativos de lojas físicas em comércio eletrônico. utmtst=google%20mtv%20store
utmtto
Total. Valores para unidade e preço. utmtto=334.56
utmtx
Imposto. Valores para unidade e preço. utmttx=29.16
utmul
Linguagem do navegador. utmul=pt-br
utmwv
Versão do código de acompanhamento. utmwv=1

 

Voltar ao início