Tracker-Objektreferenz

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: undefined

Legt ein Feld/Wert-Paar oder eine Gruppe von Feld/Wert-Paaren für den Tracker fest.

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

returns: undefined

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