IKuznetsov: Новая страница: « = Пометка конкретных пользователей для веб-приложений = Одной из ключевых особенностей '''Мониторинга реального пользователя''' является возможность однозначной идентификации отдельных пользователей в разных браузерах, устройствах и пользовательск...»

2026-07-29T02:21:41Z

Новая страница: « = Пометка конкретных пользователей для веб-приложений = Одной из ключевых особенностей '''Мониторинга реального пользователя''' является возможность однозначной идентификации отдельных пользователей в разных браузерах, устройствах и пользовательск...»

Новая страница

= Пометка конкретных пользователей для веб-приложений =

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

С помощью пользовательских тегов можно анализировать поведение и опыт конкретного пользователя через анализ пользовательских сессий. По умолчанию Ключ-АСТРОМ присваивает каждому новому пользователю уникальный случайный идентификатор. Однако вы можете присваивать более содержательные пользовательские теги, состоящие, например, из имени пользователя или адреса электронной почты.

Для веб-приложений пользовательскую маркировку можно настроить с помощью '''JavaScript API RUM''' или метаданных страниц вашего приложения.

= Добавление тегов пользователей через JavaScript API RUM =

Используйте метод <code>identifyUser</code> '''JavaScript API RUM''' для установки пользовательского тега.

= Разметка пользователей на основе источника страницы =

Этот подход работает за счёт сбора доступных данных из исходного кода страницы вашего приложения: имена пользователей или адреса электронной почты довольно часто содержатся в тексте элемента '''DOM''' или переменной '''JavaScript'''. Полный список источников данных страницы приведён ниже в разделе «Доступные типы источников».

Например, в демонстрационном приложении easyTravel имя пользователя отображается в приветственном сообщении в правом верхнем углу главной страницы. Используя инструменты разработки, встроенные в большинство браузеров, вы можете сгенерировать уникальный '''CSS'''-селектор для этого конкретного элемента.

= Доступные типы источников =

* '''CSS-селектор''': Используется, когда идентификатор пользователя виден на странице. Этот механизм захватывает первое значение <code>innerText</code>/<code>textContent</code> совпадения (доступно для браузеров, поддерживающих <code>querySelector</code>). Чтобы получить значение определённого атрибута элемента, добавьте символ '@', за которым следует имя атрибута, например, <code>#someDomElement@someAttribute</code>.
* '''Переменная JavaScript''': Используется, когда идентификатор пользователя доступен в виде переменной '''JavaScript''' в объекте <code>window</code>. Например, если вы укажете переменную JavaScript <code>userName</code>, '''RUM JavaScript''' получит значение из <code>window.userName</code>.
* '''Метатег''': Используется, если идентификатор пользователя присутствует в одном из метатегов в исходном коде страницы. Он указывает имя метатега, которое Ключ-АСТРОМ использует для получения его значения <code>content</code>.
* '''Значение cookie-файла''': Используйте, если идентификатор пользователя присутствует в одном из существующих '''cookie'''-файлов. Если вы хотите использовать их значение cookie в качестве источника данных, убедитесь, что у файлов cookie нет соответствующего атрибута <code>HttpOnly</code>. В противном случае '''JavaScript RUM''' не сможет прочитать значения файлов cookie, поскольку <code>HttpOnly</code> файлы cookie недоступны для '''JavaScript'''.
* '''Строка запроса''': Используется, когда идентификатор пользователя является частью определённого параметра строки запроса, который можно задать здесь.
* '''Атрибут запроса на стороне сервера''': Используйте его, если хотите применить атрибут запроса на стороне сервера для пометки каждой пользовательской сессии. После определения атрибута запроса установите тип источника «Атрибут запроса на стороне сервера». Обратите внимание, что атрибут запроса может не фиксироваться для каждого действия пользователя и пользовательской сессии, поскольку распределённая трассировка на стороне сервера может не фиксироваться из-за адаптивного управления трафиком.

= Добавление правила для пользовательского тега =

После того как вы определили местоположение имён пользователей в исходном коде страницы вашего приложения, можно создать правило для тегов пользователей.

Чтобы добавить правило для тега пользователя:

# Перейдите в раздел '''Веб'''.
# Выберите приложение, которое хотите настроить.
# В правом верхнем углу страницы обзора приложения выберите '''Дополнительно (…)''' > '''Редактировать'''.
# В настройках приложения выберите '''Захват''' > '''Пользовательские теги'''.
# Выберите '''Добавить правило пользовательского тега'''.
# Выберите тип источника и имя источника для этого правила пользовательского тега.
# Необязательно: Включите параметр '''Игнорировать регистр''', если хотите преобразовать пользовательский тег в нижний регистр.
# Необязательно: Для обеспечения корректного извлечения значения имени пользователя включите параметр '''Применить правило очистки''', а затем введите регулярное выражение.
# Выберите '''Добавить правило пользовательского тега'''.

= Проверка конфигурации пользовательского тега =

Чтобы убедиться, что Ключ-АСТРОМ правильно применил конфигурацию пользовательских тегов, сохраните конфигурацию и перезагрузите страницу вашего приложения. После этого проверьте внедрённый JavaScript в обновлённом исходном коде страницы вашего приложения.

Как видно из приведённого ниже примера, <code>md=</code> в выражениях метаданных этой страницы теперь отображается свойство с таким названием.

= Поиск сессий конкретного пользователя =

# Перейдите в раздел '''Сегментация сессии'''.
# Выберите поле фильтра в верхней части страницы и выберите атрибут '''Пользовательский тег'''.
# Выберите пользовательский тег из списка и нажмите '''Применить'''.
На странице '''Пользовательские сессии''' теперь отображается список сессий, относящихся к данному пользователю. Вы можете выбрать конкретную сессию, чтобы просмотреть её подробную информацию. Также можно выбрать имя пользователя, чтобы перейти на страницу обзора этого пользователя.

= Ограничения и примечания =

* В каждое приложение можно добавить до 20 правил для пользовательских тегов.
* Все полученные значения обрезаются до максимальной длины в 100 символов.
* Если вы используете '''JavaScript API RUM''' для идентификации пользователей, API может переопределить любые существующие правила метаданных, которые вы настроили ранее. Пользовательские теги могут переопределять любые другие теги, основанные на метаданных.
* Все настроенные пользовательские теги фиксируются на каждой странице. '''JavaScript RUM''' оценивает каждое отслеживаемое действие пользователя в соответствии с каждым созданным вами правилом для пользовательских тегов, поэтому сводите список правил к минимуму, чтобы уменьшить накладные расходы.
* Последнее действие пользователя в сессии, содержащее тег, используется в качестве тега для всей сессии.
* Настройка конфиденциальности данных '''Не отслеживать''' может повлиять на присвоение тегов пользователям. Если для вашего веб-приложения включена опция '''Соответствовать настройкам браузера "Не отслеживать"''', и у конкретного пользователя эта опция включена в браузере, информация о пользовательском теге не отправляется. Однако если у пользователя опция '''Не отслеживать''' отключена в браузере, его пользовательский тег фиксируется.
* Если ваша организация не разрешает отслеживание действий отдельных пользователей по соображениям конфиденциальности, вы можете альтернативно определить пользовательские теги, соответствующие названиям команд или отделов. Таким образом, вы сможете отслеживать опыт отдельных пользователей, не раскрывая при этом никакой идентифицирующей информации.
```

Пометка конкретных пользователей для веб-приложений - История изменений