Manage Dimensions on Custom Metadata

Members of the Administrators and Analytics Managers built-in groups can access the Dimensions page to manage dimensions (metadata gathered by the search interface and passed along with the performed event to indicate the context of the recorded usage analytics event) on custom metadata.

Dimensions are essential for building usage analytics reports and for inspecting user visits through the Visit Browser. While standard dimensions are available out-of-the-box in your Coveo organization, you may record additional custom information from your search interfaces. To leverage this information in your Coveo organization, you must create user-defined dimensions.

User-defined dimensions can be created, modified, or removed at any time.

Add Dimensions on Custom Metadata

  1. On the Dimensions page, click Add dimension.

  2. In the Add a dimension panel that appears:

    Add a Dimension panel
    1. In the Display name field, enter a display name for the dimension (e.g., Results Sort By).

    2. (Optional) To create a semi-structured dimension, select the Semi-structured dimension check box.

      Semi-structured Path field

      In the Step field that appears, enter the applicable path step. To add another step, click Add step.

    3. Click the API name field and do one of the following:

      • Select between the API names detected since last month that have no associated dimensions.

      • Enter one of the available API names or create a new one (e.g., resultsortby).

        • When you create an API name, the name must have no spaces, no uppercase letters, and no special characters. Your API name must also have less than 255 characters.

        • If you selected the Semi-structured dimension check box and entered a path step, the API name field was automatically filled. In this case, we recommend keeping the API name and not modifying it manually.

    4. Under Type, select the desired value type.

      Custom dimensions of Date type support epoch timestamp values.

    5. Under Related events, select at least one of the available category check boxes.

      When the dimension you create is global (e.g., Country), select all three event categories instead of having to create a dimension for each type.

    6. Click Add Dimension.

      It can take up to five minutes before the user defined dimension values appear in usage analytics reports. The time to generate the data depends on your number of events and your quantity of data. The dimension appears in the User defined dimension list and in the list of available dimensions reporting on usage analytics data.

      • For every dimension created, you can review the number of unique dimension values with the Unique [Dimension Name] metric that’s automatically created (see Usage Analytics Metrics).

      • For every numeric dimension created, you can measure the dimension value total and average value as well as review the minimum and maximum values using the following metrics that are automatically created: Average [Dimension Name], [Dimension Name] Maximum, [Dimension Name] Minimum, and [Dimension Name] Sum (see Usage Analytics Metrics).

      • Once a dimension is created, only the display name can be edited afterwards. If you want to further define a custom dimension that you’ve already created (e.g., adding the semi-structured dimension option), we recommend creating a new dimension with the desired configuration and then deleting the initial one.

Edit a User Defined Dimension Name

  1. Access the Edit a Dimension dialog by clicking the user defined dimension that you want to review, and then clicking Edit in the Action bar.

  2. In the Edit a Dimension dialog:

    1. Click the Display Name box and then change the display name.

    2. Click Save.

Delete a User Defined Dimension

  1. Click the user defined dimension that you want to remove, and then click Delete in the Action bar.

  2. In the confirmation prompt that appears, click Yes.

Review Dimension Management Activities

The Activity panel list presents the dimension management activities in the reverse chronological order. Each row represents an activity, indicating when it occurred, the display name of the affected dimension, what was done (created, updated, deleted), and by who (user).

You can review the creation, change, and deletion history of your dimensions. To do so, on the Dimensions page, click Clock icon (see Review Events Related to Specific Coveo Administration Console Resources).

If the Activity icon is grayed and unresponsive, you don’t have all of the required privileges to perform this action.

Required Privileges

The following table indicates the required privileges to view and edit elements of the Dimensions page and associated panels (see Manage Privileges and Privilege Reference).

Action Service - Domain Required access level

View dimensions

Analytics - Analytics data
Analytics - Dimensions

View

Edit dimensions

Analytics - Analytics data

View

Analytics - Dimensions

Edit

Custom Metadata Reference

This section provides references for metadata names for different types of events. These metadata are logged but not available in usage analytics reports unless you create a dimension for them. You can use the values in the API name column in the table below for the value of the API name parameter when you create a dimension.

Event Cause (Click)

documentQuickView

Logs the following:

  • The item title opened in Quick View.

    API name: documenttitle

  • The item URL opened in Quick View.

    API name: documenturl

documentOpen

