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. 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.

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.
• Loyal Users: Users who have created 5 or more sessions.
• 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.

• Active Users: Represents the number of all users in the application.
• New Users: Represents the number of users who have performed their first session.
• Returning Users: Users who have created more than one session.
• Loyal Users: Users who have created five or more sessions.
• 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

The following data visualizations only support Events.

• Pie/Donut
• Bar

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	Not supported	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	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