Odniesienie do obiektu trackera

W tym artykule opisano metody dostępne w obiekcie Tracker.

Podsumowanie metody

Metody
get(fieldName)	zwroty: * Pobiera wartość pola zapisanego w trackerze.
set(fieldName|fieldsObject, [fieldValue])	zwroty: undefined Ustawia parę pole/wartość lub grupę par pole/wartość w module śledzącym.
send([hitType], [...fields], [fieldsObject])	zwroty: undefined Wysyła działanie do Google Analytics.

Szczegóły metody

get

Pobiera wartość pola zapisanego w trackerze.

Wykorzystanie

tracker.get(fieldName);

Parametry

Nazwa	Typ	Wymagane	Opis
fieldName	string	tak	Nazwa pola, z którego zostanie pobrana wartość.

Zwroty

*

Przykłady

// 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

Ustawia parę pole/wartość lub grupę par pole/wartość w module śledzącym.

Wykorzystanie

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

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

Uwaga: zalecamy wywołanie metody set za pomocą kolejki poleceń ga. Więcej informacji znajdziesz w dokumentacji metody ustawiania metody.

Parametry

W dokumentacji pól znajdziesz dokumentację poszczególnych pól.

Zwroty

undefined

Przykłady

// 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

Wysyła działanie do Google Analytics.

Wykorzystanie

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

Wysyłane pola to wartości określone w parametrach ...fields i fieldsObject, scalone z polami przechowywanymi obecnie w tagu śledzenia.

Uwaga: wartości określone w parametrach ...fields i fieldsObject są wysyłane z bieżącym działaniem, ale nie są przechowywane w obiekcie skryptu śledzenia. Aby zaktualizować lokalizator, użyj metody set.

Parametry

Pola, które można określić za pomocą parametrów ...fields, różnią się w zależności od typu działania. W tabeli poniżej znajdziesz pola odpowiadające poszczególnym typom działań. Niewymienione typy działań nie akceptują parametrów ...fields, a jedynie fieldsObject.

Typ działania	...fields
pageview	page
event	eventCategory, eventAction, eventLabel, eventValue
social	socialNetwork, socialAction, socialTarget
timing	timingCategory, timingVar, timingValue, timingLabel

W dokumentacji pól znajdziesz dokumentację poszczególnych pól.

Uwaga: zalecamy wywołanie metody send za pomocą kolejki poleceń ga. Więcej informacji znajdziesz w dokumentacji metody wysyłania.

Zwroty

undefined

Przykłady

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