Código de acompanhamento: o objeto global _gat

A ga.js é uma biblioteca legada. Se você estiver iniciando uma nova implementação, recomendamos usar a versão mais recente dessa biblioteca, a analytics.js. Para implementações atuais, saiba como migrar da ga.js para a analytics.js.

O objeto global _gat é usado para criar e recuperar objetos do rastreador a partir dos quais todos os outros métodos são invocados. Portanto, os métodos dessa lista devem ser executados somente para objetos de acompanhamento criados com a variável global _gat. Todos os outros métodos precisam ser chamados usando o objeto global _gaq para o acompanhamento assíncrono.

Métodos dos objetos _gat

• _getTracker(account) descontinuado
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

Detalhes dos métodos

_getTracker()

_getTracker(account)

Esse método foi descontinuado. Use _gat._createTracker(opt_account, opt_name).

Cria um objeto de acompanhamento para o ID da propriedade da Web especificado. Se esse método for chamado mais de uma vez para o mesmo ID de conta do Google Analytics, um novo objeto será criado para cada invocação.

_gat._getTracker('UA-65432-1');

parâmetros

String account O ID da propriedade da Web completo (por exemplo, UA-65432-1) referente ao objeto do rastreador.

retorna

Tracker O objeto de acompanhamento criado.

---

_createTracker()

_createTracker(opt_account, opt_name)

Cria um novo objeto do rastreador e atribui o nome atribuído a ele. Se nenhum nome for dado, será gerado um nome. Os objetos de acompanhamento são armazenados com os próprios nomes para que possam ser recuperados por meio de _getTrackerByName. Se dois rastreadores forem criados com o mesmo nome, o segundo vai substituir o primeiro, e o primeiro não poderá mais ser recuperado por meio de _getTrackerByName.

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

parâmetros

String opt_account O ID da propriedade da Web completo (por exemplo, UA-XXXXX-X) referente ao objeto do rastreador.
String opt_name Nome opcional para armazenar o rastreador. Use esse nome para recuperar o rastreador por meio de _getTrackerByName.

retorna

Tracker O objeto de acompanhamento criado.

---

_getTrackerByName()

_getTrackerByName(opt_name)

Recupera o objeto do rastreador com o nome informado. Se nenhum nome for atribuído, o padrão será usado, que é a string vazia ("). Se não houver um rastreador com o nome informado, um novo rastreador será criado, atribuído a esse nome e retornado.

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

parâmetros

String opt_name Nome opcional do rastreador a ser recuperado. O padrão é a string vazia ('').

retorna

Tracker O objeto de acompanhamento recuperado ou criado.

---

_anonymizeIp()

_anonymizeIp()

Instrui o Google Analytics a mascarar as informações enviadas pelos objetos do rastreador removendo o último octeto do endereço IP antes do armazenamento dele. Isso reduzirá um pouco a precisão do relatório geográfico.

Ao usar essa função para mascarar o acompanhamento, você precisa usar a função push e associar corretamente a função ao objeto do rastreador, conforme ilustrado abaixo.

Snippet assíncrono (recomendado)

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

Snippet (ga.js) tradicional

<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");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

Configura o Google Analytics para enviar todos os hits usando SSL, mesmo de páginas não seguras (HTTP).

Snippet assíncrono (recomendado)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

Snippet (ga.js) tradicional

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();