Referencia del objeto de seguimiento

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 objeto de seguimiento.
set(fieldName|fieldsObject, [fieldValue])	Devuelve: undefined Configura un par campo-valor o un grupo de pares campo-valor en el objeto de seguimiento.
send([hitType], [...fields], [fieldsObject])	Devuelve: undefined Envía un hit a Google Analytics.

Detalles de método

get

Obtiene el valor de un campo almacenado en el objeto de seguimiento.

Uso

tracker.get(fieldName);

Parámetros

Nombre	Tipo	Obligatorio	Descripción
fieldName	string	sí	Nombre del campo del que se obtendrá 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

Configura un par campo-valor o un grupo de pares campo-valor en el objeto de seguimiento.

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. En la referencia del método set puedes encontrar más información.

Parámetros

En la referencia de campos puedes consultar la documentación de cada campo.

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 en fieldsObject, y se combinan con los campos que están almacenados en el objeto de seguimiento.

Nota: Los valores especificados en ...fields y en fieldsObject se envían con un hit concreto, pero no se almacenan en el objeto de seguimiento. Para modificar el objeto de seguimiento, usa el método set.

Parámetros

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

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

En la referencia de campos puedes consultar la documentación de cada campo.

Nota: Se recomienda llamar al método send con la cola de comandos ga. En la referencia del método send puedes encontrar más información al respecto.

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
  });
});