In dieser Referenz werden die Methoden beschrieben, die für das Objekt Tracker
verfügbar sind.
Methodenzusammenfassung
Methoden | |
---|---|
get(fieldName) |
returns: Ruft den Wert eines im Tracker gespeicherten Felds ab. |
set(fieldName|fieldsObject, [fieldValue]) |
returns: Legt ein Feld/Wert-Paar oder eine Gruppe von Feld/Wert-Paaren für den Tracker fest. |
send([hitType], [...fields], [fieldsObject]) |
returns: Ein Treffer wird an Google Analytics gesendet. |
Die Methoden im Detail
get
Ruft den Wert eines im Tracker gespeicherten Felds ab.
Nutzung
tracker.get(fieldName);
Parameter
Name | Typ | Required | Beschreibung |
---|---|---|---|
fieldName |
string |
ja | Der Name des Felds, dessen Wert abgerufen wird. |
Gibt Folgendes zurück:
*
Beispiele
// 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
Legt ein Feld/Wert-Paar oder eine Gruppe von Feld/Wert-Paaren für den Tracker fest.
Nutzung
// Sets a single field/value pair. tracker.set(fieldName, fieldValue);
// Sets a group of field/value pairs. tracker.set(fieldsObject);
Parameter
In der Feldreferenz finden Sie die Dokumentation für einzelne Felder.
Gibt Folgendes zurück:
undefined
Beispiele
// 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
Ein Treffer wird an Google Analytics gesendet.
Nutzung
tracker.send([hitType], [...fields], [fieldsObject]);
Die gesendeten Felder sind die in den ...fields
-Parametern und fieldsObject
angegebenen Werte, die mit den derzeit im Tracker gespeicherten Feldern zusammengeführt werden.
Parameter
Welche Felder durch die ...fields
-Parameter festgelegt werden können, hängt vom Treffertyp ab. In der folgenden Tabelle sind die Felder für die einzelnen Treffertypen aufgeführt. Für nicht aufgeführte Treffertypen sind keine ...fields
-Parameter zulässig, sondern nur fieldsObject
.
Treffertyp | ...fields |
---|---|
pageview |
page |
event |
eventCategory , eventAction , eventLabel , eventValue |
social |
socialNetwork , socialAction , socialTarget |
timing |
timingCategory , timingVar , timingValue , timingLabel |
In der Feldreferenz finden Sie die Dokumentation für einzelne Felder.
Gibt Folgendes zurück:
undefined
Beispiele
// 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 }); });