Query details

This is for:

In this article

Query details page overview
Performance metrics
Rules
Preview

When merchandisers click View for a specific query in the Search manager, they can access detailed information about the query, including the rules applied, key metrics, and ranking information.

Clicking "View" on a Search manager query | Coveo

Query details page overview

The query details page offers a comprehensive overview of the query’s performance, applied rules, and detailed ranking information.

1	The page title displays the query for which the details are being viewed.
2	The Performance tab displays key metrics to provide insights into the performance of the query.
3	The Rules tab displays the different merchandising rules that are applied to this specific search query. Merchandisers can use this section to view and edit the rules that are influencing the search results for this query.
4	The Preview tab displays a preview of how the search results are ranked for this specific query. Merchandisers can use this section to understand how the search results are displayed to customers.

The Preview tab is currently in early access. If you’re interested in using the Preview tab, reach out to your Customer Success Manager (CSM).

Performance metrics

This section focuses on the key performance metrics available for each query listed in the Performance tab of the query details page.

The following subsections are shown:

Hero metrics
Collected data
Analyzed data
Product metrics

Query-specific metrics in search manager

Hero metrics

Hero metrics are the key performance indicators prominently displayed at the top.

Metric	Definition
Views	The number of times the query was searched. Additional interactions like facets and page navigation will also increment this count.
Revenue	The revenue of products attributed to the query, including taxes, shipping costs, and discounts.
Conversion rate	The percentage of visits which converted for the query.

Metric

Definition

Views

The number of times the query was searched. Additional interactions like facets and page navigation will also increment this count.

Revenue

The revenue of products attributed to the query, including taxes, shipping costs, and discounts.

Conversion rate

The percentage of visits which converted for the query.

"Collected data" metrics

The Collected data section provides a comprehensive overview of user interactions and activities for a query. These metrics are essential for understanding how a query is performing and how users are engaging with the search results.

Metric	Definition
Views	The number of times the query was searched.
Visits	The number of visits during which this query was executed.
Visitors	The number of unique visitors, as tracked in their browser, who performed the query.
Products	The number of products shown in the search results for the query.
Clicks on products	The number of times products were clicked after the query was executed.
Purchases	The total number of purchases that are attributed to the query.

Metric

Definition

Views

The number of times the query was searched.

Visits

The number of visits during which this query was executed.

Visitors

The number of unique visitors, as tracked in their browser, who performed the query.

Products

The number of products shown in the search results for the query.

Clicks on products

The number of times products were clicked after the query was executed.

Purchases

The total number of purchases that are attributed to the query.

"Analyzed data" metrics

The Analyzed metrics section is used for evaluating how well the query engages visitors and drives desired actions, such as clicks and purchases.

Metric	Definition
Average click rank (ACR)	The average position of clicked products.
Clickthrough rate (CTR)	The percentage of times a product was clicked when the query was performed.
Revenue per visitor (RPV)	The average revenue obtained per visitor who performed the query.
Average order value (AOV)	The average revenue per purchase attributed to the query.

Metric

Definition

Average click rank (ACR)

The average position of clicked products.

Clickthrough rate (CTR)

The percentage of times a product was clicked when the query was performed.

Revenue per visitor (RPV)

The average revenue obtained per visitor who performed the query.

Average order value (AOV)

The average revenue per purchase attributed to the query.

"Product metrics" metrics

The Product metrics section displays the performance of individual products when a specific query is executed.

Metric	Definition
Revenue	The net revenue generated by this specific product from purchases attributed to the query.
Clickthrough rate	The percentage of times this specific product was clicked when the query was executed.
Conversion rate	The percentage of times this specific product was purchased after the query was executed.
Ranking position	The average position of this specific product in the search results for the query.

Metric

Definition

Revenue

The net revenue generated by this specific product from purchases attributed to the query.

Clickthrough rate

The percentage of times this specific product was clicked when the query was executed.

Conversion rate

The percentage of times this specific product was purchased after the query was executed.

Ranking position

The average position of this specific product in the search results for the query.

Time comparison

The CMH enables merchandisers to compare data for predetermined sets of time. To switch between the different time periods, click the drop-down menu in the upper-right corner of the Performance metrics page.

The following time periods are available:

Metric timeline	Description
All time	Sum of all the data since the first recorded metric.
Compare last 7 days	Provides a comparison of the last 7 days of data with the preceding 7 day period.
Compare last 28 days	Provides a comparison of the last 28 days of data with the preceding 28 day period.

