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 de domínio do cookie.
Se não houver um cookie para o domínio especificado, um ID do cliente será gerado e armazenado no cookie, e o usuário será identificado como novo. Se houver um cookie que contém um valor de Id do cliente, tal código 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 analytics.js, você pode criar rastreadores de várias maneiras, porém a mais comum é usar o comando create e transmitir os campos de ID de acompanhamento e domínio do cookie como o segundo e o terceiro parâmetros:
ga('create', 'UA-XXXXX-Y', 'auto');
Como nomear 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 "fields" opcional que permite definir qualquer um dos campos da 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 "fields" 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.