Специальные параметры и показатели

Из этого руководства вы узнаете, как отправлять специальные параметры и показатели при использовании библиотеки analytics.js.

Обзор

Специальные параметры и показатели позволяют отправлять в Google Analytics именно те данные, которые вам нужны. С их помощью разработчики могут сравнивать между собой различные сегменты, например пользователей, вошедших на сайт и не выполнивших вход, авторов страниц, уровни игры и т. д. в зависимости от специфики раздела сайта.

Подробнее о том, как работает эта функция, читайте здесь.

Данные о специальных параметрах и показателях передаются с помощью одного или обоих из этих значений:

Название поля Тип значения Да Описание
параметр[0–9]+ text Нет Порядковый номер параметра. У каждого специального параметра есть порядковый номер.Максимальное количество специальных параметров – 20 (для аккаунтов класса "Премиум" – 200). Суффикс номера должен быть целым числом выше 0 (например, параметр3).
показатель[0–9]+ integer Нет Порядковый номер показателя. У каждого специального показателя есть порядковый номер. Максимальное количество специальных показателей – 20 (для аккаунтов класса "Премиум" – 200). Суффикс номера должен быть целым числом выше 0 (например, показатель5).

Реализация

Сначала необходимо настроить специальный параметр или показатель в интерфейсе управления Google Analytics. После этого параметру или показателю будет присвоен номер, позволяющий отличить его от других. Этот номер вы будете использовать в библиотеке analytics.js для отправки данных о конкретном показателе или параметре.

Отправка данных

Данные о специальном параметре или показателе можно отправить только вместе с существующим обращением. Например, передать специальный параметр с порядковым номером 15 для обращения типа pageview можно следующим образом:

ga('send', 'pageview', {
  'dimension15':  'My Custom Dimension'
});

А вот как передать специальный показатель с порядковым номером 18 для обращения типа event:

ga('send', 'event', 'category', 'action', {
  'metric18': 8000
});

Если у специального показателя есть тип валюты, допустимо использовать десятичные значения:

ga('send', 'event', 'category', 'action', {
  'metric19': 24.99
});

Если вам нужно передавать специальный параметр или показатель со всеми обращениями на данной странице (или на протяжении всего жизненного цикла объекта отслеживания), можно использовать для этого команду set:

ga('set', 'dimension5', 'custom data');

Задать значения с помощью команды set как для параметра, так и для показателя можно следующим образом:

ga('set', {
  'dimension5': 'custom dimension data',
  'metric5': 'custom metric data'
});

О том, в каком формате следует передавать эти данные, можно узнать из раздела Специальные параметры и показатели руководства по полям.

Пример

Допустим, у вас есть сайт, материалы для которого создают несколько человек, и вы хотите узнать, статьи какого автора пользуется наибольшей популярностью у читателей. Для этого вам нужно сравнить просмотры страниц по автору. По молчанию Google Analytics не предоставляет данные об авторе, однако вы можете получать их с каждым просмотром страницы, используя специальный параметр.

Прежде всего нужно настроить в интерфейсе управления специальный параметр с названием author (автор) и областью действия hit (обращение). Вашему специальному параметру будет присвоен порядковый номер, допустим 5.

Итак, у вас есть специальный параметр author с определенным порядковым номером. Теперь его можно использовать в библиотеке analytics.js для отправки данных об авторе. Так, если ваша страница написана на PHP, фактическое имя автора будет сохранено как переменная PHP, например $author. Используйте эту переменную своем шаблоне PHP для передачи имени автора в специальный параметр:

ga('send', 'pageview', {
  'dimension5': '<?=$author?>'
});