Listing details
Listing details
In the Coveo Merchandising Hub (CMH), when merchandisers click View for a specific product listing page (PLP) in the Product listings manager, they access detailed information about the PLP, including the applied rules, key metrics, and ranking information.
Listing details page overview
The listing details page provides a comprehensive overview of the PLP’s performance, the applied rules, and detailed ranking information.
1 |
The page title displays the name of the PLP for which the details are being viewed. |
2 |
The Performance tab displays key metrics to provide insights into the performance of the PLP. |
3 |
The Rules tab displays the different merchandising rules applied to this PLP. |
4 |
The Configuration tab displays the configuration details of the PLP. |
5 |
The Preview tab displays a preview of how products are ranked on this PLP. |
6 |
The date picker allows merchandisers to select a specific date range to view and compare performance metrics for the selected PLPs. |
|
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 PLP listed on the Performance tab of the listing details page.
The Performance section includes the following subsections:
Hero metrics
Hero metrics are the key performance indicators prominently displayed at the top.
| Metric | Definition |
|---|---|
Clickthrough rate |
The percentage of times a product was clicked when the PLP was viewed. |
Revenue |
The revenue of products attributed to the PLP, including taxes, shipping costs, and discounts. |
Conversion rate |
The percentage of visits which converted for the PLP. |
"Collected data" metrics
The Collected data metrics section provides a comprehensive overview of user interactions and activities for a PLP. These metrics are essential for understanding how a PLP is performing and how users are engaging with it.
| Metric | Definition |
|---|---|
Views |
The number of times the PLP was viewed. Additional interactions like facets and page navigation will also increment this count. |
Visits |
The number of visits during which the PLP was viewed. |
Visitors |
The number of unique visitors, as tracked in their browser, who viewed the PLP. |
Products |
The number of products shown on the PLP. |
Clicks on products |
The number of times any products were clicked on the PLP. |
Purchases |
The total number of purchases that are attributed to the PLP. |
"Analyzed data" metrics
The Analyzed metrics section is used for evaluating how well the PLP engages visitors and drives desired actions, such as clicks and purchases.
| Metric | Definition |
|---|---|
Average click rank (ACR) |
The average position of clicked products on the PLP. |
Revenue per visitor (RPV) |
The average revenue obtained per visitor who viewed this PLP. |
Average order value (AOV) |
The average revenue per purchase attributed to the PLP. |
"Product metrics" metrics
The Product metrics section displays the performance of individual products shown on the PLP.
| Metric | Definition |
|---|---|
Revenue |
The net revenue of the product attributed to the PLP. |
Clickthrough rate |
The percentage of times this specific product was clicked when the PLP was viewed. |
Conversion rate |
The percentage of times this specific product was purchased when the PLP was viewed. |
Ranking position |
The average position of this specific product on the PLP. |
Time period analysis and comparison
The CMH enables merchandisers to analyze performance metrics over specific time periods. Users can select a predefined or customized date range to tailor their analysis.
To access and switch between available time periods, use the date picker in the Product listings manager or detail page to select your date range and click Apply change. By default, the All time time period is displayed.
The following predefined time periods are available:
-
All time: Displays the sum of all data since the first tracked metric onward. This option is selected by default unless modified.
-
Last quarter: Displays metrics for the most recent quarter.
-
Last month: Displays metrics for the most recent calendar month.
-
Last week: Displays metrics for the most recent calendar week.
Custom date range selection
Users can select a specific start and end date to analyze metrics for any desired period. This provides flexibility for examining data beyond the predefined ranges.
Compare feature
The CMH includes a compare feature, which allows users to compare metrics between two date ranges. Users can select custom date ranges or choose from predefined comparison periods, such as Previous quarter, Previous month, Previous week, and Yesterday.
To use this feature:
-
Select the first date range using the date picker.
-
Click Compare and choose a second date range or a predefined comparison period.
-
Click Apply change.
The CMH will display the difference between the comparison periods. It will highlight the percentage change, either increased or decreased, to help identify trends and performance variations.
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.
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
searchBoxAsYouTypeevents: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, Commerce Advanced Reports and CMH reports are case-sensitive, while the reports on the Reports page are case-insensitive. This means that identical queries with different casing are treated as separate queries in Commerce Advanced Reports and CMH reports, but are counted as the same query on the Reports page.
For example, the queries
coveoandCoveoare counted as separate queries in Commerce Advanced Reports and CMH reports, but as the same query on the Reports page.
Rules
Clicking the Rules tab displays the different merchandising rules that are applied to this specific PLP.
Using this tab, merchandisers can create, view, and edit the merchandising rules that are influencing the products shown on this PLP.
For information and instructions on managing the different types of rules, see the following sections:
Configuration
Clicking the Configuration tab displays the configuration details of the PLP.
Using this tab, merchandisers can view and edit the configuration of the PLP.
Under Page settings, merchandisers can view and modify the following information:
-
Page name: The name of the PLP.
-
Page URLs: The URLs where the PLP is displayed.
-
Locales: The locales where the PLP is displayed.
Under Filter rules, merchandisers can view and modify the filter rules configured to scope the products displayed on the PLP.
Preview
The Preview tab helps merchandisers see how products are displayed to customers and how the merchandising rules applied to the PLP influence product rankings.
Using the Product attributes dropdown menu, merchandisers can select which product attributes to display in the preview.
Options are:
-
Grouped products: Enabling this option displays the grouped products in a single product card 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 factors influence the ranking of products.
-
Description: Enabling this option displays the product description in the preview.
Ranking details
By clicking View details in a product card, merchandisers can access detailed information about the ranking modifiers applied to the products on the PLP. This helps them understand why specific products are ranked in certain positions on the PLP and how Coveo ML influences the ranking. They can also view key attributes values for the product.
-
In the Product tab, merchandisers can view the key attributes values for the product.
-
In the Ranking factors tab, merchandisers can view the ranking modifiers applied to the product on the PLP.
The following ranking details are displayed:
Ranking criteria Definition Behavioral AI
The score assigned to the product by Coveo ML Automatic Relevance Tuning (ART) based on collected usage analytics (UA) events that track visitors' behavior for this PLP.
The score assigned to the product by Coveo ML ART based on collected usage analytics (UA) events that track visitors' behavior for this PLP. 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 on this PLP.
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).
Merchandising rules
The ranking score assigned to this product based on the merchandising rules applied to the PLP. This section also shows query pipeline rules defined in the Coveo Administration Console.
About relative difference
The Relative difference column visually indicates how much a ranking factor affects a product’s position on the PLP.
The result is obtained by comparing the product’s ranking factor value to the average value of the top 25 products with the highest scores for that factor. For example, if the top 25 products have an average Behavioral AI score of 4,700, and a product has a score of 6,000, its Relative difference value will be a positive High because its score is significantly above the top 25 average.
The following table provides a breakdown of the Relative difference values:
| Relative difference | Definition |
|---|---|
Negligible |
The product’s ranking factor is close to the average value of the ranking factor for the top 25 products on the PLP. |
Strong (positive) |
The product’s ranking factor is significantly higher than the average value of the ranking factor for the top 25 products on the PLP. |
Medium (positive) |
The product’s ranking factor is moderately higher than the average value of the ranking factor for the top 25 products on the PLP. |
Strong (negative) |
The product’s ranking factor is significantly lower than the average value of the ranking factor for the top 25 products on the PLP. |
Medium (negative) |
The product’s ranking factor is moderately lower than the average value of the ranking factor for the top 25 products on the PLP. |
Very useful
Not really
Very useful
Not really