Criação de rastreadores

Os objetos de acompanhamento (também conhecidos como "rastreadores") são objetos que podem coletar e armazenar dados e, depois, enviá-los ao Google Analytics.

Ao criar um novo rastreador, é necessário especificar um ID de acompanhamento (que é igual ao ID da propriedade correspondente a uma das suas propriedades do Google Analytics), bem como um domínio de cookie, que especifica como os cookies são armazenados. O valor recomendado 'auto' especifica a configuração automática do domínio do cookie.

Se não houver um cookie para o domínio especificado, um Client-ID será gerado e armazenado no cookie, e o usuário será identificado como novo. Se houver um cookie que contém um valor de Client-ID, tal ID será definido no rastreador, e o usuário será identificado como recorrente.

Assim que são criados, os objetos de acompanhamento também coletam informações sobre o contexto de navegação atual, como o título da página e o URL, além de informações sobre o dispositivo, como a resolução de tela, o tamanho do ponto de visualização e a codificação do documento. Ao enviar dados ao Google Analytics, todas as informações atualmente armazenadas no rastreador são enviadas.

Método "create"

Com a biblioteca do analytics.js, você pode criar rastreadores de diversas maneiras, mas a mais comum é usar o comando create e transmitir os campos ID de acompanhamento e domínio do cookie como o segundo e o terceiro parâmetros:

ga('create', 'UA-XXXXX-Y', 'auto');

Nomenclatura de rastreadores

Você também pode atribuir um nome ao rastreador. Para isso, transmita o campo name como o quarto argumento no comando create. É necessário atribuir um nome a um rastreador em casos nos quais você precisa criar mais de um rastreador para a mesma página. Para mais detalhes sobre os motivos pelos quais você precisará fazer isso, consulte a seção abaixo sobre o uso de vários rastreadores.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker');

A criação de um rastreador sem definir o campo name é um processo conhecido como criação de um rastreador "padrão". Um rastreador padrão recebe o nome "t0" internamente.

Especificação de campos no momento da criação

Também é possível transmitir um objeto "campos" opcional que permite definir qualquer um dos campos de analytics.js no momento da criação. Desse modo, eles serão armazenados no rastreador e aplicáveis a todos os hits enviados.

ga('create', 'UA-XXXXX-Y', 'auto', 'myTracker', {
  userId: '12345'
});

Além disso, assim como acontece com todas as chamadas para a função ga(), o objeto "campos" também pode ser usado para especificar todos os campos juntos:

ga('create', {
  trackingId: 'UA-XXXXX-Y',
  cookieDomain: 'auto',
  name: 'myTracker',
  userId: '12345'
});

Consulte a referência do método create para ver detalhes mais abrangentes.

Uso de vários rastreadores

Em alguns casos, convém enviar dados para várias propriedades a partir de uma única página. Isso é útil para sites cujas seções são supervisionadas por vários proprietários. Cada proprietário poderia visualizar sua propriedade específica.

Para acompanhar dados de duas propriedades diferentes, é necessário criar dois rastreadores diferentes, e pelo menos um deles precisa ser um rastreador nomeado. Os dois comandos a seguir criam um rastreador padrão e um rastreador chamado "clientTracker":

ga('create', 'UA-XXXXX-Y', 'auto');
ga('create', 'UA-XXXXX-Z', 'auto', 'clientTracker');

Execução de comandos para rastreadores específicos

Para executar comandos de analytics.js para um rastreador específico, acrescente um prefixo ao nome do comando com o nome do rastreador seguido por um ponto. Quando você não especifica o nome de um rastreador, o comando é executado no rastreador padrão.

Para enviar exibições de páginas para os dois rastreadores acima, execute os dois comandos a seguir:

ga('send', 'pageview');
ga('clientTracker.send', 'pageview');

Os guias futuros entrarão em mais detalhes sobre a sintaxe dos comandos específicos em execução. Você também pode consultar a referência da fila de comandos para ver a sintaxe completa de todos os comandos do analytics.js.

Próximas etapas

Depois que você criar um rastreador, precisará acessar os dados armazenados nesse objeto de acompanhamento. O próximo guia explica como acessar e definir dados do rastreador.