Código de acompanhamento: o objeto global "_gaq"

O objeto global _gaq pode ser usado diretamente para o acompanhamento assíncrono de páginas pelo método push(...). Ele também tem métodos para criar objetos de acompanhamento, mas esses objetos devem ser usados somente em casos raros.

Para o acompanhamento de páginas tradicional, use o objeto global _gat.

Métodos do objeto _gaq

Detalhes dos métodos

_createAsyncTracker()

    _createAsyncTracker(accountId, opt_name)
    Cria um objeto de acompanhamento que pode ser chamado pelo nome ao fazer chamadas de acompanhamento assíncrono. Se nenhum nome for atribuído, será a string vazia '', que representa o rastreador padrão na sintaxe assíncrona. Se já houver um acompanhamento assíncrono para esse nome, ele será substituído pelo novo rastreador.

    Observação: geralmente, esse método só é seguro para uso dentro de uma função que foi enviada para _gaq. Use-o apenas em casos raros. 
    _gaq._createAsyncTracker('UA-65432-1');

    parâmetros

      String accountId O ID completo da propriedade da Web (por exemplo, UA-65432-1) do objeto do rastreador.
      String opt_name O nome a ser usado para armazenar o objeto do rastreador. Use esse nome para se referir ao objeto de acompanhamento em chamadas de acompanhamento assíncrono posteriormente.

    retorna

      Tracker O objeto de acompanhamento criado.

_getAsyncTracker()

    _getAsyncTracker(opt_name)
    Retorna o objeto de acompanhamento criado anteriormente com o nome informado. Se nenhum nome for atribuído, o nome do rastreador padrão (a string vazia '') será usado. Se não houver um objeto de acompanhamento com esse nome, um novo acompanhamento será criado, atribuído a esse nome e retornado.

    Observação: geralmente, esse método só é seguro para uso dentro de uma função que foi enviada para _gaq. Use-o apenas em casos raros. 
    _gaq._getAsyncTracker();

    parâmetros

      String opt_name O nome do objeto do rastreador a ser recuperado.

    retorna

      Tracker O objeto de acompanhamento recuperado ou criado.

push

    push(commandArray)
    Executa o command array especificado, que é simplesmente uma matriz JavaScript em conformidade com o formato a seguir. O primeiro elemento da matriz precisa ser o nome de um método de objeto de acompanhamento transmitido como uma string. O restante dos elementos da matriz são os valores a serem transmitidos como argumentos para a função.

    O uso a seguir é normal:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Essa função é chamada de push para que uma matriz possa ser usada no lugar de _gaq antes que o Google Analytics seja completamente carregado. Enquanto o Google Analytics estiver sendo carregado, os comandos serão enviados/enfileirados na matriz. Quando o Google Analytics termina de carregar, ele substitui a matriz pelo objeto _gaq e executa todos os comandos na fila. As chamadas seguintes para _gaq.push são resolvidas para essa função, que executa comandos à medida que eles são enviados.

    Os rastreadores podem ser nomeados com o nome do rastreador (com um ponto) antes do nome do método. Se o nome de uma função for qualificado com o nome de um rastreador, ele será executado nesse rastreador.

    O exemplo a seguir cria e usa um rastreador chamado arbitrariamente myTracker.
    var _gaq = _gaq || [];
_gaq.push(['myTracker._setAccount', 'UA-65432-2']);
_gaq.push(['myTracker._setDomainName', 'foo.com']);
_gaq.push(['myTracker._trackPageview']);

    Observação:os rastreadores são criados na primeira vez que um comando os referencia. O rastreador padrão é criado por meio do primeiro comando que não nomeia explicitamente o rastreador. O nome do rastreador padrão é a string vazia ''.

    Além de enviar matrizes de comandos, também é possível enviar objetos de função. Isso pode ser especialmente útil para métodos de acompanhamento que retornam valores. Essas funções podem fazer referência a _gat e _gaq.
    var _gaq = _gaq || [];
_gaq.push(function() {
  var tracker = _gat._getTracker('UA-65432-1');
  tracker._trackPageview();
});

    Também é possível usar a sintaxe de push diretamente no HTML da sua página.
    onclick="_gaq.push(['_trackEvent', 'name', value]);"

    Enquanto o snippet assíncrono do Google Analytics existir acima do link, os cliques serão captados sem erros, mesmo que o Analytics não tenha sido totalmente carregado no momento do clique. Essa é uma das muitas vantagens do acompanhamento assíncrono.

    Por fim, em vez de digitar _gaq.push(...) para cada matriz de comandos, é possível enviar todos os comandos de uma vez. O código a seguir demonstra essa técnica. Consulte o Guia de uso do snippet assíncrono para mais detalhes. 

    _gaq.push(
  ['_setAccount', 'UA-XXXXX-X'],
  ['_setDomainName', 'example.com'],
  ['_setCustomVar', 1, 'Section', 'Life & Style', 3],
  ['_trackPageview']
);

      parâmetros

        Array commandArray O comando a ser executado. Um ou mais desses comandos podem ser enviados na mesma invocação.

      retorna

        Number O número de comandos que falharam na execução.