Add Metric Cards in Usage Analytics Dashboards

Usage analytics dashboards offer many ways to review the data collected by Coveo Usage Analytics (Coveo UA)(see Review and Manage Dashboards).

You can, among other things, add metric cards to dashboards to quickly evaluate metric values, such as the number of clicks for a city in particular for the current week compared to the previous one.

Add Metric Cards in Usage Analytics Dashboards

  1. In an existing dashboard, access Edit mode by clicking Edit in the upper-right corner.

    In a new dashboard, the report is in Edit mode by default (see Add Usage Analytics Dashboards).

  2. In a section, click Add card to section to access the Add a Card dialog.

    You can also duplicate an existing card with Duplicate, and then only modify what needs to be different (see Duplicate an Analytics Dashboard Element).

  3. In the Add a Card dialog:

    1. Select Metric.

      You can create a metric card representing the number of clicks for a city in particular.


    2. In the first input, enter a meaningful Card title.

      When you leave the box empty and save the dashboard, the card title will be the name of the selected metric.

      Click Event Count

      Clicks in Seattle

    3. Under Metric, click the drop-down menu, and then select one metric to be shown in the metric box:

      Click Event Count

      • Click the links (Search, Click, and Custom) to quickly browse metrics by event category, and then select the one of your choice (see Usage Analytics Metrics).


      • Click All, and then use the Filter box to find and select the metric of your choice.

    4. (Optional) In the Advanced Settings section:

      • Click Add-Filter, and then create one or more dimension filters (see Add Dimension and Metric Filters in Usage Analytics Cards).

        City is Seattle

      • When you want to see trend data relative to the previous equivalent period as the one that’s currently selected, select the Display trend data option.

        The trend value appears next to the metric value as a percentage with an up or a down arrow respectively indicating an increasing or a decreasing trend.


        The option is turned off by default, because calculating the trends increases the dashboard complexity and slows down the dashboard generation. Enable this option when you really want it.

      • When you report on a custom event and on a search or click event (you added a filter or selected a dimension or metric related) at the same time, or on an all event category metric or dimension (e.g., Unique User IP and Browser), choose to Create a relation using the Last search or the Visit between the event categories.

      We recommend that you select Last search in situations where the last query performed by the user is the reason why they did the custom event.

      For example, in Salesforce, when agents attached a result to a case (caseAttach), the last query they made gave them the results they used to do the custom event.

      On the other hand, we recommend that you select Visit in situations where all the queries performed by the user during the visit didn’t resolved their matter.

      For example, when one of your clients creates a case (caseCreate), they, more often than not, tried to get the information they needed by querying on the subject of their matter before doing the custom event. You can then use these queries to create knowledge base article(s) and therefore fill the content gap.

      • The Create a relation using parameter has no effect when you report only on search and click events.

      • Last search links each custom event to the query immediately preceding (if any) and Visit links each custom event to all queries performed during the user visit in which the custom event happened.

    5. Click Add Card.

      In the metric box, relevance metrics (Relevance Index, Average Click Rank, and Click-Through) values (if any) have a color that represents if the value is good (green), neutral (black), or bad (red) depending on predefined thresholds (see Review and Manage Explorers).

  4. Back on the dashboard, click Save in the upper-right corner.

Required Privileges

The following table indicates the required privileges to view and edit dashboards from the Reports page and associated panels (see Manage Privileges and Privilege Reference).

Access to dashboards or part of their content may be further restricted as a function of the member (see Manage Access to Usage Analytics Reports and Manage Permission Filters).

Action Service - Domain Required access level
View metric cards

Analytics - Analytics data

Analytics - Dimensions

Analytics - Reports

Edit metric cards

Analytics - Analytics data

Analytics - Dimensions


Analytics - Reports

Analytics - Administrate Allowed
Recommended Articles