Referencia de objetos de Tracker

En esta referencia, se describen los métodos disponibles en el objeto Tracker.

Resumen de métodos

Métodos
get(fieldName)	devuelve: * Obtiene el valor de un campo almacenado en el rastreador.
set(fieldName|fieldsObject, [fieldValue])	devuelve: undefined Establece un par campo/valor o un grupo de pares campo/valor en el rastreador.
send([hitType], [...fields], [fieldsObject])	devuelve: undefined Envía un hit a Google Analytics.

Detalles del método

get

Obtiene el valor de un campo almacenado en el rastreador.

Uso

tracker.get(fieldName);

Parámetros

Nombre	Tipo	Obligatorio	Descripción
fieldName	string	sí	El nombre del campo del que se obtiene el valor.

Devuelve

*

Ejemplos

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

// Gets the client ID of the default tracker and logs it.
ga(function(tracker) {
  var clientId = tracker.get('clientId');
  console.log(clientId);
});

---

set

Establece un par campo/valor o un grupo de pares campo/valor en el rastreador.

Uso

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);

// Sets a group of field/value pairs.
tracker.set(fieldsObject);

Nota: Se recomienda llamar al método set mediante la cola de comandos ga. Consulta la referencia del método set para obtener más información.

Parámetros

Consulta la referencia de campos para ver la documentación de campos individuales.

Devuelve

undefined

Ejemplos

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets the page field to "/about.html".
  tracker.set('page', '/about.html');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sets both the page and title fields.
  tracker.set({
    page: '/about.html',
    title: 'About'
  });
});

---

send

Envía un hit a Google Analytics.

Uso

tracker.send([hitType], [...fields], [fieldsObject]);

Los campos que se envían son los valores especificados en los parámetros ...fields y fieldsObject, combinados con los campos almacenados actualmente en la herramienta de seguimiento.

Nota: Los valores especificados en ...fields y fieldsObject se envían con el hit actual, pero no se almacenan en el objeto de seguimiento. Usa el método set para actualizar un dispositivo de rastreo.

Parámetros

Los campos que se pueden especificar con los parámetros de ...fields varían según el tipo de hit. En la siguiente tabla, se incluyen los campos que corresponden a cada tipo de hit. Los tipos de hits que no figuran en la lista no aceptan parámetros ...fields, solo fieldsObject.

Tipo de hit	...fields
pageview	page
event	eventCategory, eventAction, eventLabel, eventValue
social	socialNetwork, socialAction, socialTarget
timing	timingCategory, timingVar, timingValue, timingLabel

Consulta la referencia de campos para ver la documentación de campos individuales.

Nota: Se recomienda llamar al método send con la cola de comandos de ga. Para obtener más información, consulta la referencia del método de envío.

Devuelve

undefined

Ejemplos

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends a pageview hit.
  tracker.send('pageview');
});

// Creates a default tracker.
ga('create', 'UA-XXXXX-Y', auto);

ga(function(tracker) {
  // Sends an event hit for the tracker named "myTracker" with the
  // following category, action, and label, and sets the nonInteraction
  // field value to true.
  tracker.send('event', 'link', 'click', 'http://example.com', {
    nonInteraction: true
  });
});