Add map cards

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 map cards to dashboards to know the portrait of your users, such as the user distribution in the world and quickly review which countries of the world have issues with adoption (for example, low search event count) or search relevance (for example, low clickthrough), for example.

The geo-mapping is done using the source IP address of the event performed by the users.

Add Map 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 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 a Dashboard Element).

  3. In the Add a Card dialog:

    1. Select Map.

      You can create a map card representing the number of visits per country.


    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 [Selected Metric] per Country.

      Device Category per Country

      Visits With Clickthrough Lower Than 25%

    3. Under Metric, click the dropdown menu, and then select one metric to show its values on a world map:

      Visit Count

    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 Cards).

        Search Event Clickthrough (%) < 25

      • When you report on a custom event and on a search or click event (you added a filter or selected a metric related) at the same time, or on an all event category metric or dimension (for example, 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.

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

Review Map card content in usage analytics dashboards

  1. In the navigation bar on the left, under Analytics, select Reports.

  2. On the Reports (platform-ca | platform-eu | platform-au) page, click the report containing the map cards you want to review, and then click Open in the Action bar.

  3. For every map cards, you can:

    • Hover over the card, and then zoom in or zoom out using Zoom-Out and Zoom-In that appear at the right corner of the card.

    • See the metric count for each country and the percentage that this count represents on the metric total count by hovering over a country of the map card.

    • Filter the report by only keeping the data of a country by clicking a country in the map card.

      Country is China

    • Add or remove a dimension value from the map by hovering over a value in the chart legend and then clicking Hide/Show.

    • Highlight the country representing a dimension value by hovering over a value in the map legend.

Required privileges

The following table indicates the required privileges to view and edit dashboards from the Reports (platform-ca | platform-eu | platform-au) 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 reports and Manage permission filters).

Action Service - Domain Required access level
View dashboards

Analytics - Analytics data

Analytics - Dimensions

Analytics - Reports

Organization - Organization

Edit dashboards

Analytics - Analytics data

Analytics - Dimensions

Organization - Organization

Analytics - Reports Edit
Analytics - Administrate Allowed