Referenz zu GA-Objektmethoden

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

Methodenzusammenfassung

Die folgenden Methoden sind für das ga-Objekt verfügbar, nachdem die analytics.js-Bibliothek geladen wurde. Da diese Methoden nicht sofort verfügbar sind, sollten Sie sie immer mit dem fähigen Callback der ga-Befehlswarteschlange aufrufen.

Falsch: Verwenden Sie ga-Objektmethoden außerhalb von readyCallback, da die Methoden möglicherweise noch nicht verfügbar sind.

var trackers = ga.getAll();

Richtig: Verwenden Sie ga-Objektmethoden innerhalb einer readyCallback, da diese garantiert verfügbar sind.

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

Methoden
create([trackingId], [cookieDomain], [name], [fieldsObject]);	Gibt Folgendes zurück: Tracker Erstellt eine neue Tracker-Instanz mit den angegebenen Feldern.
getByName(name)	Gibt Folgendes zurück: Tracker Ruft die Tracker-Instanz mit dem angegebenen Namen ab.
getAll()	Gibt Folgendes zurück: Array<Tracker> Ruft alle Tracker-Instanzen ab.
remove(name)	Gibt Folgendes zurück: 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]);

Hinweis:Es empfiehlt sich, die Methode create über die ga-Befehlswarteschlange aufzurufen. Weitere Informationen finden Sie in der Referenz zur Erstellungsmethode.

Parameter

In der Feldreferenz finden Sie die Dokumentation zu den einzelnen Feldern.

Rückgaben

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	Erforderlich	Beschreibung
name	string	ja	Der Name des abzurufenden Trackers.

Rückgaben

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

Rückgaben

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

Hinweis:Es empfiehlt sich, die Methode remove über die ga-Befehlswarteschlange aufzurufen. Weitere Informationen finden Sie in der Referenz zur Methode zum Entfernen.

Parameter

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

Rückgaben

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