Logs the following:

  • The clicked item title.

    API name: documenttitle

  • The clicked item URL.

    API name: documenturl

interfaceChange

Logs the search interface (tab) name.

API name: interfacechangeto

contextRemove

Logs the removed search context name.

API name: contextname

resultsSort

Logs the name of the selected sorting function.

API name: resultssortby

Logs the following:

  • The breadcrumb ID removed from the facet history.

    API name: facetid

  • The breadcrumb value removed from the facet history.

    API name: facetvalue

documentField

Logs the following:

  • The clicked field ID from an item field to add a filter.

    API name: facetid

  • The clicked field value from an item field to add a filter.

    API name: facetvalue

pagerNumber

Logs the page number value used to change page.

API name: pagernumber

pagerNext

Logs the resulting page number after using the next button.

API name: pagernumber

pagerPrevious

Logs the resulting page number after using the previous button.

API name: pagernumber

omniboxFacet

Logs the following:app-name:

  • The ID of the selected facet filter from the omnibox.

    API name: facetid

  • The value of the selected facet filter from the omnibox.

    API name: facetvalue

facetClearAll

Logs the facet ID for which all values have been removed.

API name: facetid

facetSearch

Logs the ID of the facet within the search was performed.

API name: facetid

facetToggle

Logs the following:

  • The selected operator (AND versus OR) icon before the toggle.

    API name: facetoperatorbefore

  • The selected operator (AND versus OR) icon after the toggle.

    API name: facetoperatorafter

facetRangeSlider

Logs the following:

  • The ID of the changed slider facet.

    API name: facetid

  • The start value of the slider facet.

    API name: facetrangestart

  • The end value of the slider facet.

    API name: facetrangeend

facetRangeGraph

Logs the following:

  • The ID of the changed graph facet.

    API name: facetid

  • The start value of the selected range.

    API name: facetrangestart

  • The end value of the selected range.

    API name: facetrangeend

facetSelect

Logs the following:

  • The selected facet ID used to filter on results.

    API name: facetid

  • The selected facet value used to filter on results.

    API name: facetvalue

facetDeselect

Logs the following:

  • The deselected facet ID to no longer filter on results with one of its values.

    API name: facetid

  • The deselected facet value to no longer filter on results with it.

    API name: facetvalue

facetExclude

Logs the following:

  • The excluded facet ID used to filter out results containing one of its values.

    API name: facetid

  • The excluded facet value used to filter out results containing this value.

    API name: facetvalue

facetUnexclude

Logs the following:

  • The unexcluded facet ID to no longer filter out results containing one of its values.

    API name: facetid

  • The unexcluded facet value to no longer filter out results containing this value.

    API name: facetvalue

facetSortValues

Logs the following:

  • The ID of the facet for which the sorting function has changed.

    API name: facetid

  • The name of the sorting function.

    API name: facetsortby

facetSelectAll

Logs the following:

  • The ID of the facet for which all values have been selected.

    API name: facetid

  • The values of the facet for which all values have been selected.

    API name: facetvalues

createItem

Logs the type of created item.

API name: entityName

A caseAttach event is logged when a user clicks the Link to Case or the Mark as Relevant button, whereas a caseDetach event is only logged when a user click the Unlink from Case button, which cancels the Link to Case action.

Event Cause (Salesforce)

casecontextAdd

Logs the added contextual case ID.

API name: caseid

casecontextRemove

Logs the removed contextual case ID.

API name: caseid

preferencesChange

Logs the following:app-name:

  • The search preference setting name.

    API name: preferencesname

  • The search preference setting type.

    API name: preferencestype

caseAttach (Salesforce)

Logs the following:

  • The attached knowledge base article title.

    API name: documenttitle

  • The attached knowledge base article URL.

    API name: resulturihash

  • The attached knowledge base article ID.

    API name: articleid

  • The case ID on which the knowledge base article was attached.

    API name: caseid

caseDetach (Salesforce)

Logs the following:

  • The detached knowledge base article title.

    API name: documenttitle

  • The detached knowledge base article URL.

    API name: resulturihash

  • The detached knowledge base article ID.

    API name: articleid

  • The case ID on which the knowledge base article was detached.

    API name: caseid

customfiltersChange

Logs the following:

  • The custom search filter name.

    API name: customfiltername

  • The custom search filter type.

    API name: customfiltertype

  • The custom search filter expression.

    API name: customfilterexpression

What's Next for Me?