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
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
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 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".
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â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 no formato5(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 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â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. 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.
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âmetroutmcc
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.
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
ouga.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.
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.
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 |