Usage Analytics Metrics

A metric is a computed numerical value applied as selectable criteria within reports presented in the Coveo Cloud administration console analytics pages. Metrics can be visualized as an indicator, a time series, or as values within a usage analytics data table. Metrics are a direct consequence of recorded events (see Usage Analytics Recorded Events).

Admin-MetricTypes1d

1 Indicator form
2 Graphical form
3 Tabular form

The available metrics grouped by event type and in alphabetical order are:

For some metrics a high value is good, and for others, a high value can reveal a relevance issue (see Finding Search Implementation Successes and Issues With Metrics).

Click Metrics

Average Click Rank

This metric measures the average position of clicked items in the search results for the specified dimensions and filters. Its value is greater or equal to 1. Lower values are better. A value of 1 would mean that users always open the first item in the search results list.

The selected dimension is Country and users from Spain have an Average Click Rank value significantly higher than users from other countries. This may indicate poorer content or relevance for content available in Spanish.

Click Count

This metric is the total number of clicks for the specified dimensions and filters. In a metric card, in a dashboard without filters, the Click Count is the sum of all click events Adding Metric Cards in Usage Analytics Dashboards and Click Event Causes).

Click Rank Maximum

This metric is the highest position of a clicked item in the search results for the specified dimensions and filters.

Click Rank Minimum

This metric is the lowest position of a clicked item in the search results for the specified dimensions and filters.

Click Rank Sum

This metric is the total of all clicked item positions in the search results for the specified dimensions and filters.

Query Click-Through (%)

This metric is the percentage of search events with at least one click on search results for the specified dimensions and filters. Its value is between 0 and 100. Higher values are better.

Every search event affects the click-through, but not all queries do. For instance, a facet value selection/deselection is counted as a search event and a query. However, a pager click is a query but not a search event, hence not considered in the click-through calculation.

A query followed by a click on two facets, and then a click on a result, results in a click-through of 33% (i.e., one click for three search events). If you do the same query but use the pager to navigate to the desired result, the click-through would be 100% (i.e., one click for one search event).

Manual Query Count

This metric is the total number of queries performed by users (using the search box) for the specified dimensions and filters.

  • Query refinements are excluded.

  • The search cause of the related event must be manual for a query to count.

Queries With Click

This metric is the total number of queries resulting in at least one click for the specified dimensions and filters.

Query Count

This metric is the total number of queries for the specified dimensions and filters. In a metric card, in a dashboard without filters, the Query Count is the sum of all search events Adding Metric Cards in Usage Analytics Dashboards and Search Event Causes).

Relevance Index / Relevance Index (Legacy)

This metric is calculated with a formula based on the Click-Through and the Average Click Rank metrics to highlight ranking issues. Its value is between 0 and 1. Higher values are better. More frequently submitted queries with clicks on results farther in the search results list yield to a lower value (see How Is the Relevance Index Calculated and How Should It Be Used?).

Sorting by this value in descending order brings to the surface the most important potential relevance issues on which an administrator or an analytics manager can focus.

When the Country dimension is selected and Germany has the lowest value for this metric, relevance issue for users from Germany should be investigated.

Refined Query Count

This metric is the number of query refinements done by users (facets, interface change, etc.) for the specified dimensions and filters.

The search cause of the related event must be manual for a query to count.

Unique [Click Dimension Name]

This metric is the number of unique dimension value for the specified dimensions and filters (see Click Dimensions).

The Unique Click Cause metric is the number of unique click causes that triggered an event in the search interface to be recorded.

Search Metrics

Average Number of Results

This metric measures the average number or results returned by the search interface for the specified dimensions and filters.

Average Response Time (ms)

This metric measures the average time in milliseconds the search interface took to return results for the specified dimensions and filters.

Query Click-Through (%)

This metric is the percentage of queries with at least one click on search results for the specified dimensions and filters. Its value is between 0 and 100. Higher values are better.

