Referenz zu Objektmethoden von GA

In dieser Referenz werden die Methoden beschrieben, die für das Objekt ga verfügbar sind.

Methodenzusammenfassung

Die folgenden Methoden sind für das Objekt ga verfügbar, nachdem die Bibliothek analytics.js geladen wurde. Da diese Methoden nicht sofort verfügbar sind, sollten sie immer mit dem Ready Callback des ga-Befehls in der Warteschlange aufgerufen werden.

Don't: Verwende ga-Objektmethoden außerhalb von readyCallback, da diese möglicherweise noch nicht verfügbar sind.

var trackers = ga.getAll();

Das sollten Sie tun: Verwenden Sie ga-Objektmethoden in einem readyCallback, da diese garantiert verfügbar sind.

ga(function() {
  var trackers = ga.getAll();
});
Methoden
create([trackingId], [cookieDomain], [name], [fieldsObject]);

returns: Tracker

Erstellt eine neue Tracker-Instanz mit den angegebenen Feldern.

getByName(name)

returns: Tracker

Ruft die Tracker-Instanz mit dem angegebenen Namen ab.

getAll()

returns: Array<Tracker>

Ruft alle Tracker-Instanzen ab.

remove(name)

returns: undefined

Entfernt die Tracker-Instanz mit dem angegebenen Namen.

Die Methoden im Detail

create

Erstellt eine neue Tracker-Instanz mit den angegebenen Feldern.

Nutzung

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

Parameter

In der Feldreferenz finden Sie die Dokumentation für einzelne Felder.

Gibt Folgendes zurück:

Tracker

Beispiele

// 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

Ruft die Tracker-Instanz mit dem angegebenen Namen ab.

Nutzung

ga.getByName(name);

Parameter

Name Typ Required Beschreibung
name string ja Der Name des abzurufenden Trackers.

Gibt Folgendes zurück:

Tracker

Beispiele

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

getAll

Ruft alle Tracker-Instanzen ab.

ga.getAll();

Gibt Folgendes zurück:

Array<Tracker>

Beispiel

// 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

Entfernt die Tracker-Instanz mit dem angegebenen Namen.

Nutzung

ga.remove(name);

Parameter

Name Typ Required Beschreibung
name string ja Der Name des zu entfernenden Trackers.

Gibt Folgendes zurück:

undefined

Beispiele

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