Código de seguimiento: el objeto global _gaq

El objeto global _gaq se puede usar directamente para el seguimiento asíncrono de páginas a través del método push(...). También tiene métodos para crear objetos de seguimiento, pero estos solo deben usarse en casos excepcionales.

Para el seguimiento de páginas tradicional, usa el objeto global _gat en su lugar.

Métodos de objetos _gaq

Detalles del método

_createAsyncTracker(),

    _createAsyncTracker(accountId, opt_name)
    Crea un objeto de seguimiento al que se puede hacer referencia por su nombre cuando se realizan llamadas de seguimiento asíncronas. Si no se proporciona ningún nombre, se tratará de la cadena vacía '', que representa la herramienta de seguimiento predeterminada en la sintaxis asíncrona. Si ya existe un rastreador asíncrono para el nombre proporcionado, se reemplazará por el de seguimiento nuevo.

    Nota: Por lo general, este método solo es seguro para usar dentro de una función que se envió a _gaq. Solo debe usarse en casos excepcionales. 
    _gaq._createAsyncTracker('UA-65432-1');

    Parámetros

      String accountId Es el ID completo de la propiedad web (p.ej., UA-65432-1) del objeto de seguimiento.
      String opt_name Es el nombre en el que se almacenará el objeto de seguimiento. Usa este nombre para hacer referencia al objeto de seguimiento en 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 un objeto de seguimiento con el nombre dado, se crea una herramienta de seguimiento nueva, se asigna a ese nombre y se muestra.

    Nota: Por lo general, este método solo es seguro para usar dentro de una función que se envió a _gaq. Solo debe usarse 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.

push

    push(commandArray)
    Ejecuta el command array determinado, que es simplemente un array de JavaScript que se ajusta al siguiente formato. El primer elemento del array debe ser el nombre de un método de objeto de seguimiento pasado como una string. El resto de los elementos del array son los valores que se pasarán como argumentos a la función.

    El siguiente uso es el típico:
    var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-65432-1']);
_gaq.push(['_trackPageview']);

    Esta función se denomina push para que se pueda usar un array en lugar de _gaq antes de que Analytics se cargue por completo. Mientras se carga Analytics, los comandos se enviarán al array o se pondrán en cola. Cuando Analytics termina de cargarse, reemplaza el array con el objeto _gaq y ejecuta todos los comandos en cola. Las llamadas posteriores a _gaq.push se resuelven en esta función, que ejecuta los comandos a medida que se envían.

    Para asignar un nombre a los rastreadores, se debe anteponer el nombre del dispositivo de seguimiento (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 esa herramienta.

    En el siguiente ejemplo, se 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: Los rastreadores se crean la primera vez que un comando hace referencia a ellos. La herramienta de seguimiento predeterminada se crea mediante el primer comando en el que no se nombra explícitamente el dispositivo de seguimiento. El nombre del dispositivo de seguimiento predeterminado es la cadena vacía ''.

    Además de enviar arrays de comandos, también puedes enviar objetos de funciones. Esto puede ser especialmente útil para los métodos de seguimiento que devuelven 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 sobre el vínculo, los clics se captarán sin errores, incluso si Analytics no se cargó por completo en el momento del clic. Este es uno de los tantos beneficios del seguimiento asíncrono.

    Por último, en lugar de escribir _gaq.push(...) para cada array 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 de fragmentos asíncronos para obtener más información. 

    _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 pueden enviar uno o más en la misma invocación.

      resultados

        Number La cantidad de comandos que no se pudieron ejecutar.