Передача параметров визитов
Большинство данных о посещениях собирается счетчиком Яндекс Метрики автоматически. Однако, часто возникает необходимость дополнения собранных данных собственными. Например, интерес может представлять статистика по заказам определенных товаров или информация о действиях авторизованных пользователей.
Яндекс Метрика позволяет связать с визитом произвольный набор данных, называемых параметрами визита. Эти данные могут быть отображены в отчетах, а также использоваться в условиях группировки и сегментации.
Параметры визитов передаются в хранилище счетчика с помощью JavaScript API. Отправка данных может производиться либо во время инициализации счетчика, либо в произвольный момент времени до истечения тайм-аута визита.
При инициализации счетчика параметры визита указываются в параметре params.
Для передачи параметров визита во время просмотра посетителем сайта используется метод params либо необязательный аргумент методов extLink, file, hit, reachGoal.
Параметры визитов передаются в виде JavaScript-объекта или массива.
В одном визите можно передать до 512 параметров. При передаче иерархической структуры данных в отчетах Яндекс Метрики отобразится до 10 уровней вложенности. Если в рамках одного визита был отправлен один параметр с разными значениями, то в Метрике отобразятся все значения. Подробнее см. в разделе Ограничения.
Пример передаваемых данных:
level1":{"level2":["level3_1","level3_2"]}}
Количество параметров для такой структуры будет равно двум, так как передано два значения: level3_1
и level3_2
.
Пример отображения данных в Метрике:

Обработка переданных данных
Данные передаются Яндекс Метрике в виде JavaScript-объектов.
Значение поля обрабатывается следующим образом в зависимости от своего типа:
- объект — для каждого ключа объекта создается ветвь дерева, и для каждого значения алгоритм вызывается рекурсивно;
- строка — вычисляется количество случаев, когда встречается каждое различное значение строки;
- число — вычисляется суммарное и среднее значение всех чисел;
- массив — создается ветвь дерева [Параметры], вычисляется количество случаев, когда значение является массивом, и алгоритм вызывается рекурсивно для каждого элемента массива;
- true, false или null — вычисляется количество случаев, когда встречается каждое такое значение.
Параметры передаются в Метрику как группировки. Показатели, которые вычисляются при обработке данных, являются метриками. Чтобы смотреть статистику по переданным параметрам визитов, используйте Отчет «Параметры визитов». Также параметры можно использовать в качестве условий при создании сегментов в других отчетах Яндекс Метрики.