Sintaxe tradicional

Neste documento, descrevemos como configurar o acompanhamento do Google Analytics no seu site usando o snippet de código de acompanhamento tradicional ga.js. Se você estiver configurando o acompanhamento pela primeira vez, recomendamos usar o snippet de código de acompanhamento padrão, descrito em Acompanhamento de sites.

Há dois modos básicos de configurar o acompanhamento em sua propriedade de web: configuração padrão e configuração personalizada. Este documento aborda essas configurações e traz tópicos relacionados:

Depois de instalar corretamente o código de acompanhamento ga.js em seu site, você começa a receber dados de relatórios. Os dados aparecem em seus relatórios 24 horas após a configuração do código de acompanhamento.

Configuração padrão

Quando começar a implementar o acompanhamento no website do Google Analytics, você precisará instalar o código de acompanhamento nas páginas de seu website. O snippet do código de acompanhamento genérico tem duas partes: uma tag de script que faz referência ao código de acompanhamento ga.js e outro script que executa o código de acompanhamento. 

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
  var pageTracker = _gat._getTracker("UA-xxxxxx-x");
  pageTracker._trackPageview();
} catch(err) {}
</script>

Esse snippet de código de acompanhamento precisa ser incluído nas páginas do seu site para que apareça na parte de baixo da estrutura HTML (ou HTML gerado) antes da tag de fechamento <body>. Para mais informações, consulte a Visão geral funcional, que explica a lógica por trás da execução do código de acompanhamento.

Observação: se você estiver configurando o acompanhamento de uma propriedade da Web que abrange vários domínios ou subdiretórios, é necessário modificar o código de acompanhamento para receber dados de relatórios precisos para sua vista da propriedade (perfil). Além disso, se você estiver configurando uma vista da propriedade (perfil) especificamente para um subdiretório de um domínio maior, também deverá modificar o código de acompanhamento. Consulte o Guia de domínios e diretórios para mais informações.

Script do código de acompanhamento - Parte um

A primeira parte da tag de script (representada pelas linhas de um a quatro do código acima) utiliza Javascript para determinar dinamicamente se o protocolo HTTP da página solicitada é seguro ou padrão. Em seguida, ele usa o protocolo apropriado para fazer referência ao código de acompanhamento. Assim, se uma página de seu site for criada com base em um protocolo HTTP padrão, a string resultante será: 

<script src='http://www.google-analytics.com/ga.js' type='text/javascript'>

Se outra página for criada com base em uma conexão segura, a string resultante será:

<script src='https://ssl.google-analytics.com/ga.js' type='text/javascript'>

Caso tenha uma combinação de páginas seguras e não seguras, mantenha a tag de script inicial conforme indicado, de tal modo que seja possível determinar a conexão apropriada. Caso todas as páginas de seu site sejam criadas com base em HTTP padrão, você poderá substituir a primeira tag pela chamada mais simples do código de acompanhamento do Google Analytics.

Script do código de acompanhamento - Segunda parte

O segundo conjunto de tags de Javascript engloba os métodos necessários para executar a chamada de acompanhamento para os dados da páginas. Essa parte do código de acompanhamento também contém os métodos personalizados que devem ser aplicados a todas as páginas de seu site. Tanto a inicialização quanto os métodos são inseridos em um bloco "tente capturar", de tal modo que os erros de JavaScript são manipulados sem afetar o visitante.

A ordem das chamadas de método fornecidas no snippet de acompanhamento genérico é importante. Siga estas diretrizes gerais quando alterar o código de acompanhamento para seu website:

  • A primeira linha do script de acompanhamento deve sempre inicializar o objeto do rastreador da página. 
    • var pageTracker = _gat._getTracker("UA-123456-1");
    A primeira linha do snippet de código de acompanhamento padrão inicializa o objeto do rastreador padrão no ID da propriedade da Web do Google Analytics que você fornece como parâmetro. As chamadas de método subsequentes utilizam esse objeto.
  • As linhas finais do seu snippet de código de acompanhamento devem chamar o método _trackPageview().
    Todas as chamadas de método personalizadas que definem ou inicializam um valor precisam ser inseridas antes de _trackPageview().
    // put in customized calls after pageTracker object and before_trackPageview() methods
pageTracker.setAllowLinker(true);
pageTracker._trackPageview();

Onde inserir o código de acompanhamento?

O código de acompanhamento lê os dados da sua página depois que o conteúdo da página é carregado. Por esse motivo, o snippet precisa ser inserido antes da tag de fechamento </body> da sua página da Web. Após o carregamento do conteúdo de sua página, o código de acompanhamento (quando executado) lê o conteúdo da página de acordo com o DOM. A seguir, todas as informações pertinentes ao acompanhamento são usadas para estabelecer informações da página, definir/atualizar cookies e enviar a solicitação GIF aos servidores do Google Analytics.

