El objeto global _gaq
se puede usar directamente para el seguimiento de páginas asíncronas a través del método push(...)
. También tiene métodos para crear objetos de seguimiento, pero solo se deben usar en casos excepcionales.
Para el seguimiento tradicional de páginas, usa el objeto global _gat
.
Métodos de objetos _gaq
_createAsyncTracker(accountId, opt_name)
obsoleto_getAsyncTracker(opt_name)
obsoletopush(commandArray)
Detalles del método
_CreateAsyncTracker()
_createAsyncTracker(accountId, opt_name)
-
Crea un objeto de seguimiento al que se puede hacer referencia por el nombre cuando se realizan llamadas de seguimiento asíncronas. Si no se proporciona ningún nombre, será la string vacía
''
, que representa el seguimiento predeterminado en la sintaxis asíncrona.
Si ya existe un rastreador asíncrono para el nombre dado, se reemplazará por el nuevo.Nota: Por lo general, solo se puede usar este método dentro de una función que se envió a
_gaq
. Solo se debe usar en casos excepcionales.
_gaq._createAsyncTracker('UA-65432-1');
Parámetros
String accountId
El ID de propiedad web completo (p.ej., UA-65432-1) del objeto de seguimiento.
String opt_name
Es el nombre en el que se almacenará el objeto de seguimiento. Use este nombre para hacer referencia al objeto de seguimiento en las llamadas de seguimiento asíncronas más adelante.
resultados
Tracker
El objeto de seguimiento creado_getAsyncTracker()
_getAsyncTracker(opt_name)
-
Muestra el objeto de seguimiento creado previamente con el nombre determinado.
Si no se proporciona ningún nombre, se usará el nombre predeterminado de la herramienta de seguimiento (la string vacía
''
). Si no existe ningún objeto de seguimiento con el nombre determinado, se crea un nuevo rastreador, se le asigna ese nombre y se muestra.Nota: Por lo general, solo se puede usar este método dentro de una función que se envió a
_gaq
. Solo se debe usar en casos excepcionales.
_gaq._getAsyncTracker();
Parámetros
String opt_name
El nombre del objeto de seguimiento que se recuperará.
resultados
Tracker
El objeto de seguimiento recuperado o creado.enviar
push(commandArray)
- Ejecuta el
command array
determinado, que es simplemente un arreglo de JavaScript que cumple con el siguiente formato. El primer elemento del arreglo debe ser el nombre de un método de objeto de seguimiento que se pasa como una string. El resto de los elementos del arreglo son los valores que se pasarán como argumentos a la función.El siguiente uso es típico:
var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-65432-1']); _gaq.push(['_trackPageview']);
Esta función se llama
_gaq
antes de que Analytics se cargue por completo. Mientras Analytics se carga, los comandos se enviarán o pondrán en cola en el arreglo. Cuando Analytics termina de cargarse, reemplaza el arreglo por el objeto _gaq
y ejecuta todos los comandos en cola. Las llamadas posteriores a _gaq.push
se resuelven en esta función, que ejecuta comandos a medida que se envían.Las herramientas de seguimiento se pueden nombrar anteponiendo el nombre de la herramienta (junto con un punto) delante del nombre del método. Si el nombre de una función se califica con el nombre de un rastreador, se ejecuta en ese rastreador.
El siguiente ejemplo crea y usa un rastreador llamado myTracker de manera arbitraria.
var _gaq = _gaq || []; _gaq.push(['myTracker._setAccount', 'UA-65432-2']); _gaq.push(['myTracker._setDomainName', 'foo.com']); _gaq.push(['myTracker._trackPageview']);
Nota: Las herramientas de seguimiento se crean la primera vez que un comando hace referencia a ellas. La herramienta de seguimiento predeterminada se crea mediante el primer comando que no menciona explícitamente la herramienta de seguimiento. El nombre predeterminado del rastreador es la string vacía
''
.Además de enviar arreglos de comandos, también puedes enviar objetos de funciones. Esto puede ser especialmente útil para los métodos de seguimiento que muestran valores. Estas funciones pueden hacer referencia a
_gat
y _gaq
.var _gaq = _gaq || []; _gaq.push(function() { var tracker = _gat._getTracker('UA-65432-1'); tracker._trackPageview(); });
También puedes usar la sintaxis de envío directamente en el código HTML de tu página.
onclick="_gaq.push(['_trackEvent', 'name', value]);"
Siempre que el fragmento asíncrono de Analytics exista por encima del vínculo, los clics se capturarán sin errores, incluso si Analytics no se cargó por completo en el momento del clic. Esta es una de las muchas ventajas del seguimiento asíncrono.
Por último, en lugar de escribir _gaq.push(...)
para cada arreglo de comandos, puedes enviar todos los comandos a la vez. En el siguiente código, se muestra esta técnica.
Consulta la Guía de uso del fragmento asíncrono para obtener más detalles.
_gaq.push( ['_setAccount', 'UA-XXXXX-X'], ['_setDomainName', 'example.com'], ['_setCustomVar', 1, 'Section', 'Life & Style', 3], ['_trackPageview'] );
Parámetros
Array commandArray
El comando que se ejecutará. Se puede enviar uno o más de estos elementos en la misma invocación.
resultados
Number
La cantidad de comandos que no se pudieron ejecutar