--- metadata: - name: generator content: Diplodoc Platform v5.50.6 alternate: - https://www.yandex.com/support/metrica/en/data/visit-params-data.md - https://www.yandex.com/support/metrica/es/data/visit-params-data.md - https://www.yandex.com/support/metrica/pt/data/visit-params-data.md - https://www.yandex.com/support/metrica/ru/data/visit-params-data.md - https://www.yandex.com/support/metrica/tr/data/visit-params-data.md - https://www.yandex.com/support/metrica/zh/data/visit-params-data.md title: Передача событий description: Яндекс Метрика позволяет связать с визитом произвольный набор данных, называемых параметрами события. Эти данные могут быть отображены в отчетах, а также использоваться в условиях группировки и сегментации. --- > **Documentation Index:** Fetch the complete configuration index at https://www.yandex.com/support/metrica/ru/llms.txt # Передача событий {% note warning %} Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта. {% endnote %} Большинство данных о посещениях [собирается счетчиком](https://www.yandex.com/support/metrica/ru/general/how-it-works.md#data_extract_pull) Яндекс Метрики автоматически. Однако, часто возникает необходимость дополнения собранных данных собственными. Например, интерес может представлять статистика по заказам определенных товаров или информация о действиях авторизованных пользователей. Яндекс Метрика позволяет связать с визитом произвольный набор данных, называемых _параметрами события_. Эти данные могут быть отображены в отчетах, а также использоваться в условиях группировки и сегментации. Параметры событий передаются в хранилище счетчика с помощью JavaScript API. Отправка данных может производиться либо во время инициализации счетчика, либо в произвольный момент времени до истечения [тайм-аута визита](https://www.yandex.com/support/metrica/ru/general/counter-general.md#time-out). При инициализации счетчика параметры событий указываются в параметре [params](https://www.yandex.com/support/metrica/ru/code/counter-initialize.md#param-params). Для передачи параметров событий во время просмотра посетителем сайта используется метод [params](https://www.yandex.com/support/metrica/ru/objects/params-method.md) либо необязательный аргумент методов [extLink](https://www.yandex.com/support/metrica/ru/objects/extlink.md), [file](https://www.yandex.com/support/metrica/ru/objects/file.md), [hit](https://www.yandex.com/support/metrica/ru/objects/hit.md), [reachGoal](https://www.yandex.com/support/metrica/ru/objects/reachgoal.md). Параметры событий передаются в виде объектов или массивов объектов. ## Отправка и обработка данных {#proc} Данные передаются Яндекс Метрике в виде JavaScript-объектов. Запрос данных, отправляемых в Метрику может содержать не более 8 КБ (8 192 символов). При [передаче иерархической структуры данных](https://www.yandex.com/support/metrica/ru/data/visit-params-example.md#level) в отчетах Яндекс Метрики отобразится до 10 уровней вложенности. Если в рамках одного визита был отправлен один параметр с разными значениями, то в Метрике отобразятся все значения. При этом стоит учитывать, что в одном визите можно передать до 512 параметров. [Ограничения на передачу данных](https://www.yandex.com/support/metrica/ru/general/limits.md) Значение поля обрабатывается следующим образом в зависимости от своего типа: - **объект** — для каждого ключа объекта создается ветвь дерева, и для каждого значения алгоритм вызывается рекурсивно; - **строка** — вычисляется количество случаев, когда встречается каждое различное значение строки; - **число** — вычисляется суммарное и среднее значение всех чисел; - **массив** — создается ветвь дерева [Параметры], вычисляется количество случаев, когда значение является массивом, и алгоритм вызывается рекурсивно для каждого элемента массива; - **true**, **false** или **null** — вычисляется количество случаев, когда встречается каждое такое значение. Пример передаваемых данных: ```javascript // Пример передачи объекта. Максимальная вложенность – 10 уровней ym(XXXXXXXX, "params", { level1_1: { level2_1: { level3_1: "example1" , level3_2: "example2", }, ... level2_2: "example3" } }) ``` Где: - XXXXXXXX — номер счетчика; - level1_1, level1_2, level2_1 — структура параметров событий; - example1, example2, example3 — значения для параметров. Больше примеров — в разделе [Примеры отправки событий](https://www.yandex.com/support/metrica/ru/data/visit-params-example.md). ## Отчеты по параметрам {#param} События передаются в Метрику как [группировки](*группировки) или [цели](https://www.yandex.com/support/metrica/ru/general/glossary.md#goal). Показатели, которые вычисляются при обработке данных, являются [метриками](*метриками). Чтобы смотреть статистику по переданным событиям, используйте [Отчет «Параметры события»](https://www.yandex.com/support/metrica/ru/reports/event-params.md) или [Отчет «Параметры визитов»](https://www.yandex.com/support/metrica/ru/reports/visit-params.md). Также параметры можно использовать в качестве условий при [создании сегментов](https://www.yandex.com/support/metrica/ru/general/segmentation.md) в других отчетах Яндекс Метрики. {% note info %} Если вы передаете параметры с аргументом метода [reachGoal](https://www.yandex.com/support/metrica/ru/objects/reachgoal.md), но JavaScript-цель не заведена для счетчика или заведена только внутри составной цели — данные не попадут в отчет «Параметры событий». Создайте отдельную JavaScript-цель в интерфейсе счетчика или используйте другие методы для передачи параметров: [params](https://www.yandex.com/support/metrica/ru/objects/params-method.md), [extLink](https://www.yandex.com/support/metrica/ru/objects/extlink.md), [file](https://www.yandex.com/support/metrica/ru/objects/file.md) или [hit](https://www.yandex.com/support/metrica/ru/objects/hit.md). {% endnote %} [Написать в чат](https://yandex.com/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
{% cut "Написать письмо" %} Обратите внимание: служба поддержки не обзванивает пользователей. Не следуйте указаниям людей, которые вам звонят и представляются службой поддержки Яндекс Метрики. Если нужно скорректировать цель, чтобы она и дальше фиксировала события, которые отличаются от посещения страниц, пожалуйста, опишите ситуацию в форме.
{% endcut %}
- - -
#| || Полезные ссылки - [Демосчетчик](https://metrica.yandex.com/r/dashboard?) - [Добавить счетчик](https://metrica.yandex.com/add/) - [Бесплатная настройка счетчика](https://yandex.com/promo/freeservice/metrica?utm_source=help_metrica_en&utm_medium=cpc&utm_campaign=1) - [API Яндекс Метрики](https://tech.yandex.com/metrika/) - [Предложить идею](https://yandex.com/support/metrica/troubleshooting/idea.html) - [Обсудить в Telegram](https://t.me/yandexmetrika) | Онлайн-обучение - [Получить сертификат по Яндекс Метрике](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links) - [Пройти обучающий курс](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links) || |#
[*группировки]: Атрибут действий посетителей, зафиксированных счетчиком (например, визит, просмотр, внешний переход, загрузка файла и пр.). По атрибуту группируются данные, переданные в отчет. [*метриками]: Числовая величина, которая рассчитывается на основе атрибута визита или просмотра. Эта величина может быть общей или средней. Например, просмотры рассчитываются как сумма значений, глубина просмотра — как среднее значение.