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

Permite enviar 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 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);

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

Permite enviar 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 actualmente en el objeto de seguimiento.

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. Si algún tipo no se incluye en la lista, significa que no acepta los 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

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