Review and Manage Dashboards

As a member of the Administrators or Analytics Managers built-in groups, you can use the Reports page in the Analytics section of the Coveo Administration Console navigation menu to review the data collected by Coveo Usage Analytics (Coveo UA).

After creating a dashboard, you can add tabs, sections, cards, and filters to report only on the desired usage analytics data and organized in the desired structure.

The usage analytics data that you can review can be limited by your permissions (see Manage Permission Filters).

Usage Analytics Reporting Leading Practices

When managing usage analytics reports, consider the following recommendations and tips to improve report loading time:

  • Reduce the number of cards in the same tab by reorganizing your report (see Manage Tabs). A high number of cards means many API calls at the same time, which can increase the report loading time.

  • Computing statistics such as trends and unique counts (e.g., Unique Visitor ID) takes time, so consider excluding unnecessary metrics and trends from report cards.

  • Select a report period that only includes the data you need. A wider date range (e.g., months versus weeks) means more data to sort through and compute.

  • Use trend cards with caution. Trend cards are the most costly, in performance terms, so reports containing many cards of this type take a longer time to load.

  • Review the complexity of the report filters:

    • Including the Advanced Query Expression dimension in a filter has a high performance cost. Therefore, we recommend using custom dimensions instead since they remove the need for filtering on Advanced Query Expression.

    • Filtering with the Contains or Does not contain operators and a list of values such as usernames or visitor IDs takes a longer time to compute.

    • “Exact match” filters (using the Is or Equals operators) are more performing than “contains” filters (using the Contains or Does not contain operators).

    • Named filters don’t improve report performance.

      Applying a named filter that contains five filters is the same as adding those five filters individually on a report.

    • Adding large numbers of filters to group users significantly impacts the report performance.

Access a Dashboard

  1. On the Reports page, click the desired dashboard, and then in the Action bar, click Open.

  2. When needed and when you want your changes to be kept, enter Edit mode:

    On the dashboard page, click Edit in the upper-right corner.

    Changes that you made prior to accessing Edit mode are kept. Therefore, you must remove these changes (if unwanted) before saving the dashboard.

Rename a Dashboard

  1. In Edit mode, change the dashboard name by clicking and editing the original name in the upper-left corner.

  2. (Optional) Enter a dashboard description by clicking and editing the original description.

  3. Click Save in the upper-right corner.

Set a Date Interval Over Which You Want to Review Search Usage Data

Method 1: Select a Diagram Area

In any time series card, click and hover over an area. All the data shown in the report will match the selected period.

This feature is useful when you notice a period where there was an unexpected change for one or more metrics.

Admin-SelectDatesInLineChart

Method 2: Switch Date Intervals

In the upper-right corner of the window, you can go from the current date interval selected (last week, month…) to the previous period or next period by clicking Previous and Next arrows respectively.

You can select a period that’s incomplete (e.g., the current month), in which case your date range selection will always include the latest available events until the period ends (e.g., the first day of the following month).

For example, you’re reviewing data per Month and want to see how statistics are trending for the first two weeks of the current month, so you click Right arrow.

Method 3: Pick a Date Range

In the upper-right corner of the window, click the box containing the current date range to access the Report Period dialog, and then select the date range you want to review (see Set the Period to Review Search Usage Data).

Add a Global Dimension Filter to Refine Search Usage Analytics Data

Access the dialog to add global dimension filters by clicking Add-Filter (see Add Global Dimension Filters).

Manage Global Dimension Filters

Add a Named Filter With Current Global Dimension Filters

  1. At the right-end of the top bar, click Menu, and then select Save filters as.

  2. In the Save as a Named Filter dialog, in the first input, enter a meaningful Filter name, and then click Save.

    The named filter is now applied to the report.

Edit a Global Filter Configuration

  1. On the top bar, click the global filter label.

  2. Make your changes.

  3. Click Save.

Enable and Disable Global Filters

Next to the global filter label, click Menu, and then select Enable or Disable.

Reverse the Global Filter Operator

Next to the global filter label, click Menu, and then select Reverse operator.

Remove a Global Filter

Next to the global filter label, click Menu, and then select Remove.

Remove All Global Filters

At the right-end of the top bar, click Menu, and then select Delete all filters.

Manage Dashboards

Export and Import a Complete Dashboard Configuration

  1. In the upper-right corner, click More, and then select Copy to clipboard.

    • The Copy to clipboard option is ONLY available outside of Edit mode.

    • This feature is useful when you want to export your dashboard configurations from your staging environment to production without having to recreate all your dashboards manually.

    • The configuration is exported in JSON format.

  2. Copy the dashboard configuration.

    Depending on your browser compatibility with the copy/cut feature of the execCommand method (see Browser compatibility):

    • When your browser supports the feature, the configuration is automatically copied in your clipboard.

    • When your browser doesn’t support the feature, in the Export a Report Configuration panel that appears, copy the configuration.

  3. In your actual Coveo organization or in another one (e.g., your Coveo organization in production), in the navigation bar on the left, under Analytics, select Reports.

  4. On the Reports page, click Add, and then select Blank dashboard.

  5. On the dashboard:

    1. In Edit mode, click More in the upper-right corner, and then select Paste JSON configuration.

    2. In the Import a Report Configuration panel that appears, paste the configuration, and then click Import and Save.

    3. Click Save in the upper-right corner.

    The dashboard looks exactly the same as the one you exported. The only possible difference could be the analytics data if you imported a dashboard configuration from another Coveo organization.

