--- metadata: - name: generator content: Diplodoc Platform v5.52.0 alternate: - https://yandex.com/support/metrica/en/data/user-params-data.md - https://yandex.com/support/metrica/es/data/user-params-data.md - https://yandex.com/support/metrica/pt/data/user-params-data.md - https://yandex.com/support/metrica/ru/data/user-params-data.md - https://yandex.com/support/metrica/tr/data/user-params-data.md - https://yandex.com/support/metrica/zh/data/user-params-data.md - href: ru/data/user-params-data.md type: text/markdown title: Markdown version - href: ../llms.txt type: text/markdown title: llms.txt title: Передача параметров посетителей description: "Яндекс\_Метрика позволяет передавать произвольный набор данных, называемых параметрами посетителей. В качестве этих параметров рекомендуем передавать характеристики посетителей, которые не изменяются от визита к визиту и не содержат персональные данные (например, фамилию или имя)." --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/metrica/ru/llms.txt # Передача параметров посетителей {% note warning %} Для работы с JavaScript API необходимы навыки работы с HTML и JavaScript. Если вы не обладаете такими навыками, обратитесь к разработчику или вебмастеру вашего сайта. {% endnote %} Большинство данных о посещениях собирается счетчиком Яндекс Метрики автоматически. Эти данные можно дополнять собственными, передавая [параметры визитов](https://yandex.com/support/metrica/ru/data/visit-params-data.md). Однако, часто вызывает интерес не статистика визитов посетителей сайта, а информация о самих посетителях. Яндекс Метрика позволяет передавать произвольный набор данных, называемых _параметрами посетителей_. В качестве этих параметров рекомендуем передавать характеристики посетителей, которые не изменяются от визита к визиту и не содержат персональные данные (например, фамилию или имя). [Чем отличаются параметры посетителя и визита](https://yandex.com/support/metrica/ru/general/how-it-works.md#difference) Чтобы переданные вами параметры отобразились в отчетах, Метрика должна привязать их к посетителям сайта. Для этого сервис использует специальные идентификаторы: [ClientID](*ClientID) и [UserID](*UserID). Параметры привязываются к визитам посетителей, которые заходили на сайт в течение 90 дней до момента отправки данных в Метрику. {% note info %} При передаче параметров посетителей с указанием ClientID и UserID итоговое количество посетителей в отчетах Яндекс Метрики может отличаться от количества переданных идентификаторов из-за особенностей привязки UserID к ClientID. {% endnote %} Переданная информация появится в отчетах в течение нескольких часов. Чтобы посмотреть статистику, используйте [отчет Параметры посетителей](https://yandex.com/support/metrica/ru/reports/user-params.md). {% note info %} Отправленные в Метрику параметры хранятся два года с момента последней загрузки. Когда срок хранения закончится, данные перестанут отображаться в отчете. {% endnote %} {% cut "Когда передавать ClientID" %} Рекомендуем передавать данные, используя [ClientID](*ClientID), например, если нет необходимости получить в отчете собственные идентификаторы. {% endcut %} {% cut "Когда передавать UserID" %} Рекомендуем передавать [UserID](*UserID), например, если на сайте уже сформирована система идентификаторов пользователей и необходимо получить отчет с указанием этих идентификаторов. {% endcut %} Передавать параметры посетителей в Яндекс Метрику можно несколькими способами: - [во время посещения сайта](#online); - с помощью [CSV-файла в произвольный момент времени](#offline). ## Передача данных во время посещения сайта {#online} Этот способ может быть полезен для формирования отчета на основе данных, полученных в момент, когда посетитель находится на сайте. Параметры посетителей передаются в Яндекс Метрику с помощью JavaScript API. Отправленную этим способом информацию нельзя удалить из Яндекс Метрики. Чтобы отправить параметры в произвольный момент времени, используйте метод [userParams](https://yandex.com/support/metrica/ru/objects/user-params.md). Для передачи параметров во время инициализации счетчика укажите данные в параметре [userParams](https://yandex.com/support/metrica/ru/code/counter-initialize.md). Информация передается в виде JavaScript-объектов. Значение поля обрабатывается следующим образом в зависимости от своего типа: - **объект** — для каждого ключа объекта создается ветвь дерева, и для каждого значения алгоритм вызывается рекурсивно; - **строка** — вычисляется количество случаев, когда встречается каждое различное значение строки; - **число** — вычисляется суммарное и среднее значение всех чисел; - **true**, **false** или **null** — вычисляется количество случаев, когда встречается каждое такое значение. Данные привяжутся к [ClientID](*ClientID) только для тех посетителей сайта, во время посещений которых был вызван метод `userParams`. Для сбора более полной статистики подождите некоторое время, пока в Яндекс Метрику будет передан больший объем данных. > ## Пример > > Представим интернет-магазин, у которого есть два типа покупателей: «обычные» и «vip». Данные о статусе клиента хранятся в собственной базе сайта. После того, как посетитель авторизуется на сайте, на каждой странице вместо ссылки **Войти** он будет видеть свое имя или логин, а рядом — свой особый статус, если он у него есть: **Иван / VIP**. Вместе со статусом можно передать и идентификатор посетителя, хранящийся в вашей базе. > > Чтобы отправлять в Метрику данные, на все страницы сайта добавьте код, который будет вызывать метод `userParams`. > > Для отправки данных о посетителях с особым статусом код примет следующий вид: > > > {% list tabs %} > > - В произвольный момент > > > ```javascript > ym(XXXXXXXX, 'userParams', { > vip_status: true, > child: 1, > child_age: 13, > UserID: 12345 > }); > ``` > > > - При инициализации счетчика > > > ```javascript > ym(XXXXXXXX, 'init', { > clickmap: true, > webvisor: true, > userParams: { > vip_status: true, > child: 1, > child_age: 13, > UserID: 12345 > } > }); > ``` > > {% endlist %} > > > Если передается информация об «обычном» посетителе, код будет таким: > > {% list tabs %} > > - В произвольный момент > > > ```javascript > ym(XXXXXXXX, 'userParams', { > vip_status: false, > child: 1, > child_age: 13, > UserID: 12345 > }); > ``` > > > - При инициализации счетчика > > > ```javascript > ym(XXXXXXXX, 'init', { > clickmap: true, > webvisor: true, > userParams: { > vip_status: false, > child: 1, > child_age: 13, > UserID: 12345 > } > }); > ``` > > {% endlist %} > > где `XXXXXXXX` — номер вашего счетчика. > > Если у «обычного» клиента появится особый статус, то при его следующей авторизации на сайте метод `userParams` отправит в Метрику изменившиеся данные. При этом новый статус распространится на всю историю визитов этого посетителя, как если бы он был vip-клиентом изначально. ## Передача данных с помощью CSV-файла в произвольный момент времени {#offline} Этот способ позволяет передавать в Метрику не только данные, собранные в момент посещения сайта, но и данные, собранные после того, как посетитель уже покинул сайт. [Спецификация формата CSV](http://www.rfc-editor.org/rfc/rfc4180.txt) [Описание формата CSV](https://en.wikipedia.org/wiki/Comma-separated_values) #| ## Обязательные поля для передачи данных {#offline} || **Название поля** | **Описание** | **Пример** || || `clientID` \| `userID` | Идентификатор посетителя сайта | P12345 || || `key` | Параметр посетителя. Максимальное количество для одного посетителя составляет 1000 | age \| client.age || || `value` | Значение параметра посетителя | 40 || |# Для передачи иерархической структуры параметров используйте символ «.» (точка). Например, для передачи нескольких значений поля `key`, необходимо указать `client.demography.age`. Максимальное количество символов в полях, которое отображается в отчетах Яндекс Метрики: - `key` — 255; - `value` — 50. Чтобы передать информацию с указанием: {% list tabs %} - ClientID 1. Получите ClientID с помощью метода [getClientID](https://yandex.com/support/metrica/ru/objects/get-client-id.md). 1. Сформируйте CSV-файл с указанием ClientID и отправьте его через интерфейс Яндекс Метрики. - UserID 1. Передайте ваши UserID с помощью метода [setUserID](https://yandex.com/support/metrica/ru/objects/set-user-id.md). 1. Сформируйте CSV-файл с указанием UserID и отправьте его через интерфейс Яндекс Метрики. {% endlist %} ### Работа с файлом {#data-send} Интерфейс Яндекс Метрики позволяет загружать данные и удалять их. Работа с файлом производится в разделе **Настройка** (вкладка **Загрузка данных**, блок **Параметры посетителей**). {% list tabs %} - Загрузка данных Чтобы передать сформированный CSV-файл в Яндекс Метрику: 1. Нажмите кнопку **Загрузить данные**. 1. В появившемся окне выберите тип файла в зависимости от типа идентификатора, который вы хотите загрузить ([UserID](*UserID) или [ClientID](*ClientID)). 1. Выберите файл на вашем компьютере и добавьте комментарий к загрузке, если это необходимо. 1. Нажмите кнопку **Загрузить данные**. [Пример CSV-файла для загрузки данных](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/upload-data-example.csv) - Удаление данных Чтобы удалить из сервиса ранее загруженные данные или их часть, подготовьте CSV-файл. Файл должен содержать только поле `key` тех данных, которые вы хотите удалить. Затем выполните следующее: 1. Нажмите кнопку **Удалить данные**. 2. В появившемся окне выберите тип файла, к которому надо применить изменения, в зависимости от идентификатора ([UserID](*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет.) или [ClientID](*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически.)). 3. Выберите файл на вашем компьютере и добавьте комментарий к загрузке, если это необходимо. 4. Нажмите кнопку **Загрузить данные**. [Пример CSV-файла для удаления данных](https://download.cdn.yandex.net/from/yandex.com/support/en/metrica/files/delete-data-example.csv) {% endlist %} Сервис обрабатывает файл в течение некоторого времени. После завершения обработки переданная информация доступна в отчете Параметры посетителей. [Написать в чат](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) || |#
[*ClientID]: Идентификатор уникального посетителя сайта, который Яндекс Метрика задает автоматически. [*UserID]: Идентификатор посетителя сайта, заданный владельцем сайта, например при входе посетителя сайта в личный кабинет. [*Идентификатор-посетителя-сайта,-заданный-владельцем-сайта,-например-при-входе-посетителя-сайта-в-личный-кабинет]: Идентификатор посетителя сайта, заданный владельцем сайта, например при входе посетителя сайта в личный кабинет. [*Идентификатор-уникального-посетителя-сайта,-который-Яндекс-Метрика-задает-автоматически]: Идентификатор уникального посетителя сайта, который Яндекс Метрика задает автоматически.