Referencia de los métodos de objetos de ga

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

Resumen de métodos

Los siguientes métodos están disponibles en el objeto ga después de cargar la biblioteca analytics.js. Como estos métodos no están disponibles de inmediato, siempre debes invocarlos mediante la devolución de llamada lista de la cola de comandos de ga.

No: Usa los métodos del objeto ga fuera de una readyCallback, ya que es posible que los métodos aún no estén disponibles.

var trackers = ga.getAll();

Sugerencia: Usa los métodos del objeto ga dentro de un objeto readyCallback, ya que se garantiza su disponibilidad.

ga(function() {
  var trackers = ga.getAll();
});

Métodos
create([trackingId], [cookieDomain], [name], [fieldsObject]);	devuelve: Tracker Crea una instancia de seguimiento nueva con los campos especificados.
getByName(name)	devuelve: Tracker Obtiene la instancia de seguimiento con el nombre especificado.
getAll()	devuelve: Array<Tracker> Obtiene todas las instancias de dispositivos de rastreo.
remove(name)	devuelve: undefined Quita la instancia de seguimiento con el nombre especificado.

Detalles del método

create

Crea una instancia de seguimiento nueva con los campos especificados.

Uso

ga.create([trackingId], [cookieDomain], [name], [fieldsObject]);

Nota: Se recomienda llamar al método create a través de la cola de comandos ga. Si deseas obtener más información, consulta la referencia de métodos para crear.

Parámetros

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

Devuelve

Tracker

Ejemplos

// Creates a default tracker for the property UA-XXXXX-Y
// and uses automatic cookie domain configuration.
ga(function() {
  var tracker = ga.create('UA-XXXXX-Y', 'auto');
})

// Creates a tracker with the name "myTracker" for the property
// UA-XXXXX-Y, sets the cookieDomain to "example.com" and specifies
// a site speed sample rate of 10%.
ga(function() {
  var myTracker = ga.create('UA-XXXXX-Y', 'example.com', 'myTracker', {
    siteSpeedSampleRate: 10
  });
});

---

getByName

Obtiene la instancia de seguimiento con el nombre especificado.

Uso

ga.getByName(name);

Parámetros

Nombre	Tipo	Obligatorio	Descripción
name	string	sí	El nombre del dispositivo de rastreo que se obtendrá.

Devuelve

Tracker

Ejemplos

// Gets the default tracker.
ga(function() {
  ga.getByName('t0');
});

// Gets the tracker with the name "myTracker".
ga(function() {
  ga.getByName('myTracker');
});

---

getAll

Obtiene todas las instancias de dispositivos de rastreo.

ga.getAll();

Devuelve

Array<Tracker>

Ejemplo

// Logs a list of all tracker names to the console.
ga(function() {
  var trackers = ga.getAll();
  trackers.forEach(function(tracker) {
    console.log(tracker.get('name'));
  });
});

---

remove

Quita la instancia de seguimiento con el nombre especificado.

Uso

ga.remove(name);

Nota: Se recomienda llamar al método remove a través de la cola de comandos ga. Para obtener más información, consulta la referencia del método para quitar métodos.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
name	string	sí	El nombre del dispositivo de rastreo que se quitará.

Devuelve

undefined

Ejemplos

// Removes the default tracker.
ga(function() {
  // Note that, unlike the ga command queue's remove method,
  // this method requires passing a tracker name, even when
  // removing the default tracker.
  ga.remove('t0');
});

// Removes the tracker with the name "myTracker".
ga(function() {
  ga.remove('myTracker');
});