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

2026-08-19T18:12:14Z

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

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

= Захват свойств событий и сессий для мобильных интерфейсов =

Используйте свойства событий и сессий, чтобы обогатить данные '''RUM''' контекстом бизнеса или приложения и настроить мониторинг в соответствии с вашими целями. Вы можете работать с ними следующими способами:

* Отправляйте данные о свойствах через API — передавайте любые доступные в вашем приложении данные в качестве свойств событий или сессий.
* Обогащайте свойства в '''OpenPipeline''' — агрегируйте свойства сессии из свойств события или устанавливайте идентификатор пользователя во время приема данных.

== Сообщайте о свойствах объектов недвижимости через API ==

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

=== Разрешить свойства, передаваемые через API ===

Чтобы разрешить использование заявленного свойства:

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Мобильные устройства''', чтобы просмотреть все мобильные версии сайта.
# Выберите интерфейс, который хотите настроить.
# На вкладке '''Настройки''' выберите '''Свойства захвата'''.
# В разделе '''Разрешенные свойства, передаваемые через API''' выберите '''Новое свойство'''.
# Введите ключ свойства.
# Если вы хотите, чтобы проверка ключа свойства игнорировала регистр, включите параметр '''Проверка ключа свойства должна быть нечувствительной к регистру'''.

=== Отправка свойств события и сессии ===

Свойства событий и сессий можно передавать через новые API '''RUM''':

* Для добавления свойства события используйте <code>addEventModifier</code>.
* Для отправки свойства сессии используйте <code>sendSessionPropertyEvent</code>.

== Агрегировать свойства сессии на основе свойств события ==

Свойства сессии можно получить из свойств события и агрегировать в рамках сессии с помощью '''OpenPipeline'''. Для каждого свойства сессии вы выбираете способ агрегирования значений, сообщаемых в течение сессии:

* Для любого типа свойства можно указать либо '''Первое значение''', либо '''Последнее значение'''. По умолчанию используется '''Последнее значение'''.
* Для числовых свойств можно дополнительно использовать '''Min''', '''Max''', '''Avg''' или '''Sum'''.

Для объединения свойств сессии и свойств событий:

# Перейдите в '''Настройки''' > '''Обработка и контекстуализация''' > '''OpenPipeline''' > '''Пользовательские события''' > '''Конвейеры'''.
# Выберите существующий конвейер или создайте новый. Чтобы создать новый конвейер, выберите '''Конвейер''' и введите имя.
# Перейдите в раздел '''Обработка''' > '''Добавить''' (или, если обработчики уже определены) > '''DQL''' и определите обработчик:
#* Описательное название — например, <code>Derive session property from cart value</code>
#* Условие соответствия — фильтр для событий, обладающих свойством события, например:
<pre>isNotNull(event_properties.cart.total_value)</pre>
#* Определение DQL-процессора — два оператора <code>fieldsAdd</code>: первый записывает значение свойства события в пространство имен свойств сессии, а второй объявляет метод агрегации, например:
<pre>
fieldsAdd session_properties.cart.total_value = event_properties.cart.total_value,
session_properties_aggregation.cart.total_value = "Max"
</pre>

Значение агрегации представляет собой строку. Допустимые значения: <code>"First"</code>, <code>"Last"</code>, <code>"Min"</code>, <code>"Max"</code>, <code>"Avg"</code> и <code>"Sum"</code>. <code>"Min"</code>, <code>"Max"</code>, <code>"Avg"</code> и <code>"Sum"</code> применяются только к числовым свойствам. Вы можете опустить строку агрегации <code>fieldsAdd</code>, чтобы использовать значение по умолчанию (<code>"Last"</code>).

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

С помощью '''OpenPipeline''' вы можете получить идентификатор пользователя для сессии из свойства захваченного или зарегистрированного события. Это позволяет установить идентификатор пользователя из данных приложения, в качестве альтернативы вызову метода <code>identifyUser</code>.

Чтобы заполнить идентификатор пользователя из свойства события:

# Перейдите в '''Настройки''' > '''Обработка и контекстуализация''' > '''OpenPipeline''' > '''Пользовательские события''' > '''Конвейеры'''.
# Выберите существующий конвейер или создайте новый. Чтобы создать новый конвейер, выберите '''Конвейер''' и введите имя.
# Перейдите в раздел '''Обработка''' > '''Добавить''' (или, если обработчики уже определены) > '''DQL''' и определите обработчик:
#* Описательное название — например, <code>Set user identifier from username</code>
#* Условие соответствия — фильтр для событий, обладающих свойством события, например:
<pre>isNotNull(event_properties.username)</pre>
#* Определение процессора DQL:
<pre>fieldsAdd user.identifier = event_properties.username</pre>

Возможно, вы увидите предупреждение, поскольку <code>user.identifier</code> это поле входит в предопределенный набор полей <code>builtin-sensitive-user-events-and-sessions</code>. Тем не менее, вы можете использовать его для обогащения данных. Подробную информацию о контроле доступа к конфиденциальным полям см. в разделе «Разрешения для полей».

== Пределы ==

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

* Имя поля может иметь максимальную длину 100 символов, включая префикс <code>event_properties.</code> или <code>session_properties.</code>.
* Имя поля может содержать только буквы (<code>A–Z</code>, <code>a–z</code>), цифры (<code>0–9</code>), подчеркивания (<code>_</code>) и точки (<code>.</code>). Например: <code>event_properties.cart.total_value</code>.
* На одном интерфейсе можно разрешить передачу до 200 свойств через API.
* В рамках одного события можно отправить до 50 свойств.
* В каждую сессию можно добавить до 500 свойств сессии.
* Значения свойств должны быть примитивного типа: <code>String</code>, <code>Int</code>, <code>Long</code>, <code>Double</code> или <code>Boolean</code>.
* Строковые значения могут иметь максимальную длину в 1000 символов.

== Связанные темы ==

* Настройка мониторинга мобильного интерфейса с помощью API '''RUM'''.
* Модель данных '''RUM'''
* '''OpenPipeline'''

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