Передача параметров визитов

Совет. Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта.

Большинство данных о посещениях собирается счетчиком Яндекс Метрики автоматически. Однако, часто возникает необходимость дополнения собранных данных собственными. Например, интерес может представлять статистика по заказам определенных товаров или информация о действиях авторизованных пользователей.

Яндекс Метрика позволяет связать с визитом произвольный набор данных, называемых параметрами визита. Эти данные могут быть отображены в отчетах, а также использоваться в условиях группировки и сегментации.

Параметры визитов передаются в хранилище счетчика с помощью JavaScript API. Отправка данных может производиться либо во время инициализации счетчика, либо в произвольный момент времени до истечения тайм-аута визита.

При инициализации счетчика параметры визита указываются в параметре params.

Для передачи параметров визита во время просмотра посетителем сайта используется метод params либо необязательный аргумент методов extLink, file, hit, reachGoal.

Параметры визитов передаются в виде объектов или массивов объектов.

Примеры передаваемых параметров визитов:


// Пример передачи объекта. Максимальное количество ключей – 512, максимальная вложенность – 10 уровней 
ym(XXXXXX, "params", { 
  level1_1: {
    level2_1: {
      level3_1: "example1" ,
      level3_2: "example2",
    },
    ...
    level2_2: "example3"
  }
})
  
// Пример передачи массива объектов
ym(XXXXXX, "params", [
  {
   level1_1: "example1",
    level1_2: "example2"
  },
  {
    level1_1: { 
      level2_1: "example3"
    }
  }
])

  
где
  • XXXXXX — номер счетчика;
  • level1_1, level1_2, level2_1, level2_n — структура параметров визитов;
  • example1, example2, example3 — значения для параметров.

Больше примеров — в разделе Примеры отправки параметров визитов.

Внимание. Часть названий полей зарезервирована для передачи данных электронной коммерции. Не используйте эти названия для передачи параметров визитов. Не передавайте свои параметры с зарезервированными.

В одном визите можно передать до 512 параметров. При передаче иерархической структуры данных в отчетах Яндекс Метрики отобразится до 10 уровней вложенности. Если в рамках одного визита был отправлен один параметр с разными значениями, то в Метрике отобразятся все значения. Подробнее см. в разделе Ограничения.

Пример передаваемых данных:

level1":{"level2":["level3_1","level3_2"]}}

Количество параметров для такой структуры будет равно двум, так как передано два значения: level3_1 и level3_2.

Пример отображения данных в Метрике:



Обработка переданных данных

Данные передаются Яндекс Метрике в виде JavaScript-объектов.

Значение поля обрабатывается следующим образом в зависимости от своего типа:

  • объект — для каждого ключа объекта создается ветвь дерева, и для каждого значения алгоритм вызывается рекурсивно;
  • строка — вычисляется количество случаев, когда встречается каждое различное значение строки;
  • число — вычисляется суммарное и среднее значение всех чисел;
  • массив — создается ветвь дерева [Параметры], вычисляется количество случаев, когда значение является массивом, и алгоритм вызывается рекурсивно для каждого элемента массива;
  • true, false или null — вычисляется количество случаев, когда встречается каждое такое значение.

Параметры передаются в Метрику как группировки. Показатели, которые вычисляются при обработке данных, являются метриками. Чтобы смотреть статистику по переданным параметрам визитов, используйте Отчет «Параметры визитов». Также параметры можно использовать в качестве условий при создании сегментов в других отчетах Яндекс Метрики.

Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики.