Sintaxe tradicional

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

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 de ga.js no seu site, você começará 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 site para que ele seja exibido na parte inferior da estrutura HTML (ou HTML gerado) da página, 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 vários subdiretórios, será necessário modificar o código de acompanhamento para ter dados de relatórios precisos para sua vista (perfil). Além disso, se estiver configurando uma vista (perfil) especificamente para um subdiretório de um domínio maior, você também precisará 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 1

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 — Parte dois

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 precisa sempre inicializar o objeto do rastreador de página. 
  • var pageTracker = _gat._getTracker("UA-123456-1");
    A primeira linha do snippet de código de acompanhamento padrão inicializa o objeto de acompanhamento padrão para o ID da propriedade da Web do Google Analytics fornecido como parâmetro. As chamadas de método subsequentes utilizam esse objeto.
  • As linhas finais do snippet de código de acompanhamento precisam 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 foi criado para ler dados da sua página após o carregamento do conteúdo da página. Por isso, o snippet precisa ficar localizado antes da tag de fechamento </body> da 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 inferior da página é mais eficaz do que usar uma função onLoad() para chamar o código de acompanhamento. Se você usar onLoad() para executar o código de acompanhamento, a execução vai depender do modelo de evento do navegador, e não do DOM. Nessa situação, se uma imagem remota não carregar em uma página, onLoad() não será chamado, enquanto o DOM da página ainda poderá ser carregado completamente.

Como 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 o mais básico) pode se beneficiar dos ajustes na configuração básica.Na verdade, se o site tiver qualquer uma das características a seguir, as modificações no código de acompanhamento serão necessárias para que o comportamento do visitante seja informado com precisão.

  • E-commerce: você tem um site de e-commerce ou carrinho de compras e quer acompanhar as atividades dos visitantes relacionadas a compras.
  • Vários domínios: a presença do 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 rastrear a atividade dos 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: você já tem links para o site com variáveis de acompanhamento de campanha personalizada 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
    Configure metas para as principais páginas do seu site que você espera que os usuários acessem.Normalmente, as metas são usadas em sites de e-commerce para observar estatísticas sobre como os clientes acessam a página de compra final em um conjunto de páginas relacionadas, como carrinho de compras, formulário de pedido e confirmação de 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 instruções ou um link "mais" em um blog. Para mais informações sobre metas, consulte Sobre metas.
  • Visualizações (perfis) e filtros
    Você pode configurar vistas (perfis) para usuários de relatórios individuais para 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 totalmente a vestuário e outra seção do site dedicada exclusivamente a eletrônicos e quer analisar as estatísticas da sua página de vestuário em relação a todas as roupas, mas independentemente de eletrônicos. Quando as vistas (perfis) são usadas para excluir determinadas seções de um site, elas restringem a denúncia de conteúdo somente a páginas permitidas. Acesse a Central de Ajuda para ver informações úteis sobre vistas (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. Lembre-se de que qualquer página do seu site deve 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 em Acompanhamento de comércio eletrônico. Além disso, a API Tracking fornece uma lista de todos os métodos de acompanhamento de ga.js que você pode usar, e também agrupa esses métodos por usos básicos de relatório, como ecommerce e acompanhamento de eventos.