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: Legt ein Feld/Wert-Paar oder eine Gruppe von Feld/Wert-Paaren auf dem Tracker fest. |
send([hitType], [...fields], [fieldsObject]) |
Gibt Folgendes zurück: 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);
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.
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.
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 }); });