Coveo Usage Analytics in Sitecore

This is for:

In this article

Accessing Coveo UA reports
About Usage Analytics events
What’s next?

The Coveo Usage Analytics (Coveo UA) service lets you track search analytics data for a Coveo-powered search page. Various events that occur within a search page (e.g., searches, clicks) are logged in Coveo. Page view events in Sitecore website pages may also be logged. All the recorded data can then be used to generate reports.

To log standard search page events in Sitecore, you need to add the Coveo for Sitecore Analytics rendering to your search interface.

To log view events in Sitecore, you need to add the Coveo Page View Analytics rendering on the given website page.

Coveo UA tracking is designed to improve your search experience on a designated search hub and therefore doesn’t follow users across other websites. However, certain internet filter lists may still contain references to Coveo files or usage analytics endpoints due to a broad "tracking" categorization. Using either a native or a third-party ad blocker which refers to these filter lists can result in Coveo’s JS files or outgoing usage analytics requests being blocked. As a result, in this scenario, user events in the search interface wouldn’t be sent to Coveo UA.

Accessing Coveo UA reports

You need to log in to the Administration Console (platform-ca | platform-eu | platform-au) to view your Coveo UA reports.

In the Analytics section of the main menu, select:

Reports (platform-ca | platform-eu | platform-au) for an overview of all your analytics, in graph and chart form. The second screenshot below shows the Summary report.
Visit Browser (platform-ca | platform-eu | platform-au) for a detailed description of all events for each visit. The example below shows John Doe’s visit and some of its events.

To gain deeper knowledge and understanding of Coveo UA, see Coveo Usage Analytics overview.

About Usage Analytics events

A usage analytics event is any user interaction with a search page, including queries, clicks, page views, and custom events (see Events).

The Coveo UA module only tracks events triggered within the web context. To track events triggered from another context, change the database property for the coveoanalytics site by creating a patch element in the Coveo.SearchProvider.Custom.config file.

Recording a search event relies on two elements: Cause and Dimensions.

A Cause has a name and a type. It’s itself a Dimension.

An example of a cause would be interfaceLoad or facetSelect.
A Dimension is a grouping of metadata key-value pairs principally exploited within the dashboards, reports, and explorers within the Coveo UA pages.

For examples of Dimensions, see Usage analytics dimensions.

What’s next?

You can now learn how to configure custom metadata for your analytics (see Add custom usage analytics metadata) and how to enable logging of view events (see Log view events).