Try it free

User interactions

  • Latest Dynatrace
  • Reference

User interaction events capture specific user interactions such as clicks, scrolls, and other gestures within the application.

User interaction

A user interaction represents a standalone activity, such as a click or tap, performed by a user in an application. User interactions are captured independently of any resulting requests, which are included in user actions. Supported by RUM JavaScript and OneAgent for Mobile.

User event characteristics and common fields

AttributeTypeDescriptionExamples

characteristics.classifier

string

experimentalFixed value user_interaction.

user_interaction

characteristics.has_user_interaction

boolean

stableFixed value true.

true

dom_event.is_trusted

boolean

experimentalInteraction is genuine from real user and not a synthetic event.

true

interaction.name

string

**deprecatedReplaced with interaction.type.**Type of action performed by the user.

click

interaction.type

string

experimentalType of action performed by the user.

click

positions

record[]

experimentalArray of {x,y, (start_time)} positions of the mouse or finger. Time units are nanoseconds. Mandatory for click, touch, mouse_over, scroll, long_press, drag, drop, zoom.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400, 'start_time:500': None}, {'x': 200, 'y': 450, 'start_time:900': None}]

Blur events

interaction.name = blur

Only if attribute data-dt-blur is present

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Change events

interaction.name = change

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

UI element value fields

AttributeTypeDescriptionExamples

ui_element.value.content

string

experimentalContent of the form field. Field only captured if the DOM attribute data-dt-content is present.

dark

ui_element.value.length

long

experimentalOnly for some form elements: input and textarea. Length of the value.

89

ui_element.value.selection_count

long

experimentalOnly for some form elements: checkbox, select, etc. Count of selected elements where more than one is possible.

4

ui_element.value.type

string

experimentalType of the form field.

radio; password

ui_element.value.validity

string

experimentalStatus of the validity for the given field

valid; tooShort

Form element fields

AttributeTypeDescriptionExamples

form_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

form_element.component

string

deprecatedReplaced with form_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

form_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

form_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

form_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

form_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

form_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

form_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

form_element.name_origin

string

experimentalField used to fill form_element.name.

title; name; id; content; value

form_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

form_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Label element fields

AttributeTypeDescriptionExamples

label_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

label_element.component

string

deprecatedReplaced with label_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

label_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

label_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

label_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

label_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

label_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

label_element.name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

label_element.name_origin

string

experimentalField used to fill label_element.name.

title; name; id; content; value

label_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

label_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Click events

interaction.name = click

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Mouse button fields

AttributeTypeDescriptionExamples

mouse_button

long

experimentalMouse button used for the click interaction. Follows Mouse Button definition.

0

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drag events

interaction.name = drag
ui_element.* refers to the dragged object

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Drag resolve fields

AttributeTypeDescriptionExamples

drag_resolve

string

experimentalResult of the drag action.

valid_drop

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drop events

interaction.name = drop
ui_element.* refers to the landing object
drag_element.* refers to the dragged object

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Drag element fields

AttributeTypeDescriptionExamples

drag_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

drag_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

drag_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

drag_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

drag_element.ancestor.component

string

deprecatedReplaced with drag_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

drag_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['UIButtonLabel']

drag_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if drag_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

drag_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if drag_element has no name or custom_name.

Add to cart; Homepage logo

drag_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if drag_element has no name or custom_name.

['filter', 'menu']

drag_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

drag_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

drag_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if drag_element has no name or custom_name.

Add to cart; Homepage logo

drag_element.ancestor.name_origin

string

experimentalField used to fill drag_element.ancestor.name. Only available if drag_element has no name or custom_name.

title; name; id; content; value

drag_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if drag_element has no name or custom_name.

['theme:dark', 'expanded:true']

drag_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

drag_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if drag_element has no name or custom_name.

div; CartFragment

drag_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

drag_element.component

string

deprecatedReplaced with drag_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

drag_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

drag_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

drag_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

drag_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". In case of file, use mime type as name. In case of multiple files, use a stringified array of mime types. In case of unknown element, use "Unknown".

Add to cart; Homepage logo

drag_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

drag_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

drag_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

drag_element.name

string

experimentalName of the element taken from the following fields by priority: drag_element.custom_name, drag_element.name, drag_element.ancestor.custom_name, drag_element.ancestor.name

Add to cart; Homepage logo

drag_element.name_origin

string

experimentalField used to fill drag_element.name.

title; name; id; content; value

drag_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

drag_element.resolved_name

string

deprecatedReplaced with drag_element.nameName of the element taken from the following fields by priority: drag_element.custom_name, drag_element.name, drag_element.ancestor.custom_name, drag_element.ancestor.name

Add to cart; Homepage logo

drag_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

drag_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. In case of external file it should be data. In case of unknown origin, like external HTML is should be unknown.

div; CartFragment

drag_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Focus events

interaction.name = focus

Only if attribute data-dt-focus is present

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Key press events

interaction.name = key_press

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Keys fields

AttributeTypeDescriptionExamples

keys

string[]

experimentalKey or combination of keys pressed by the user. In web only combinations of keys including ctrl, cmd or esc, and standalone esc, enter and tab. In mobile system keys.

['ctrl', 'alt', 's']; ['Tab']

Long press events

interaction.name = long_press

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Duration fields

AttributeTypeDescriptionExamples

duration

duration

experimentalThe difference between start_time and end_time in nanoseconds.

42

Mouse over events

interaction.name = mouse_over

Only if attribute data-dt-mouse-over="x" is present and x is the amount of ms required before sending it.

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Duration fields

AttributeTypeDescriptionExamples

duration

duration

experimentalThe difference between start_time and end_time in nanoseconds.

42

Resize events

interaction.name = resize

Scroll events

interaction.name = scroll

