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
_createAsyncTracker(accountId, opt_name)
descontinuado_getAsyncTracker(opt_name)
descontinuadopush(commandArray)
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
_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.