IKuznetsov: Новая страница: «= Настройка захвата взаимодействия пользователя с веб-интерфейсами = '''Ранний доступ''' '''RUM''' Ключ-АСТРОМ позволяет фиксировать действия пользователей, такие как клики и прокрутка, и преобразовывать их в полезную аналитическую информацию: * С помощью...»

2026-08-19T15:39:45Z

Новая страница: «= Настройка захвата взаимодействия пользователя с веб-интерфейсами = '''Ранний доступ''' '''RUM''' Ключ-АСТРОМ позволяет фиксировать действия пользователей, такие как клики и прокрутка, и преобразовывать их в полезную аналитическую информацию: * С помощью...»

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

= Настройка захвата взаимодействия пользователя с веб-интерфейсами =

'''Ранний доступ'''

'''RUM''' Ключ-АСТРОМ позволяет фиксировать действия пользователей, такие как клики и прокрутка, и преобразовывать их в полезную аналитическую информацию:

* С помощью приложения '''Пользователи и сессии''' вы можете просмотреть все взаимодействия пользователей, произошедшие во время пользовательской сессии. Это особенно полезно для служб поддержки клиентов и разработчиков при диагностике проблем или ошибок, возникающих у клиентов.
* Анализ взаимодействия пользователей с помощью '''DQL''' позволяет понять закономерности поведения в широком диапазоне сценариев использования; см. раздел «Анализ поведения пользователей с помощью DQL».

В период раннего доступа к данным о взаимодействии с пользователями дополнительная плата за их обработку не взимается. Запросы к данным о взаимодействии с пользователями также включены без дополнительной платы, поскольку запросы к необработанным данным '''RUM''' в настоящее время находятся в режиме раннего доступа; см. раздел «Расчет потребления данных мониторинга реальных пользователей и синтетического мониторинга — Запрос».

== Активировать запись взаимодействий пользователя ==