Only for mobile: pointer_positions are required

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Scroll position fields

AttributeTypeDescriptionExamples

scroll_position.x

long

deprecatedReplaced by positionsDelta on horizontal scroll associated to element.scrollLeft.

200

scroll_position.y

long

deprecatedReplaced by positionsDelta on vertical scroll associated to element.scrollTop.

200

Scroll parent fields

AttributeTypeDescriptionExamples

scroll_target.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

scroll_target.id

string[]

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

['UIButtonLabel_234']

scroll_target.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Touch events

interaction.name = touch

UI element fields

AttributeTypeDescriptionExamples

ui_element.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.accessibility_id

string

deprecatedFor mobile only. The accessibility ID of the element.

cartButtonID

ui_element.ancestor.alt

string

experimentalFor web and <img> only. Alternative text for an image.

Birds flying over the sea

ui_element.ancestor.component

string

deprecatedReplaced with ui_element.ancestor.componentsFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

UIButtonLabel

ui_element.ancestor.components

string[]

experimentalFor web only. A list of components as coded in the current and ancestor elements in DOM attribute data-dt-component.

['Datepicker', 'Button']

ui_element.ancestor.css_class

string[]

experimentalFor web only. All classes for the ancestor element. Only available if ui_element has no name or custom_name.

['button--primary', 'slideshow__image--selected']

ui_element.ancestor.custom_name

string

experimentalCustom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors. Only available if ui_element has no name or custom_name.

['filter', 'menu']

ui_element.ancestor.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

https://dynatrace.com

ui_element.ancestor.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.ancestor.name

string

experimentalUser interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked". Only available if ui_element has no name or custom_name.

Add to cart; Homepage logo

ui_element.ancestor.name_origin

string

experimentalField used to fill ui_element.ancestor.name. Only available if ui_element has no name or custom_name.

title; name; id; content; value

ui_element.ancestor.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins. Only available if ui_element has no name or custom_name.

['theme:dark', 'expanded:true']

ui_element.ancestor.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.ancestor.tag_name

string

experimentalAncestor element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment. Only available if ui_element has no name or custom_name.

div; CartFragment

ui_element.ancestor.xpath

string[]

experimentalFor web only. The xpath of the user interface element ancestor split as an array.

['//*[@id="cart"]', 'div', 'div']

ui_element.component

string

deprecatedReplaced with ui_element.componentsUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

UIButtonLabel

ui_element.components

string[]

experimentalUsage depends on web or mobile. For web: a list of components as coded in the current and ancestor elements in DOM attribute data-dt-component. For mobile: the type of component. Dependent on the technology and its possibilities.

['Navbar', 'Datepicker']

ui_element.css_class

string[]

experimentalFor web only. All classes for the current element.

['button--primary', 'slideshow__image--selected']

ui_element.custom_name

string

experimentalCustom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute.

Add to cart; Homepage logo

ui_element.detected_name

string

experimentalUser interface element name. Captured by precedence of aria-label > title > name > data-testid > placeholder > content > id. In case it is masked, precedence is aria-label > title > name > data-testid > placeholder > id > "masked".

Add to cart; Homepage logo

ui_element.features

string[]

experimentalGrouping of elements into features filled from the data-dt-features DOM attribute as comma separated values. Inherits all values from all ancestors.

['filter', 'menu']

ui_element.href.full

string

experimentalFor web and <a> only. URL of the link converted to an absolute URL.

/; https://dynatrace.com

ui_element.id

string

experimentalFor mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.name

string

experimentalName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.name_origin

string

experimentalField used to fill ui_element.name.

title; name; id; content; value

ui_element.properties

string[]

experimentalCustom data added in the data-dt-properties DOM attribute. Inherits all values from all ancestors. In case of override, the inner one wins.

['theme:dark', 'expanded:true']

ui_element.resolved_name

string

deprecatedReplaced with ui_element.nameName of the element taken from the following fields by priority: ui_element.custom_name, ui_element.name, ui_element.ancestor.custom_name, ui_element.ancestor.name

Add to cart; Homepage logo

ui_element.responder.components

string[]

experimentalFor mobile only. Relates to the element responding to the interaction. Type of component. Dependent on the technology and its possibilities.

['UIButtonLabel']

ui_element.responder.detected_name

string

experimentalFor mobile only. Relates to the element responding to the interaction. User interface element name of element.

Add to cart; Homepage logo

ui_element.responder.id

string

experimentalFor mobile only. Relates to the element responding to the interaction. Unique identifier of the component. Dependent on the technology and its possibilities.

UIButtonLabel_234

ui_element.responder.name_origin

string

experimentalFor mobile only. Relates to the element responding to the interaction. Field used to fill ui_element.responder.name.

title

ui_element.src.full

string

experimentalFor web and <img> only. Source URL of the image converted to an absolute URL. If the image src is a "data://" url, the field will be "data".

birds_over_sea.png; data

ui_element.tag_name

string

experimentalUser interface element type. For web, it's the tag name. For mobile, it's the name of, for example, the controller or fragment

div; CartFragment

ui_element.xpath

string[]

experimentalFor web only. The xpath of the user interface element split as an array.

['//*[@id="cart"]', 'div', 'div']

Pointer positions fields

AttributeTypeDescriptionExamples

pointer_positions

record[]

deprecatedReplaced by positionsArray of {x,y} positions of the mouse or finger. It could be a single position for a click or a series of them for a slide for instance.

[{'x': 200, 'y': 400}]; [{'x': 200, 'y': 400}, {'x': 200, 'y': 450}]

Zoom events

interaction.name = zoom

Zoom fields

AttributeTypeDescriptionExamples

zoom.level

double

experimentalLevel of zoom applied to the page.

1.5

Basic user event fields

The basic attributes for all user events are defined in the user event base model.