User Experience Analytics data sources for data visualizations

You can show metrics related to Usage Insights in a data visualization component. The available metrics depend on the visualization type.

Note:

Users require the admin, analytics_admin, or analytics_viewer role to add Usage Insights data sources to a visualization.

The Usage Insights application, available in the ServiceNow® Store, provides several data sources.

Events

This data source tracks the events that are triggered on the application. When you select Events as the data source on a visualization, you also must select the application and the event. Apart from this, you can also select the event conditions and specify the event property. For example, you can filter the events based on Country, Manager, Department, Role, etc. In a Bar or Pie/Donut visualization, use the Group by field to select an event property. You can then view the number of occurrences and the values distribution of that single event property.

Note:

The default maximum number of custom filters you can save for user experience analytics application is 500. You can modify the number of custom filters in the uxa.query_builder.max_num_of_user_filter property.

Pages

This data source tracks page views or usage metrics for a specific page on the application. When you select Pages as the data source on a visualization, you must also select the application and the page. Apart from this, you can add custom conditions to filter data for more accurate analysis.

• Page Views
• Average View Duration
• Average Load Time

Sessions

This data source tracks the number of sessions triggered on an application.

When you select this data source on a visualization, you also must select the application and the category. For Single Score visualizations only, you can select a condition as the category. You can add or edit conditions in the condition builder.

• All Sessions: Represents the number of all sessions created on the application.
• New Sessions: Represents the number of sessions that were created in the most recent time period.
• Returning Users: Users who have created more than one session.
• Short sessions: Number of sessions shorter than 20 seconds.
• Long sessions: Number of sessions longer than 300 seconds.
• Custom: You define this category by creating at least one condition.

Users

The number of active unique users using the application. When you select this data source on a visualization, you must also select the application and the category of user. For Single Score visualizations only, you can select a condition as the category. You can add or edit conditions in the condition builder.

• All Users: Represents the number of all users in the application.
• New Users: Represents the number of users who have performed their first session.
• Never Returned Users: Users who have created only one session.
• Multi Device Users: Users who have created a session with more than one device.
• Custom: You define this category by creating at least one condition.

Important:

You must specify the date range for all Usage Insights data sources on all visualization types.

The following data visualizations do not support Usage Insights data sources:

• Calendar
• Geomap
• Heatmap
• Pivot table
• Simple List
• Indicator Scorecard

Time series and score data visualizations support all Usage Insights data sources.

Table 1. User Experience Analytics data sources

Metric	Supported visualization type	Group by	Response
Events	Scores (Single score, dial, gauge) Time series Bars, including Pareto Pies and donuts Pivot tables	Bars, Pivot tables, and Pies/donuts: Supported by the event's property Other visualization types: Not supported	Time series: Number of events in the date range Scores: Number of occurrences of the event Bars, Pie/Donut, Pivot: Breakdown of event in date range by property
Sessions	Time series Scores Pies and donuts Bars	Supports Group by and Stack by	Time series: Number of sessions in the date range Scores: Number of created sessions. Responses can also be filtered by conditions.
Users	Time series Scores Pies and donuts Bars	Supports Group by and Stack by	Time series: Number of active or new users in the date range Scores: Number of active or new users. Responses can also be filtered by conditions.
Pages	Time series Scores	Not supported	Time series: Number of active or new users in the date range Scores: Number of active or new users. Responses can also be filtered by conditions.

Related tasks

• Select a table data source for a data visualization
• Select an indicator data source for a data visualization

Related reference

• Multiple data sources