Metric timeline

Description

All time

Sum of all the data since the first recorded metric.

Compare last 7 days

Provides a comparison of the last 7 days of data with the preceding 7 day period.

Compare last 28 days

Provides a comparison of the last 28 days of data with the preceding 28 day period.

Metric cut-off times

Coveo uses a cut-off time of 23:59:59 UTC for data processing or reporting, which can affect other time zones due to the nature of how time zones work in relation to Coordinated Universal Time (UTC).

A rolling data preview period means that new numbers will be visible every day once both periods are available.

Example

A user in Montreal, Canada, operates in the Eastern Time Zone. The Eastern Time Zone is either UTC-5 (Eastern Standard Time, EST) or UTC-4 (Eastern Daylight Time, EDT), depending on whether daylight saving time is in effect. The UTC cut-off of 23:59:59 translates to 18:59:59 (6:59:59 PM) Montreal time.

Discrepancies between reports

Figures shown for metrics in Coveo Merchandising Hub (CMH) reports may differ from those for the same metrics in the Reports (platform-ca | platform-eu | platform-au) page of the Coveo Administration Console and the Commerce Advanced Reports.

These discrepancies typically occur because different reports use distinct filters and processing rules when calculating figures for the same metric.

Here are the most common reasons for differences between reports:

Inclusion of searchBoxAsYouType events:

By default, reports from the Reports (platform-ca | platform-eu | platform-au) page include search events where the event cause is searchBoxAsYouType. This can result in higher query figures compared to the Commerce Advanced Reports or CMH reports, which exclude these events by default.
Time zone differences:

CMH reports use Coordinated Universal Time (UTC), while the reports of the Reports page and Commerce Advanced Reports use the user’s browser time zone. This difference can lead to a few hours of offset in event timestamps, which may affect metric calculations.
Case sensitivity in query metrics:

For query-related metrics, CMH reports are case-sensitive, while the reports of the Reports page and Commerce Advanced Reports are case-insensitive. This means that identical queries with different casing are treated as separate queries in CMH reports but are counted as the same query in the other reports. For example, the queries coveo and Coveo are counted as separate queries in CMH reports but as the same query in the other reports.

Rules

Clicking the Rules tab displays the different merchandising rules that are applied to this specific search query.

Using this tab, merchandisers can create, view, and edit the merchandising rules that influence the search results for this query.

For information and instructions on managing the different types of rules, see the following sections:

Preview

The Preview tab, as well as the Ranking details option, are currently in early access. If you’re interested in using the Preview tab, reach out to your Customer Success Manager (CSM).

The Preview helps merchandisers see how search results are displayed to customers and how the rules applied to the query influence product rankings.

Preview section on the query details page | Coveo

Using the Product attributes dropdown menu, merchandisers can select which product attributes to display in the preview.

Selecting product attributes in the preview section | Coveo

Options are:

Name: Enabling this option displays the product name in the preview.
Price: Enabling this option displays the product price in the preview.
Grouped products: Enabling this option displays the grouped products in a single product card in the preview.
Description: Enabling this option displays the product description in the preview.
Ranking details: Enabling this option displays the ranking details in the preview. By enabling this option, merchandisers can view how the different ranking criteria influence the ranking of search results.
Added attributes: Displays manually added product attributes in the preview. To add attributes to the preview, click Add attributes and select the product attributes you want to display.

Ranking details

When the Ranking details option is enabled from the Product attributes dropdown, the ranking details appear in the Preview section. Merchandisers can click View ranking details to access detailed information about the ranking modifiers applied to the search results. This helps them understand why specific products are ranked in certain positions in the search results and how Coveo ML influences the ranking.

Product ranking is split into four main modifiers, each with their own ranking sub-criteria:

Rules: Scores are assigned to products based on the merchandising rules applied to the query.
AI: Scores are assigned to products based on the output of Coveo ML models.
Semantic: Scores are assigned to products based on AI-powered semantic understanding for the query.
Lexical: Scores are assigned to products based on various criteria, such as the match between the terms present in the product metadata and those of the query.

Ranking details aren’t available for pinned products because they were placed in a specific position by a Pin rule.

Merchandising rules

The Rules modifier displays the score assigned to the product based on manual rules applied to the query. These rules can be either:

Boost or Bury ranking rules defined in the Coveo Merchandising Hub (CMH). By clicking View for a given rule, merchandisers can access the rule to view and edit its details, such as the ranking modifier and the conditions that trigger the rule.
query pipeline rules defined in the Coveo Administration Console.