Manual Query Count

This metric is the total number of queries performed by users (using the search box) for the specified dimensions and filters.

  • Query refinements are excluded.

  • The search cause of the event must be manual for a query to count.

Number of Results Maximum

This metric is the highest number or results returned by the search interface for the specified dimensions and filters.

Number of Results Minimum

This metric is the lowest number or results returned by the search interface for the specified dimensions and filters.

Number of Results Sum

This metric is the total number or results returned by the search interface for the specified dimensions and filters.

Query Count

This metric is the total number of queries for the specified dimensions and filters.

Refined Query Count

This metric is the number of query refinements done by users (facet, interface change, etc.) for the specified dimensions and filters.

The search cause of the related event must be manual for a query to count.

Relevance Index

This metric is calculated with a formula based on the Query Count and the Average Click Rank metrics to highlight ranking issues. Its value is between 0 and 1. Higher values are better. Frequently submitted queries with clicks on results farther in the search results list yield to a lower value.

Sorting by this value in descending order brings to the surface the most important potential relevance issues on which an administrator or an analytics manager can focus.

When the Country dimension is selected and Germany has the lowest value for this metric, relevance issue for users from Germany should be investigated.

Response Time (ms) Maximum

This metric is the longest time in milliseconds the search interface took to return results for the specified dimensions and filters.

Response Time (ms) Minimum

This metric is the shortest time in milliseconds the search interface took to return results for the specified dimensions and filters.

Response Time (ms) Sum

This metric is the total time in milliseconds the search interface took to return results for the specified dimensions and filters.

Unique [Search Dimension Name]

This metric is the number of unique dimension value for the specified dimensions and filters (see Search Dimensions).

The Unique Query metric is the number of unique queries entered by users in the search box for the specified criteria.

Custom Metric

Attach to Case Count

This metric is simply the total number of times agents attached a result to a case (caseAttach event) for the specified dimensions and filters.

Custom Event Count

This metric is simply the total number of custom events for the specified dimensions and filters. In a metric card, in a dashboard without filters, the Custom Event Count is the sum of all custom events Adding Metric Cards in Usage Analytics Dashboards and Custom Event Types).

Unique [Custom Dimension Name]

This metric is the number of unique dimension value for the specified dimensions and filters (see Search Dimensions).

The Unique Custom Event Value metric is the number of unique values saved for a custom event performed in a search interface, for the specified criteria.

All Event Type (Click, Search, and Custom) Metrics

Unique [All Event Type Dimension Name]

This metric is the number of unique dimension value for the specified dimensions and filters (see Search Dimensions).

The Unique City metric is the number of unique cities from which a user performed an event, based on the IP address, for the specified criteria.

Unique User IP

This metric measures the number of unique IP addresses for the specified filters and dimensions. In some cases, different users can share the same IP address.

Unique User ID

This metric measures the number of unique user IDs that perform a query for the selected filters and dimensions (see User ID).

Unique Visitor ID

This metric measures the number of unique visitors for the specified filters and dimensions. A visitor ID is based on persistent cookies, so a visitor keeps the same ID as long as they use the same browser and never clear the browser cookies. The visitor ID is a generated random sequence and does not allow to personally identify an anonymous user.

Visit Click-Through (%)

This metric measures the number of visits with at least one click divided by the total number of visits.

This metric is only available when adding visit metric cards (see Adding Visit Metric Cards in Usage Analytics Dashboards).

Visit Count

This metric measures the number of visits regardless of unique IP addresses and user names for the specified filters and dimensions. Visits are based on time-based cookies. A visit ends after 30 minutes of inactivity.

Visits with Click

This metric measures the number of visits with at least one click.

This metric is only available when adding visit metric cards (see Adding Visit Metric Cards in Usage Analytics Dashboards).

Visits with Manual Query

This metric measures the number of visits with at least one query performed by a user using the search box.