Ao inserir o script no final do corpo da página, você pode assegurar a execução do código de acompanhamento como último elemento do DOM. Se o carregamento de uma página específica é interrompido por qualquer motivo, é possível que a solicitação GIF dessa visualização de página não seja executada. No entanto, se você inserir o código de acompanhamento na parte superior da página, as interrupções de carregamento podem levar à geração de relatórios incompletos ou imprecisos, pois o código de acompanhamento depende dos dados da página para gerar seus relatórios.

Além disso, o posicionamento físico da chamada do código de acompanhamento na parte de baixo da página é mais eficaz do que usar uma função onLoad() para chamar o código. Se você usar onLoad() para executar o código de acompanhamento, a execução vai depender do modelo de eventos do navegador, e não do DOM. Nesse caso, se uma imagem remota falhar ao carregar uma página, onLoad() não será chamado, mas o DOM da página ainda poderá ser carregado por completo.

Personalizar sua configuração

Você pode personalizar o Google Analytics de diversas maneiras a fim de modificar o modo de exibição dos dados de relatórios.A maioria dos sites (exceto os mais básicos) pode se beneficiar com ajustes na configuração básica.Na verdade, se o site tiver alguma das características a seguir, serão necessárias modificações no código de acompanhamento para que o comportamento dos visitantes seja informado de maneira precisa.

  • E-commerce: você tem um site de e-commerce ou um carrinho de compras e quer acompanhar as atividades de visitantes relacionadas às compras.
  • Vários domínios: a presença do seu site abrange vários nomes de host ou domínios, e você quer acompanhar a atividade dos visitantes (incluindo a atividade do carrinho de compras) nessas propriedades.
  • Carrinhos de compras de terceiros: seu site é hospedado por um provedor em um subdiretório, e você quer acompanhar a atividade de visitantes em uma parte do site (como um carrinho de compras) localizada em outro diretório do site do host.
  • Variáveis de acompanhamento de campanha personalizadas: se você já tem links para seu site com variáveis de acompanhamento de campanha personalizadas que gostaria de usar.

Além disso, você pode realizar outros ajustes no comportamento padrão de relatórios do Google Analytics, como ajustar a extensão da sessão de visitante, alterar a extensão da sessão de campanha ou desativar o conjunto de informações do navegador.

Você pode personalizar os relatórios em duas áreas básicas:

  • A interface administrativa dos relatórios do Google Analytics
  • O uso de métodos adicionais do código de acompanhamento em suas páginas da web

Personalização usando a interface administrativa

A interface administrativa proporciona os seguintes recursos, que podem ser utilizados para refinar a exibição de dados nos relatórios:

  • Metas
    Defina metas para as páginas principais do seu site que você espera que os usuários acessem.Normalmente, as metas são usadas em sites de e-commerce para analisar estatísticas de como os clientes chegam à página final de compra em um conjunto de páginas relacionadas, como carrinho de compras, formulário de pedido e confirmação do pedido.No entanto, você também pode usar as metas para qualquer outro cenário, como um guia passo a passo sobre um processo de como fazer ou um link "mais" em um blog. Para mais informações sobre metas, consulte Sobre metas.
  • Vistas (perfis) e filtros
    Você pode configurar vistas da propriedade (perfis) para usuários de relatórios individuais a fim de incluir ou excluir determinados conteúdos desses relatórios. Isso é útil quando você tem um website muito grande e deseja determinar as estatísticas da páginas para uma seção do site independentemente da outra.Por exemplo, você pode ter uma seção de um site dedicada inteiramente a roupas e outra seção inteiramente dedicada a eletrônicos, e você quer analisar as estatísticas da página de roupas em relação a todas as roupas, mas independentemente dos eletrônicos. Quando vistas da propriedade (perfis) são usadas para excluir determinadas seções de um website, elas restringem os relatórios de conteúdo somente para as páginas permitidas. Consulte a Central de Ajuda para informações úteis sobre vistas da propriedade (perfis) e filtros.

Personalização com métodos adicionais do código de acompanhamento

O GATC proporciona diversos métodos de configuração do código de acompanhamento para seu site. Qualquer página do seu site precisa usar o código de acompanhamento urchin.js ou o código de acompanhamento ga.js e os métodos relacionados, mas não ambos. 

A utilização dos dois códigos de acompanhamento em uma única página não é aconselhada, pois pode gerar erros nos relatórios dessas páginas. 

Alguns dos cenários mais comuns que exigem a configuração do código de acompanhamento são descritos no artigo Acompanhamento de comércio eletrônico. Além disso, a API Tracking fornece uma lista de todos os métodos de acompanhamento ga.js que você pode usar e os agrupa por usos básicos de relatórios, como métodos de comércio eletrônico e de acompanhamento de eventos.