Renomear o objeto ga

Em alguns casos, você deseja adicionar o analytics.js à sua página, mas a variável ga já está sendo usada para algo diferente. Para lidar com isso, o analytics.js fornece um mecanismo para renomear o objeto ga global.

Renomear o objeto global no snippet de acompanhamento

O snippet de acompanhamento JavaScript permite renomear o objeto ga global por meio da alteração do parâmetro final transmitido à função reduzida. Também será necessário atualizar todas as invocações da fila de comandos de ga() para o nome que você escolher.

Por exemplo, se você quiser renomear o objeto ga como analytics, altere o snippet de acompanhamento da seguinte forma:

<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','analytics');

analytics('create', 'UA-XXXXX-Y', 'auto');
analytics('send', 'pageview');
</script>
<!-- End Google Analytics -->

Como renomear manualmente o objeto global

Renomear o objeto global funciona porque analytics.js, quando carregada, procura uma string armazenada em uma variável global chamada GoogleAnalyticsObject. Se ela encontrar essa variável, usará o nome da string como o novo nome da fila de comandos global.

Se você carregar o analytics.js e não usar o snippet de acompanhamento, ainda poderá renomear o objeto global definindo o nome que deseja usar na variável GoogleAnalyticsObject antes de carregar a biblioteca do analytics.js.

Por exemplo, se você usa o método $.getScript da jQuery para carregar o analytics.js, pode renomear o objeto global com este código:

<script>
// Instructs analytics.js to use the name `analytics`.
window.GoogleAnalyticsObject = 'analytics';

// Uses jQuery to load analytics.js instead of the tracking snippet.
$.getScript('//www.google-analytics.com/analytics.js', function() {

  // Creates a tracker and sends a pageview using the renamed command queue.
  analytics('create', 'UA-12345-1', 'auto');
  analytics('send', 'pageview');
});
</script>

O snippet de acompanhamento assíncrono alternativo

Diferente do snippet de acompanhamento JavaScript padrão, o snippet de acompanhamento assíncrono alternativo não oferece suporte padrão para renomear o objeto ga global.

No entanto, se você usar a técnica descrita acima, poderá renomear o objeto ga global e ainda ter acesso a todas as vantagens do pré-carregamento do snippet de acompanhamento assíncrono alternativo.

A versão modificada do snippet de acompanhamento assíncrono alternativo a seguir define a variável GoogleAnalyticsObject como analytics e renomeia também todas as ocorrências de ga como analytics:

<!-- Google Analytics -->
<script>

// Instructs analytics.js to use the name `analytics`.
window.GoogleAnalyticsObject = 'analytics';

// Creates an initial analytics() function.
// The queued commands will be executed once analytics.js loads.
window.analytics = window.analytics || function() {
  (analytics.q = analytics.q || []).push(arguments)
};

// Sets the time (as an integer) this tag was executed.
// Used for timing hits.
analytics.l = +new Date;

// Creates a default tracker with automatic cookie domain configuration.
analytics('create', 'UA-12345-1', 'auto');

// Sends a pageview hit from the tracker just created.
analytics('send', 'pageview');
</script>

<!-- Sets the `async` attribute to load the script asynchronously. -->
<script async src='//www.google-analytics.com/analytics.js'></script>
<!-- End Google Analytics -->