Edit a Dashboard Configuration

This feature is useful when you’re more comfortable editing dashboards in JSON than directly in the dashboards themselves.

  1. Click More in the upper-right corner, and then select Edit JSON configuration.

  2. In the Edit a Report JSON Configuration panel that appears:

    1. Make your modifications, and then click Save.

      OR

    2. Locate and select the configuration part that you want to import in another dashboard, and then copy your selection.

    3. Click Apply.

  3. (When you copy a dashboard part) In the navigation bar on the left, under Analytics, select Reports.

  4. On the Reports page, access or create a dashboard.

  5. On the dashboard:

    1. In the upper-right corner, click More, and then select Edit JSON configuration.

    2. In the Import a Report Configuration panel that appears, locate the place where you want to put the dashboard part you copied, and then paste the JSON code.

    3. Click Import and Save.

Export and Import a Part of a Dashboard

This feature is useful when you want to export and import only a section or a card of a dashboard, and not the complete configuration.

  1. In Edit mode, click More in the upper-right corner, and then select Edit JSON configuration.

  2. In the Edit a Report JSON Configuration panel that appears:

    1. Locate and select the configuration part that you want to import in another dashboard, and then copy your selection.

    2. Click Save.

  3. In your actual Coveo organization or in another one (e.g., your Coveo organization in production), in the navigation bar on the left, under Analytics, select Reports.

  4. On the Reports page, access an existing dashboard by clicking a dashboard, and then in the Action bar, clicking Open.

  5. On the dashboard:

    1. In Edit mode, click More in the upper-right corner, and then select Edit JSON configuration.

    2. In the Edit a Report JSON Configuration panel that appears, locate the place where you want to put the dashboard part you copied, and then paste the JSON code.

    3. Click Save.

Manage the Access to the Dashboard

  • You can also manage the members access to all private dashboards (see Manage Access to Usage Analytics Reports).

  • By default, dashboards are accessible to all group members with the View right on Reports.

In Edit mode, access the Manage Report Access dialog (click More in the upper-right corner, and then select Manage report access), and then define who has access to the dashboard (see Manage Access to Usage Analytics Reports).

Apply a Template to a Dashboard

  1. In Edit mode, click More in the upper-right corner, and then select Apply template.

  2. In the Select a Template panel:

    1. Select the radio button of one of the available templates.

    2. Click Select Template.

    3. If you selected Case Creation Page Metrics, in the Add Case Creation Page Metrics Report panel that appears:

      1. Under Select a case creation page, click the drop-down menu, and then select the page you want to analyze.

      2. Under Select Submit case custom event, click the drop-down menu, and then select the name of the custom event that’s logged when a user creates a case.

      3. Under Select Cancel case custom event, click the drop-down menu, and then select the name of the custom event that’s logged when a user cancels their case creation or select None when your page doesn’t contain a cancel button.

      4. Click Add Report.

        A report named Case Creation Page Metrics appears.

    4. If you selected General Search Interface Metrics, in the Add General Search Interface Metrics Report panel that appears:

      1. Under Select search interface, click the drop-down menu, and then select the search interface you want to analyze.

      2. Click Add Report.

        A report named General Search Interface Metrics appears.

    5. If you selected Detailed Summary, in the Add Detailed Summary Report panel that appears:

      1. Under Select search interface (Origin level 1), click the drop-down menu, and then select the search interface you want to analyze.

      2. Click Add Report.

        A report named Detailed Summary appears.

    6. If you selected Support Agents, in the Add Support Agents Report panel that appears:

      1. In the first input, enter the Total number of agents in your organization.

      2. In the Custom dimension name (unique case identifier) input, enter the name of the dimension that uniquely identifies your support cases.

        When you don’t already have a dimension that covers this use case, ask a developer to set up the dimension, and then add it in the Administration Console (see Send Your Own Search, Click, or Custom Events and Add Dimension on Custom Metadata). Otherwise, some metric cards on the report won’t load.

      3. Click Add Report.

        A report named Support Agents appears.

    7. If you selected A/B Testing, in the Add an A/B Test Report panel that appears:

      Your Coveo organization must contain at least two query pipelines associated with an active A/B Test, and usage analytics data must be available for at least one of the two pipelines. Otherwise, you will get the Missing Required Usage Analytics Data error message when adding the report.

      1. Under Select test, click the drop-down menu, and then select one of the available test sets.

        The drop-down menu lists all test sets available for your Coveo organization, not only the A/B tests created in the Coveo Administration Console (see Manage A/B Tests).

      2. In the Item A and Item B drop-down menu, select the two items (not necessarily pipelines) in the selected test set that you want to compare.

      3. Click Add Test.

        A report named A/B Testing appears.

