Tracker-Objektreferenz

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

Methodenzusammenfassung

Methoden
get(fieldName)	Gibt Folgendes zurück: * Ruft den Wert eines Felds ab, das auf dem Tracker gespeichert ist.
set(fieldName|fieldsObject, [fieldValue])	Gibt Folgendes zurück: undefined Legt ein Feld/Wert-Paar oder eine Gruppe von Feld/Wert-Paaren auf dem Tracker fest.
send([hitType], [...fields], [fieldsObject])	Gibt Folgendes zurück: undefined Sendet einen Treffer an Google Analytics.

Die Methoden im Detail

get

Ruft den Wert eines Felds ab, das auf dem Tracker gespeichert ist.

Nutzung

tracker.get(fieldName);

Parameter

Name	Typ	Erforderlich	Beschreibung
fieldName	string	ja	Der Name des Felds, für das der Wert abgerufen wird.

Rückgaben

*

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 auf dem Tracker fest.

Nutzung

// Sets a single field/value pair.
tracker.set(fieldName, fieldValue);

// Sets a group of field/value pairs.
tracker.set(fieldsObject);

Hinweis: Es empfiehlt sich, die Methode set mit der ga-Befehlswarteschlange aufzurufen. Weitere Informationen finden Sie in der Referenz zur set-Methode.

Parameter

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

Rückgaben

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

Sendet einen Treffer an Google Analytics.

Nutzung

tracker.send([hitType], [...fields], [fieldsObject]);

Es werden die Werte gesendet, die in den Parametern ...fields und fieldsObject angegeben und mit den derzeit auf dem Tracker gespeicherten Feldern zusammengeführt wurden.

Hinweis: Die in ...fields und fieldsObject angegebenen Werte werden mit dem aktuellen Treffer gesendet, aber nicht im Tracker-Objekt gespeichert. Aktualisieren Sie einen Tracker mit der set-Methode.

Parameter

Welche Felder mit den ...fields-Parametern angegeben werden können, hängt vom Treffertyp ab. In der folgenden Tabelle sind die Felder für den jeweiligen Treffertyp aufgeführt. Nicht aufgeführte Treffertypen akzeptieren keine ...fields-Parameter, 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 zu den einzelnen Feldern.

Hinweis: Es empfiehlt sich, die Methode send mithilfe der ga-Befehlswarteschlange aufzurufen. Weitere Informationen finden Sie in der Referenz zur Sendemethode.

Rückgaben

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