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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. Перейдите в Настройки > Обработка и контекстуализация > OpenPipeline > Пользовательские события > Конвейеры.
2. Выберите существующий конвейер или создайте новый. Чтобы создать новый конвейер, выберите Конвейер и введите имя.
3. Перейдите в раздел Обработка > Добавить (или, если обработчики уже определены) > DQL и определите обработчик:
   • Описательное название — например, Derive session property from cart value
   • Условие соответствия — фильтр для событий, обладающих свойством события, например:

isNotNull(event_properties.cart.total_value)

1. • Определение DQL-процессора — два оператора fieldsAdd: первый записывает значение свойства события в пространство имен свойств сессии, а второй объявляет метод агрегации, например:

fieldsAdd session_properties.cart.total_value = event_properties.cart.total_value,
  session_properties_aggregation.cart.total_value = "Max"

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

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

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

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

1. Перейдите в Настройки > Обработка и контекстуализация > OpenPipeline > Пользовательские события > Конвейеры.
2. Выберите существующий конвейер или создайте новый. Чтобы создать новый конвейер, выберите Конвейер и введите имя.
3. Перейдите в раздел Обработка > Добавить (или, если обработчики уже определены) > DQL и определите обработчик:
   • Описательное название — например, Set user identifier from username
   • Условие соответствия — фильтр для событий, обладающих свойством события, например:

isNotNull(event_properties.username)

1. • Определение процессора DQL:

fieldsAdd user.identifier = event_properties.username

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

Пределы

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

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

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

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