Get started

Taking advantage of Coveo Usage Analytics (Coveo UA) can be a game changer as it not only lets you measure and therefore maximize your search solution adoption, but it also feeds Coveo Machine Learning (Coveo ML) features with usage analytics data that can significantly improve your user experience.

This article focuses on how to get going on your Coveo UA journey.

To get started with Coveo UA

  1. Get familiar with the usage analytics concepts.

  2. Ensure that you’re a member of a group with the required privileges to access and make changes in the Coveo Administration Console Analytics pages (see Manage privileges).

  3. Ensure that the Coveo front-end products you use push standard search-related events and metadata.

    • Coveo for Salesforce

      By default, Coveo for Salesforce search components automatically push standard search-related usage analytics events and dimensions to your Coveo organization. You have nothing to do.

    • Coveo for Sitecore 5

      The Coveo UA module is enabled by default in a Coveo-powered Search Page. Therefore, no configuration is needed to capture search page events.

    • Coveo Atomic library

      When used correctly, Atomic components take care of logging standard search-related usage analytics events for you. No additional configuration required.

    • Coveo Headless library

      When used correctly, Headless controllers take care of logging standard search-related usage analytics events for you. No additional configuration required.

    • Coveo JavaScript Search Framework standalone search interfaces

      A standalone Coveo JavaScript Search Framework search interface must simply contain the Analytics component with minimal configuration to automatically push all default search events to Coveo UA for your Coveo organization.

    • Coveo hosted search page

An administrator can configure a hosted search page to send standard search-related usage analytics data to a Coveo organization when performing the first time configuration.

  1. View your usage analytics data.

    You can view the usage analytics data pushed from your Coveo products in different ways:

  2. Leverage your usage analytics data.

  3. Consider adding custom metadata.

    After working with default events and dimensions, you may want to also gather information specific to your environment. A developer can do that by adding code to push custom metadata to your search-related events or even custom events with custom metadata.

    1. Push custom events and metadata (developer task).

    2. Create matching custom dimensions (administrator task).

      In the Coveo Administration Console, you must create a custom dimension for each custom metadata to make them available in the Visit Browser as well as in dashboards and explorers.