Remove a Dashboard

  1. In Edit mode, click More in the upper-right corner, and then select Delete.

  2. In the Delete Report confirmation prompt that appears, click Delete.

Add a Section

Dashboards contain an empty section template that only appears in Edit mode.

  1. Click Add card to section to officially create the section.

  2. In the upper-left corner, in the input, enter a meaningful section title.

    User Adoption

Sections without cards are deleted after saving the dashboard.

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

Add a Card

In Edit mode, in a section, click Add card to section, and then select one of the following usage analytics card types:

Tables

Values

Graphs

Others

Manage Sections and Cards

In Edit mode:

Edit a Section or a Card Title

  1. Click the section or card title.

  2. Edit the title.

    In Edit mode, all autogenerated card titles (which occurs if the title box is empty before saving the dashboard) are shown as Enter a card title.

  3. Click outside the title box to validate the change.

Resize a Section or a Card

  1. Hover over a section or a card and Resize appears at the bottom right of the section or the card.

  2. Click and hold Resize, and then move the mouse to resize the card or graph at the desired width and height.

  3. When you’re done, release the left mouse button.

Replace a Section or a Card

  1. Click and hold Move in the upper-left corner of a card or in the upper-left corner of a section, and then move the mouse to replace the section or the card at the desired position.

    You can move cards from a dashboard section to another and you can place dashboard sections side-by-side.

  2. When you’re done, release the left mouse button.

Move a Card or a Section From a Tab to Another

  1. Click and hold Move in the upper-left corner of a card or in the upper-left corner of a section, and then hover over the label of the desired tab or the Add Tab label.

  2. When you’re done, release the left mouse button.

When you release the mouse button over the Add Tab, a new tab is created with the moved card or section.

Explore the Data Behind Each Card

In the upper-right corner of a card, click Explore-Data (see Review Content Behind Dashboard Cards).

This feature is ONLY available outside of Edit mode.

Manage Tabs

  • Dividing dashboards into tabs can simplify a dashboard configuration and improve its loading time.

  • Each tab acts as a dashboard section, meaning that:

    • The global filters and the report period applied on the dashboard impact all tabs;

    • You can take advantage of the same features such as managing cards.

  • You have to select the tab label to review the tab content.

In Edit mode:

Add a Tab

Under the filter toolbar, next to Tab [n], click Add Tab.

The first time you proceed, a tab named Tab 2 appears next to Tab 1.

Instead of creating a dashboard per user, you can create one dashboard in which you assign a tab per user.

Rename a Tab

Click the tab label, and then edit the original name.

Re-Order Tabs

Drag and drop the tab label by clicking Move next to the tab label and dragging the tab label to the location of your choice.

For a tab to be the first starting from the left, you have to move the desired tab in second place, and then move the first tab in second place.

Move Content From a Dashboard to Another

  1. In Edit mode, depending on the report container you want to move:

    To copy a card, section, or tab from a dashboard to another, you have to duplicate the report element, and then proceed with the following procedure (see Duplicate an Analytics Dashboard Element).

    • For a tab or a card

      In the upper-left corner of a card or next to the tab label, click and hold Move.

    • For a section

      In the upper-left corner, click and hold Move.

  2. Move the mouse to the middle right of the report where the word “Move” appears, and then release the left mouse button.

  3. In the Select the Location to Move the Content dialog, select the dashboard Name check box in which you want to move the content.

    • By default, the content is moved to the first tab of the selected dashboard.

    • When your organization has many reports, use the Filter box to find a dashboard more easily.

    • You can only move content to dashboards you have access to (see Manage the Access to the Dashboard).

  4. Click Move.

  5. In the Content Moved dialog, click Save and Go to save the current report and reach the new content location or click Stay on this Report.

Change the Time Series Card Interval

In Edit mode, select one of the following intervals in the upper-right corner of a time series card to set how data is grouped in the graph: Hour, Day, Week, and Month.

When you review the search usage data of last week and you select Day, each point in the graph represents a day.

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 dashboard

Analytics - Analytics data

Analytics - Dimensions

Analytics - Named filters

Analytics - Permission filters

Analytics - Reports

View
Edit dashboard

Analytics - Analytics data

Analytics - Dimensions

Analytics - Named filters

Analytics - Permission filters

View

Analytics - Data exports

Analytics - Reports

Edit
Analytics - Administrate Allowed

What’s Next?

See what you can do with dashboards (see Use Case: Create a Dashboard Linking to the Visit Browser).

Recommended Articles