User interactions

  • Reference
  • Published Jan 14, 2026

User interaction

Semantic conventions for standalone user interaction in Dynatrace RUM for web applications.

User event characteristics and common fields

AttributeTypeDescriptionExamples
characteristics.classifierstringexperimental
Fixed value user_interaction.
user_interaction
characteristics.has_user_interactionbooleanexperimental
Fixed value true.
true
dom_event.is_trustedbooleanexperimental
Interaction is genuine from real user and not a synthetic event.
true
interaction.namestringexperimental
Type of action performed by the user.
click
positionsrecord[]experimental
Array 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Change events

interaction.name = change

UI Element

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

UI Element value

AttributeTypeDescriptionExamples
ui_element.value.contentstringexperimental
Content of the form field. Field only captured if the DOM attribute data-dt-content is present.
dark
ui_element.value.lengthlongexperimental
Only for some form elements: input and textarea. Length of the value.
89
ui_element.value.selection_countlongexperimental
Only for some form elements: checkbox, select, etc. Count of selected elements where more than one is possible.
4
ui_element.value.typestringexperimental
Type of the form field.
radio; password
ui_element.value.validitystringexperimental
Status of the validity for the given field
valid; tooShort

Form Element

AttributeTypeDescriptionExamples
form_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
form_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
form_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
form_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
form_element.featuresstring[]experimental
Grouping 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.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
form_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
form_element.name_originstringexperimental
Field used to fill form_element.name.
title; name; id; content; value
form_element.propertiesstring[]experimental
Custom 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Label Element

AttributeTypeDescriptionExamples
label_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
label_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
label_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
label_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
label_element.featuresstring[]experimental
Grouping 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.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
label_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
label_element.name_originstringexperimental
Field used to fill label_element.name.
title; name; id; content; value
label_element.propertiesstring[]experimental
Custom 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Click events

interaction.name = click

UI Element

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Mouse button

AttributeTypeDescriptionExamples
mouse_buttonlongexperimental
Mouse button used for the click interaction. Follows Mouse Button definition.
0

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']
AttributeTypeDescriptionExamples
drag_resolvestringexperimental
Result of the drag action.
valid_drop

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
drag_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
drag_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
drag_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
drag_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
drag_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
drag_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if drag_element has no name or custom_name.
Add to cart; Homepage logo
drag_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
drag_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
drag_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if drag_element has no name or custom_name.
Add to cart; Homepage logo
drag_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
drag_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
drag_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
drag_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
drag_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
drag_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
drag_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > 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.name_originstringexperimental
Field used to fill drag_element.name.
title; name; id; content; value
drag_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For 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

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Keys

AttributeTypeDescriptionExamples
keysstring[]experimental
Key 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
durationdurationexperimental
The 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
durationdurationexperimental
The 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

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Scroll position

AttributeTypeDescriptionExamples
scroll_position.xlongdeprecatedpositions
Delta on horizontal scroll associated to element.scrollLeft.
200
scroll_position.ylongdeprecatedpositions
Delta on vertical scroll associated to element.scrollTop.
200

Scroll parent

AttributeTypeDescriptionExamples
scroll_target.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
scroll_target.idstring[]experimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
['UIButtonLabel_234']
scroll_target.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Touch events

interaction.name = touch

UI Element

AttributeTypeDescriptionExamples
ui_element.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.accessibility_idstringdeprecated
For mobile only. The accessibility ID of the element.
cartButtonID
ui_element.ancestor.altstringexperimental
For web and <img> only. Alternative text for an image.
Birds flying over the sea
ui_element.ancestor.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.ancestor.css_classstring[]experimental
For 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_namestringexperimental
Custom name of the ancestor. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters. Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
https://dynatrace.com
ui_element.ancestor.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.ancestor.namestringexperimental
User interface element name of first element up in the hierarchy with a defined name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked". Only available if ui_element has no name or custom_name.
Add to cart; Homepage logo
ui_element.ancestor.name_originstringexperimental
Field 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.propertiesstring[]experimental
Custom 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.fullstringexperimental
For 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_namestringexperimental
Ancestor 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.xpathstring[]experimental
For web only. The xpath of the user interface element ancestor split as an array.
['//*[@id="cart"]', 'div', 'div']
ui_element.componentstringexperimental
For mobile only. Type of component. Dependent on the technology and its possibilities.
UIButtonLabel
ui_element.css_classstring[]experimental
For web only. All classes for the current element.
['button--primary', 'slideshow__image--selected']
ui_element.custom_namestringexperimental
Custom name of the element. Filled by the data-dt-name or the data-dt-children-name DOM attribute. Limited to 32 characters.
Add to cart; Homepage logo
ui_element.featuresstring[]experimental
Grouping 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.fullstringexperimental
For web and <a> only. URL of the link converted to an absolute URL.
/; https://dynatrace.com
ui_element.idstringexperimental
For mobile only. Unique identifier of the component. Dependent on the technology and its possibilities.
UIButtonLabel_234
ui_element.namestringexperimental
User interface element name. Captured by precedence of aria-label > title > name > data-testid > content > id. In case of content and name, it's cropped to 32 chars. In case it is masked, precedence is aria-label > title > name > data-testid > id > "masked".
Add to cart; Homepage logo
ui_element.name_originstringexperimental
Field used to fill ui_element.name.
title; name; id; content; value
ui_element.propertiesstring[]experimental
Custom 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_namestringexperimental
Name 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.src.fullstringexperimental
For 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_namestringexperimental
User 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.xpathstring[]experimental
For web only. The xpath of the user interface element split as an array.
['//*[@id="cart"]', 'div', 'div']

Pointer positions

AttributeTypeDescriptionExamples
pointer_positionsrecord[]deprecatedpositions
Array 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

AttributeTypeDescriptionExamples
zoom.leveldoubleexperimental
Level of zoom applied to the page.
1.5

Basic user event attributes

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