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:
- 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)
- 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
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
eutmcc
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."
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âmetroutmp
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 de5(object*action*label)(value)
:- 5 é uma constante
- "object" e "action" são obrigatórios
- "label" e "value" são opcionais
- 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âmetroutmac
para a solicitação GIF.
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:
- 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 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.
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:
- 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âmetroutmcc
vazio, nenhum dado de cookie é enviado, e a solicitação é ignorada. - Repita o teste várias vezes para garantir que a solicitação GIF seja enviada sempre.
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
- 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 foi feita uma solicitação para
urchin.js
ouga.js
- 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.
- 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.
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.
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 |