Для фиксации взаимодействия пользователей:

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Веб''', чтобы просмотреть все веб-интерфейсы.
# Выберите интерфейс, который хотите настроить.
# Перейдите во вкладку '''Настройки'''.
# В разделе '''Включение и контроль затрат''' включите '''Взаимодействие с пользователем'''.

== Типы взаимодействия пользователей ==

В таблице ниже представлен обзор доступных типов взаимодействия с пользователем. Подробное описание см. в разделе «Взаимодействие с пользователем» в семантическом словаре.

{| class="wikitable"
|-
! Тип взаимодействия пользователя !! Описание
|-
| Нажмите || Когда пользователь щелкает или касается '''HTML'''-элемента. Обратите внимание, что касание '''HTML'''-элемента регистрируется как щелчок.
|-
| Нажатие клавиши || Когда пользователь нажимает комбинацию клавиш или определенные отдельные клавиши; см. раздел «Запись нажатий клавиш».
|-
| Масштабирование / изменение размера || Когда пользователь увеличивает или уменьшает масштаб, или изменяет размер области просмотра.
|-
| Фокусировка / размытие || Когда пользователь фокусируется на '''HTML'''-элементе или покидает его. Эти типы взаимодействия с пользователем фиксируются только в том случае, если вы дали на это согласие.
|-
| Изменять || Когда пользователь изменяет значение в поле формы, например, устанавливая флажок.
|-
| Прокрутка || Когда пользователь прокручивает страницу или элемент интерфейса.
|-
| Перетаскивание || Когда пользователь начинает или заканчивает операцию перетаскивания. Также фиксируются допустимые действия по перемещению файлов извне, например, перетаскивание файла в область загрузки. В обоих случаях записывается положение файла.
|-
| Наведение курсора мыши || Когда пользователь наводит курсор на '''HTML'''-элемент. Этот тип взаимодействия с пользователем регистрируется только в том случае, если вы дали на это согласие.
|}

== Захват нажатия клавиши ==

Нажатие клавиш регистрируется для комбинаций, включающих клавиши <code>Ctrl</code> или <code>Meta</code> (<code>Windows</code> или <code>Cmd</code>). Запись происходит при одновременном удержании клавиши <code>Ctrl</code> или <code>Cmd</code>, но комбинации, включающие только <code>Alt</code>, не регистрируются. Все клавиши, нажатые одновременно с <code>Ctrl</code> или <code>Cmd</code>, объединяются в одно событие в поле <code>keys</code>. Удержание клавиши не генерирует повторных событий — срабатывает только первое нажатие клавиши.

Помимо комбинаций клавиш, при нажатии без <code>Ctrl</code> или <code>Cmd</code> фиксируются и некоторые отдельные клавиши:

* <code>Enter</code> и <code>Tab</code> фиксируются для всех целей.
* <code>Escape</code> и <code>Space</code> фиксируются.
* <code>Backspace</code> и <code>Delete</code> не фиксируются для редактируемых элементов, таких как <code><input></code> элементы, принимающие текстовый ввод, <code><textarea></code> и элементы с <code>contentEditable="true"</code>.
* Для предотвращения спама событий все отдельные события нажатия клавиш ограничиваются 500 мс на каждый уникальный ключ.
* Активация кнопок и ссылок — например, нажатие <code>Enter</code> на кнопку — запускает синтетические события клика в браузере. В этом случае фиксируется только событие нажатия клавиши, а событие клика игнорируется.

== Типы взаимодействия пользователей с согласия пользователя ==

Большинство типов взаимодействия с пользователем автоматически фиксируются после активации функции захвата взаимодействия с пользователем. Однако для некоторых типов взаимодействия требуется явное согласие путем добавления специальных атрибутов к соответствующим '''HTML'''-элементам. Эти атрибуты позволяют захватывать события, но не влияют на поведение элемента.

=== Фокусировка/Размытие ===

Для захвата фокуса и размытия взаимодействия с пользователем добавьте атрибуты <code>data-dt-focus</code> и <code>data-dt-blur</code> к соответствующим '''HTML'''-элементам. Атрибут может быть пустым или иметь значение; оба варианта <code>data-dt-focus</code> и <code>data-dt-focus="true"</code> допустимы.

'''Примеры'''
<pre>

<input data-dt-focus type="text" placeholder="Поиск товаров...">


<form>
<input data-dt-focus name="email" type="email" placeholder="Email">
<input data-dt-focus name="password" type="password" placeholder="Password">
<button type="submit">Войти</button>
</form>


<div data-dt-focus tabindex="0" role="button">Пользовательская кнопка</div>


<textarea data-dt-focus data-dt-blur placeholder="Ваш отзыв..."></textarea>


<input data-dt-focus data-dt-blur type="search" placeholder="Что вы ищете?">
</pre>

=== Наведение курсора мыши ===

Для отслеживания действий пользователя при наведении курсора мыши добавьте атрибут <code>data-dt-mouse-over="<milliseconds>"</code> к соответствующему '''HTML'''-элементу. Значение атрибута определяет, сколько миллисекунд пользователь должен удерживать курсор над элементом, прежде чем действие будет зафиксировано. При выборе подходящей задержки учитывайте следующие факторы:

* Если вы хотите измерить вовлеченность пользователей в действия, совершаемые с помощью элементов призыва к действию ('''CTA''') или карточек товаров, сколько миллисекунд должно пройти с момента наведения курсора мыши, прежде чем это действие будет считаться преднамеренным?
* Если ваша цель — отслеживать взаимодействие с всплывающими подсказками, то какая задержка требуется вашему приложению до появления этих подсказок?

'''Примеры'''
<pre>

<button data-dt-mouse-over="300">
Узнать больше
</button>


<div class="product-card" data-dt-mouse-over="500">
<img src="product.jpg">
<h3>Премиум-наушники</h3>
<p>299,99 долларов</p>
</div>


<span data-dt-mouse-over="1000">
<i class="info-icon">?</i>
<div class="tooltip">Подробная информация отображается здесь</div>
</span>


<nav>
<div data-dt-mouse-over="200">Товары</div> 
<div data-dt-mouse-over="500">Решения</div> 
<div data-dt-mouse-over="1000">Документация</div> 
</nav>
</pre>

== Настройка ==

Вы можете дополнить зафиксированные взаимодействия пользователей дополнительным контекстом для проведения более целенаправленного анализа.

* Настройте именование элементов пользовательского интерфейса, участвующих во взаимодействии с пользователем; см. раздел «Настройка именования элементов пользовательского интерфейса для взаимодействия с пользователем».
* Сопоставьте взаимодействие пользователей с функциями и компонентами пользовательского интерфейса, чтобы упростить анализ того, как пользователи взаимодействуют с вашим приложением; см. раздел «Сопоставление взаимодействия пользователей с функциями и компонентами пользовательского интерфейса».
* Когда элементы пользовательского интерфейса отображаются вне своего логического '''DOM'''-родителя (например, модальные окна и порталы), укажите логического предка, чтобы обеспечить корректное наследование атрибутов; см. раздел «Указание логического предка для взаимодействия с пользователем».

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