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: Erstellt eine neue Tracker-Instanz mit den angegebenen Feldern. |
getByName(name) |
returns: Ruft die Tracker-Instanz mit dem angegebenen Namen ab. |
getAll() |
returns: Ruft alle Tracker-Instanzen ab. |
remove(name) |
returns: 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:
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:
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'); });