Справка по счетчикам

В этой статье описаны доступные методы объекта Tracker.

Обзор методов

Методы
get(fieldName)

Возвращает: *

Получает значение поля, хранящегося в счетчике.

set(fieldName|fieldsObject, [fieldValue])

Возвращает: undefined

Устанавливает в счетчике пару поля и значения или несколько таких пар.

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

Возвращает: undefined

Отправляет обращение в Google Analytics.

Описание методов

get

Получает значение поля, хранящегося в счетчике.

Использование

tracker.get(fieldName);

Параметры

Название Тип Обязательно? Описание
fieldName string Да Название поля, значение которого нужно получить.

Возвращаемое значение

*

Примеры

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

Устанавливает в счетчике пару поля и значения или несколько таких пар.

Использование

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

Параметры

Ознакомьтесь с документацией по полям.

Возвращаемое значение

undefined

Примеры

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

Отправляет обращение в Google Analytics.

Использование

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

Отправляемые поля представляют собой значения, указанные в параметрах ...fields и fieldsObject. Они объединены с полями, которые содержатся в счетчике.

Параметры

Поля, которые можно определить с помощью параметров ...fields, зависят от типа обращения. В таблице ниже показаны поля для каждого из них. Не перечисленные здесь типы обращений не принимают параметры ...fields, принимая только fieldsObject.

Тип обращения ...fields
pageview page
event eventCategory, eventAction, eventLabel, eventValue
social socialNetwork, socialAction, socialTarget
timing timingCategory, timingVar, timingValue, timingLabel

Ознакомьтесь с документацией по полям.

Возвращаемое значение

undefined

Примеры

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