AI

The AI modifier shows how the different Coveo ML models assign scores to products based on collected usage analytics (UA) events that track visitors' behavior for this query.

The AI modifier consists of three sub-criteria:

Product popularity: Scores assigned to the product by Automatic Relevance Tuning (ART). This section also shows the recorded UA events that the model can use to influence the ranking of the product:
- Clicks: The number of times the product was clicked when this query was executed.
- Purchases: The number of times the product was purchased across all storefront interfaces (as identified by the tracking ID).
- Adds to cart: The number of times the product was added to the cart across all storefront interfaces (as identified by the tracking ID).
Attribute popularity: Scores assigned to the product by Dynamic Navigation Experience (DNE). These scores are applied to all products that share popular attributes identified by the model for this query.
1:1 personalization: Scores assigned to the product by Intent-Aware Product Ranking (IAPR). Note that IAPR scores depend on specific visitor context and session. Since the Preview section can’t simulate a specific visitor, this section serves as a reminder of the substantial impact IAPR has on the storefront experience. To see the scores assigned by IAPR for a specific session, use the Relevance Inspector.

Semantic

The Semantic modifier displays the score assigned to the product by AI-powered semantic understanding of the query.

Semantic understanding is done by retrieving the products with high semantic similarity with the query. For more information about Coveo’s semantic understanding capabilities, see About Relevance Generative Answering (RGA).

Lexical

The Lexical modifier displays the score assigned to the product based on the default index search result ranking. Merchandisers can use this section to understand how the different index ranking criteria influence the ranking of products for this query.

The following table provides an overview of the index ranking criteria that can be consulted in the CMH:

Ranking modifier and criteria Definition

Ranking modifier and criteria	Definition
Basic match between product and query	Title	The score assigned to the match between the terms in the product’s name (`ec_name` field) and those of the query.
Summary	The score assigned to the match between the terms in the product’s summary and the query. When indexing an item, Coveo uses a linguistic algorithm that scans and extracts all the readable sentences of an item. At query time, the algorithm relies on term frequency and proximity to select the sentences that best represent the query and creates an item summary made from those sentences. The more the summary contains queried keywords, the higher the score.
Term correlation within stemming classes	The score assigned to the presence of words in the product metadata that share the same root as the queried keywords. For example, the query `run` would match `running` and `ran` if they’re present in the product metadata.
Source constant	Constant score assigned to all products of the same source.
Others	Other criteria that influence the ranking of products in the search results. For more information about ranking criteria, see About search result ranking.
Total per item	The sum of the scores assigned to the product for each of the Basic match between product and query criteria.
Term importance	The score assigned to the importance of the queried keywords within the product metadata. The more queried keywords are present in the product metadata, the higher the score.
Recency of update	The score assigned to the recency of the product update. For example, a product updated today would have a higher score than a product updated a year ago.
Adjacency of keywords	The score assigned to the proximity of the queried keywords within the product. For example, if a query is `running shoes`, a product containing the words `running shoes` would have a higher score than a product with the words `shoes for running`.

Basic match between product and query

Title

The score assigned to the match between the terms in the product’s name (ec_name field) and those of the query.

Summary

The score assigned to the match between the terms in the product’s summary and the query.
When indexing an item, Coveo uses a linguistic algorithm that scans and extracts all the readable sentences of an item. At query time, the algorithm relies on term frequency and proximity to select the sentences that best represent the query and creates an item summary made from those sentences. The more the summary contains queried keywords, the higher the score.

Term correlation within stemming classes

The score assigned to the presence of words in the product metadata that share the same root as the queried keywords.
For example, the query run would match running and ran if they’re present in the product metadata.

Source constant

Constant score assigned to all products of the same source.

Others

Other criteria that influence the ranking of products in the search results.
For more information about ranking criteria, see About search result ranking.

Total per item

The sum of the scores assigned to the product for each of the Basic match between product and query criteria.

Term importance

The score assigned to the importance of the queried keywords within the product metadata.
The more queried keywords are present in the product metadata, the higher the score.

Recency of update

The score assigned to the recency of the product update.
For example, a product updated today would have a higher score than a product updated a year ago.

Adjacency of keywords

The score assigned to the proximity of the queried keywords within the product.
For example, if a query is running shoes, a product containing the words running shoes would have a higher score than a product with the words shoes for running.