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

Специальные параметры и показатели применяются разработчиками для сегментирования и сопоставления данных по таким переменным, как вход на сайт, автор страницы, уровень игры и т. п. Из этой статьи вы узнаете, как отправлять специальные параметры и показатели в Google Аналитику.

Чтобы отправить в Google Аналитику значения специальных величин, сопоставьте величины с одним из следующих параметров или показателей.

Специальная величина Тип данных Описание
dimension<Index> string Специальный параметр (например, dimension3)
metric<Index> string Специальный показатель (например, metric8)

Настройка и отправка специальных параметров

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

Обновите конфигурацию config своего ресурса, чтобы задать custom_map для параметра, а затем передайте значение специального параметра в Google Аналитику с помощью специального параметра:

// Configures custom dimension<Index> to use the custom parameter
// 'dimension_name' for 'GA_MEASUREMENT_ID', where <Index> is a number
// representing the index of the custom dimension.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension<Index>': 'dimension_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'dimension_name': dimension_value});

Вместо 'GA_MEASUREMENT_ID' укажите собственный идентификатор Google Аналитики.

Ниже приведен фрагмент кода для отправки в Google Аналитику специального параметра dimension2 со значением 55.

// Maps 'dimension2' to 'age'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'dimension2': 'age'}
});

// Sends an event that passes 'age' as a parameter.
gtag('event', 'age_dimension', {'age': 55});

Настройка и отправка специальных показателей

Обновите конфигурацию config своего ресурса, чтобы задать custom_map для показателя, а затем передайте значение специального показателя в Google Аналитику с помощью специального параметра:

// Configures custom metric<Index> to use the custom parameter
// 'metric_name' for GA_MEASUREMENT_ID, where <Index> is a number
// representing the index of the custom metric.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric<Index>': 'metric_name'}
});

// Sends the custom dimension to Google Analytics.
gtag('event', 'any_event_name', {'metric_name': metric_value});

Вместо 'GA_MEASUREMENT_ID' укажите собственный идентификатор Google Аналитики.

Ниже приведен фрагмент кода для отправки в Google Аналитику специального показателя metric5 со значением 1:

// Maps 'metric5' to 'avg_page_load_time'.
gtag('config', 'GA_MEASUREMENT_ID', {
  'custom_map': {'metric5': 'avg_page_load_time'}
});

// Sends an event that passes 'avg_page_load_time' as a parameter.
gtag('event', 'load_time_metric', {'avg_page_load_time': 1});

Настройка и отправка специальных параметров и показателей

Вы можете изменить конфигурацию config своего ресурса, чтобы выполнять эти операции и с параметрами, и с показателями.

gtag('config', 'GA_MEASUREMENT_ID', {
   'custom_map': {
     'dimension2': 'age',
     'metric5': 'avg_page_load_time'
   }
});

gtag('event', 'foo', {'age': 55, 'avg_page_load_time': 1});