For click and focus events on the page, Pendo collects:
- The type of element that was clicked (
- The text inside of elements such as
class(es) of the element
- Other attributes of the element if they exist, including
<button>, we collect
value(the text of the button) and
<img>, we collect
<select>, we collect
<input>, we collect
For privacy reasons, we do not collect text inside of
In addition to the data described above: for the element that was clicked on, we collect the same data for its parent element, and the parent above that, up through the HTML hierarchy to the
Lastly, we collect the document
<title> in load events. Including
excludeTitle: true in your install snippet will prevent this behavior.
Custom HTML Attributes
What are Custom Attributes?
Pendo natively collects the data outlined above. With custom attributes, you can opt to choose specific additional attributes for tracking click events.
This feature affects Analytics only. It was previously possible to utilize any attribute in a custom CSS selector rule for Guide step targeting.
Any features tagged with the custom attribute rules will not be immediately available for retroactive analysis. This is because if a feature is tagged with a rule using a custom attribute today, Pendo will not be able to retrieve any data prior to the date when the custom attribute was added.
How Does It Work?
Here is an example from HTML in an app:
<a class="block-list" target="_blank" data-id="1.0-Nav-Home.Dashboard">
In this example, the only attribute that we could currently latch onto for feature tagging is the
class="block-list". In this instance, that class is not globally unique to that item and would not be specific enough if you wanted to isolate that unique feature. This example site was instrumented with an additional attribute called “data-id” which contains some helpful identifying content, specifically that this "a" tag has the value "1.0-Nav-Home.Dashboard" for "data-id" (a feature that navigates to the home dashboard).
Custom HTML Attributes can be accessed by admins on the Install Settings page under the "Agent Settings" tab.
To begin gathering the
"data-id" attribute, you could choose to track everything beginning with
"data-" with the rule
"data-*" (meaning every attribute that starts with
“data-” will be recorded) or you could target the specific attribute of
"data-id". Pendo will begin collecting the attribute within click events 15 to 30 minutes after entering the rule.