Em alguns casos, talvez você queira adicionar a analytics.js à sua página, mas a variável ga
já esteja sendo usada. Para essas situações, a analytics.js fornece um mecanismo de renomeação do objeto ga
global.
Renomear o objeto global
Com a tag do Google Analytics, você pode renomear o objeto ga
global mudando o parâmetro final enviado à função reduzida. Também será preciso atualizar todas as invocações da fila de comandos do ga()
para o nome que quiser.
Por exemplo, se você quiser renomear o objeto ga
como analytics
, altere a tag 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
O processo de renomeação do objeto global funciona porque, quando a analytics.js é carregada, ela 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.
Por exemplo, se você usar o método $.getScript
do jQuery para carregar a analytics.js, poderá renomear o objeto global com o seguinte código:
<script> // Instructs analytics.js to use the name `analytics`. window.GoogleAnalyticsObject = 'analytics'; // Use jQuery to load analytics.js. $.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>
Tag assíncrona alternativa
Diferentemente da tag padrão do Google Analytics, a tag assíncrona alternativa não permite renomear o objeto ga
global.
No entanto, usando a técnica descrita acima, você pode renomear o objeto ga
global e ainda desfrutar de todos os benefícios do pré-carregamento da tag assíncrona alternativa.
A seguinte versão modificada da tag assíncrona alternativa define a variável GoogleAnalyticsObject
como analytics
e renomeia também todas as instâ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 analytics object with automatic cookie domain configuration. analytics('create', 'UA-12345-1', 'auto'); // Sends a pageview hit from the analytics object 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 -->