Структура сеанса пользователя
На этой странице представлены описания всех возможных полей, которые может включать пользовательский сеанс.
Имейте в виду, что в Ключ-АСТРОМ версии 1.204 мы представили новые счетчики ошибок в USQL и экспорте сеансов для каждого действия пользователя, которые полностью согласуются с Ключ-АСТРОМ. В свою очередь, в Ключ-АСТРОМ версии 1.217 мы перестанем поддерживать следующие счетчики ошибок:
useraction.errorCount
— Включает только ошибки JavaScript.useraction.httpRequestsWithErrors
— Учитывает только ошибки на стороне сервера.useraction.failedXHRRequests
— Учитываются только неудачные вызовы XHR, сделанные в браузере вашего конечного пользователя.useraction.failedImages
— Будет включено в новыйrequestErrorCount
. Узнайте больше о том, как лучше всего заменить существующие счетчики ошибок новыми.
Объект UserSession
Сеанс пользователя , охватывающий несколько действий пользователя и дополнительную информацию о посещении пользователя.
Элемент | Тип | Описание |
---|---|---|
tenantId | string | Идентификатор среды Ключ-АСТРОМ, которая зафиксировала сеанс пользователя.
Это поле не может быть запрошено с помощью языка запросов сеанса пользователя. |
userSessionId | string | Уникальный идентификатор сеанса пользователя. |
startTime | integer | Отметка времени первого действия пользователя в сеансе пользователя в миллисекундах UTC. |
endTime | integer | Отметка времени последнего действия пользователя в сеансе пользователя в миллисекундах UTC. |
duration | integer | Продолжительность сеанса пользователя в миллисекундах.
Это рассчитывается как количество времени между началом первого действия пользователя и окончанием последнего действия пользователя. |
internalUserId | string | Уникальный идентификатор пользователя, запустившего пользовательский сеанс. |
userType | string | Тип пользователя. Обозначает реального пользователя-человека ( REAL_USER ) или робота ( ROBOT или SYNTHETIC ).
Элемент может содержать эти значения
|
reasonForNoSessionReplay | string | Причина отсутствия повтора сеанса.
Элемент может содержать эти значения
|
reasonForNoSessionReplayMobile | string | Причина отсутствия повтора сеанса на мобильном телефоне.
Элемент может содержать эти значения
|
applicationType | string | Тип приложения, используемого в сеансе пользователя.
Элемент может содержать эти значения
|
bounce | boolean | Сеанс пользователя имеет ( true ) или не имеет ( false ) возврат.
Отказ означает, что в пользовательском сеансе есть только одно (или меньше) действие пользователя. |
newUser | boolean | Пользователь является новым ( true ) или постоянным пользователем ( false ).
|
userActionCount | integer | Количество действий пользователя в сеансе пользователя. |
totalErrorCount | integer | Количество ошибок, обнаруженных в сеансе пользователя. |
totalLicenseCreditCount | integer | Количество единиц DEM, потребляемых сеансом. |
matchingConversionGoalsCount | integer | Количество целей конверсии, достигнутых сеансом пользователя. |
matchingConversionGoals | string[] | Список целей конверсии, достигнутых сеансом пользователя.
Кроме того, вы можете определить цели конверсии для одного действия пользователя. |
ip | string | IP-адрес (IPv4 или IPv6), с которого начинается сеанс пользователя. |
continent | string | Континент, с которого начинается пользовательский сеанс (на основе IP-адреса). |
country | string | Страна, из которой происходит пользовательский сеанс (на основе IP-адреса). |
region | string | Регион, из которого исходит пользовательский сеанс (на основе IP-адреса). |
city | string | Город, из которого исходит пользовательский сеанс (на основе IP-адреса). |
browserType | string | Тип браузера, используемого для сеанса пользователя. |
browserFamily | string | Семейство браузера, используемого для сеанса пользователя. |
browserMajorVersion | string | Версия браузера, используемая для сеанса пользователя. |
osFamily | string | Тип операционной системы, используемой для пользовательского сеанса. |
osVersion | string | Версия операционной системы, используемой для пользовательского сеанса. |
manufacturer | string | Обнаруженный производитель устройства, используемого для сеанса пользователя. |
device | string | Обнаруженное устройство, используемое для сеанса пользователя. |
userId | string | Идентификатор пользователя, предоставленный для сеанса пользователя тегами сеанса. |
screenHeight | integer | Обнаруженная высота экрана устройства, используемого для пользовательского сеанса. |
screenWidth | integer | Обнаруженная ширина экрана устройства, используемого для пользовательского сеанса. |
screenOrientation | string | Обнаруженная ориентация экрана устройства, используемого на устройстве для пользовательского сеанса.
Элемент может содержать эти значения
|
displayResolution | string | Обнаруженное разрешение экрана устройства, используемого для пользовательского сеанса.
Элемент может содержать эти значения
|
hasCrash | boolean | Сеанс пользователя включает ( true ) или не включает ( false ) сбой.
|
crashGroupId | string | В случае сбоя мобильного сеанса это идентификатор группы, к которой принадлежит этот сеанс.
Если сеанс не завершился сбоем или сеанс не является мобильным сеансом, он имеет |
hasSessionReplay | boolean | Воспроизведение сеанса доступно ( true ) или недоступно ( false ) для сеанса.
|
isp | string | Интернет-провайдер, от которого исходит пользовательский сеанс (на основе IP-адреса). |
clientType | string | Дополнительная информация о клиенте.
Это поле не может быть запрошено с помощью языка запросов сеанса пользователя. Вместо этого используйте поле browserType . |
browserMonitorId | string | Идентификатор монитора синтетического браузера, создавшего сеанс. |
browserMonitorName | string | Имя монитора синтетического браузера, создавшего сеанс. |
stringProperties | StringProperty[] | Список пользовательских свойств сеанса пользователя со строковыми значениями. |
longProperties | LongProperty[] | Список пользовательских свойств сеанса пользователя с целочисленными (короткими или длинными) значениями. |
doubleProperties | DoubleProperty[] | Список пользовательских свойств сеанса пользователя с числовыми значениями с плавающей запятой. |
dateProperties | DateProperty[] | Список пользовательских свойств сеанса пользователя со значениями даты. |
userActions | UserSessionUserAction[] | Список действий пользователя, записанных в сеансе пользователя. |
events | UserSessionEvents[] | Список дополнительных событий, записанных в сеансе пользователя. |
errors | UserSessionErrors[] | Список ошибок, зафиксированных в сеансе пользователя. |
syntheticEvents | UserSessionSyntheticEvent[] | Список синтетических событий, записанных в сеансе пользователя. |
appVersion | string | Версия приложения, в которой был записан сеанс пользователя.
Эта информация предоставляется другой интеграцией, такой как OpenKit. |
endReason | string | Причина завершения сеанса пользователя.
Элемент может содержать эти значения
|
numberOfRageClicks | integer | Количество кликов "гнева", обнаруженных в сеансе пользователя. |
numberOfRageTaps | integer | Количество кликов "гнева", обнаруженных в сеансе пользователя. |
userExperienceScore | string | Оценка пользовательского опыта сеанса пользователя.
Элемент может содержать эти значения
|
carrier | string | Информация о носителе сеанса мобильного пользователя. |
networkTechnology | string | Информация о сетевых технологиях сеанса мобильного пользователя. |
connectionType | string | Сериализованный тип соединения сеанса мобильного пользователя.
Элемент может содержать эти значения
|
replayStart | integer | Отметка времени начала повтора сеанса в миллисекундах UTC. |
replayEnd | integer | Отметка времени окончания повтора сеанса в миллисекундах UTC. |
clientTimeOffset | integer | Смещение времени клиента, в миллисекундах |
rootedOrJailbroken | boolean | Мобильное устройство является рутированным/взломанным ( true ) или подлинным ( false ).
Имеет значение, |
hasError | boolean | Сеанс пользователя включает ( true ) или не включает ( false ) ошибку.
|
partNumber | integer | Сеансы пользователей могут быть разделены на несколько частей по различным техническим причинам (например, после 200 действий пользователя). Это partNumber представляет собой количество каждой части общего пользовательского сеанса.
|
Объект StringProperty
Пользовательское свойство действия пользователя со строковым значением.
Элемент | Тип | Описание |
---|---|---|
key | string | Пользовательский ключ свойства. |
value | string | Строковое значение свойства. |
Объект _ LongProperty
Настраиваемое свойство действия пользователя со значением Long.
Элемент | Тип | Описание |
---|---|---|
key | string | Пользовательский ключ свойства. |
value | integer | Длинное значение свойства. |
Объект DoubleProperty
Настраиваемое свойство действия пользователя со значением Double.
Элемент | Тип | Описание |
---|---|---|
key | string | Пользовательский ключ свойства. |
value | number | Числовое значение свойства с плавающей запятой. |
Объект DateProperty
Пользовательское свойство действия пользователя со значением даты.
Элемент | Тип | Описание |
---|---|---|
key | string | Пользовательский ключ свойства. |
value | string | Значение свойства на дату. |
Объект UserSessionUserAction
Действие пользователя.
Действие пользователя — это отдельное действие, выполняемое пользователем в рамках пользовательского сеанса, например клик мышью.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя действия пользователя.
Как правило, это имя страницы, которая загружается как часть действия пользователя, или текстовое описание действия, например клик мышью. |
domain | string | Домен DNS, в котором было записано действие пользователя. |
targetUrl | string | Целевой URL действия пользователя. |
type | string | Тип действия пользователя.
Элемент может содержать эти значения
|
startTime | integer | Отметка времени начала действия пользователя в миллисекундах UTC. |
endTime | integer | Отметка времени окончания действия пользователя в миллисекундах UTC. |
duration | integer | Продолжительность действия пользователя в миллисекундах.
Это рассчитывается как время между отметками времени начала и окончания действия пользователя. |
application | string | Имя приложения, в котором было записано действие пользователя. |
internalApplicationId | string | Идентификатор объекта Ключ-АСТРОМ для приложения, в котором было записано действие пользователя.
Эта информация полезна при вызове различных REST API, например, в качестве ключа для запросов временных рядов. |
internalKeyUserActionId | string | Идентификатор объекта Ключ-АСТРОМ ключевого действия пользователя. |
speedIndex | integer | Индекс скорости действия пользователя в миллисекундах.
Рассчитывается как среднее время, необходимое для отображения всех видимых частей страницы. |
apdexCategory | string | Индекс пользовательского опыта действия пользователя.
Элемент может содержать эти значения
|
matchingConversionGoals | string[] | Список целей конверсии, достигнутых действием пользователя.
Кроме того, вы можете определить цели конверсии для сеанса пользователя в целом. |
networkTime | integer | Количество времени, потраченное на передачу данных для действия пользователя, в миллисекундах. |
serverTime | integer | Количество времени, затраченное на серверную обработку действия пользователя, в миллисекундах. |
frontendTime | integer | Количество времени, затрачиваемое на отрисовку внешнего интерфейса для действия пользователя, в миллисекундах. |
documentInteractiveTime | integer | Количество времени, затраченное на то, чтобы документ для действия пользователя стал интерактивным, в миллисекундах. |
thirdPartyResources | integer | Количество сторонних ресурсов, загруженных для действия пользователя. |
thirdPartyBusyTime | integer | Время, затраченное на ожидание сторонних ресурсов для действия пользователя, в миллисекундах. |
cdnResources | integer | Количество ресурсов, извлеченных из CDN для действия пользователя. |
cdnBusyTime | integer | Время, затраченное на ожидание ресурсов CDN для действия пользователя, в миллисекундах. |
firstPartyResources | integer | Количество ресурсов, полученных с исходного сервера для действия пользователя. |
firstPartyBusyTime | integer | Время, затраченное на ожидание ресурсов исходного сервера для действия пользователя, в миллисекундах. |
hasCrash | boolean | Действие пользователя имеет ( true ) или не имеет ( false ) сбой.
|
domCompleteTime | integer | Время до завершения дерева DOM в миллисекундах. |
domContentLoadedTime | integer | Время до загрузки дерева DOM в миллисекундах. |
loadEventStart | integer | Время до начала события загрузки в миллисекундах. |
loadEventEnd | integer | Время до завершения события загрузки в миллисекундах. |
navigationStart | integer | Отметка времени начала навигации в миллисекундах UTC. |
requestStart | integer | Время до запуска запроса в миллисекундах. |
responseStart | integer | Время до начала ответа в миллисекундах. |
responseEnd | integer | Время до завершения ответа в миллисекундах. |
visuallyCompleteTime | integer | Время до визуального завершения страницы в миллисекундах. |
syntheticEvent | string | Имя искусственного события , вызвавшего действие пользователя. |
syntheticEventId | string | Идентификатор синтетического события , вызвавшего действие пользователя. |
keyUserAction | boolean | Действие является ( true ) или не является ( false ) ключевым действием.
|
stringProperties | StringProperty[] | Список пользовательских свойств сеанса пользователя со строковыми значениями. |
longProperties | LongProperty[] | Список пользовательских свойств сеанса пользователя с целочисленными (короткими или длинными) значениями. |
doubleProperties | DoubleProperty[] | Список пользовательских свойств сеанса пользователя с числовыми значениями с плавающей запятой. |
dateProperties | DateProperty[] | Список пользовательских свойств сеанса пользователя со значениями даты. |
userActionPropertyCount | integer | Общее количество свойств в действии пользователя. |
customErrorCount | integer | Общее количество пользовательских ошибок во время действия пользователя. |
javascriptErrorCount | integer | Общее количество ошибок Javascript во время действия пользователя. |
requestErrorCount | integer | Общее количество ошибок запроса во время действия пользователя. |
largestContentfulPaint | integer | Самая большая отрисовка содержимого (LCP) — это время (в миллисекундах), которое потребовалось для отображения самого большого элемента на странице.
LCP — важная ориентированная на пользователя метрика для измерения скорости загрузки. Он отмечает момент, когда основное содержимое страницы, вероятно, загружено. Низкий LCP указывает на то, что страница загружается быстро. |
firstInputDelay | integer | Задержка первого ввода (FID) — это время (в миллисекундах), которое потребовалось браузеру для ответа на первый ввод пользователя.
FID является важной ориентированной на пользователя метрикой для измерения реакции на нагрузку. Он количественно оценивает взаимодействие с пользователем при попытке взаимодействия с неотвечающими страницами. Низкий FID указывает на то, что страницу можно использовать. |
totalBlockingTime | integer | Общее время блокировки — это общее время (в миллисекундах) между первой отрисовкой содержимого и временем перехода в интерактивный режим, в течение которого браузер был заблокирован достаточно долго, чтобы предотвратить реакцию на ввод. |
cumulativeLayoutShift | number | Кумулятивный сдвиг макета (CLS) — это общая сумма всех отдельных баллов для каждого неожиданного изменения макета, которое происходит в течение всего срока службы страницы.
CLS — важная ориентированная на пользователя метрика для измерения визуальной стабильности. Он определяет, как часто пользователи сталкиваются с неожиданными изменениями макета. Низкий CLS указывает на то, что страница восхитительна. |
Объект UserSessionEvents
Внешнее событие сеанса пользователя.
Элемент | Тип | Описание |
---|---|---|
type | string | Тип события.
Элемент может содержать эти значения
|
name | string | Название события. |
domain | string | Домен DNS, в котором было записано событие. |
startTime | integer | Отметка времени события в миллисекундах UTC. |
application | string | Имя приложения на основе настроенных правил обнаружения. |
internalApplicationId | string | Идентификатор объекта Ключ-АСТРОМ для приложения.
Эта информация полезна при вызове различных REST API, например, в качестве ключа для запросов временных рядов. |
metadata | string | Метаданные, прикрепленные к событию. |
page | string | Имя страницы, на которую перешел пользователь во время события смены страницы. |
pageGroup | string | Группа страниц автоматически создается из страницы. |
pageReferrer | string | Имя предыдущей страницы, с которой пользователь перешел во время события смены страницы. |
pageReferrerGroup | string | Группа реферера страницы автоматически получается из реферера страницы. |
Объект UserSessionErrors
Ошибка сеанса пользователя.
Элемент | Тип | Описание |
---|---|---|
type | string | Тип ошибки.
Элемент может содержать эти значения
|
name | string | Название ошибки. |
domain | string | Домен DNS, в котором была зарегистрирована ошибка. |
startTime | integer | Отметка времени ошибки в миллисекундах UTC. |
application | string | Имя приложения на основе настроенных правил обнаружения. |
internalApplicationId | string | Идентификатор объекта Ключ-АСТРОМ для приложения.
Эта информация полезна при вызове различных REST API, например, в качестве ключа для запросов временных рядов. |
Объект UserSessionSyntheticEvent
Синтетическое событие сеанса пользователя.
Элемент | Тип | Описание |
---|---|---|
name | string | Имя синтетического события. |
syntheticEventId | string | Идентификатор объекта Ключ-АСТРОМ для синтетического события. |
sequenceNumber | integer | Порядковый номер синтетического события в рамках всего монитора браузера. |
timestamp | integer | Отметка времени моделирования искусственного события в миллисекундах UTC. |
type | string | Тип синтетического события. Например, клик или нажатие клавиши. |
errorCode | integer | Код ошибки, возникшей во время этого события. |
errorName | string | Описание ошибки, возникшей во время этого события. |