--- title: Listing details slug: o9ja0562 canonical_url: https://docs.coveo.com/en/o9ja0562/ collection: coveo-for-commerce source_format: adoc --- # Listing details In the [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/), when merchandisers click **View** for a specific [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187/) in the [Product listings manager](https://docs.coveo.com/en/p64e0262/), they access detailed information about the PLP, including the applied rules, key metrics, and ranking information. ![Clicking "View" on a Listings page | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/view-click-listing-manager.png) ## Listing details page overview The listing details page provides a comprehensive overview of the PLP's performance, the applied rules, and detailed ranking information. ![Listings details page anatomy | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listings-details-page.png) [cols="2"] |=== |1 |The page title displays the name of the PLP for which the details are being viewed. |2 |The [**Performance**](#performance-metrics) tab displays key metrics to provide insights into the performance of the PLP. |3 |The [**Rules**](#rules) tab displays the different merchandising rules applied to this PLP. Merchandisers can use this section to view and edit the rules that are influencing the products shown on this PLP. |4 |The [**Configuration**](#configuration) tab displays the configuration details of the PLP. Merchandisers can use this section to view and edit the configuration of the PLP, such as the filtering rules used to scope the products displayed on the PLP. |5 |The [**Preview**](#preview) tab displays a preview of how products are ranked on this PLP. Merchandisers can use this section to understand how the products are displayed to customers. |6 |The date picker allows merchandisers to [select a specific date range](#time-period-analysis-and-comparison) to view and compare performance metrics for the selected PLPs. |=== > **Important** > > 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) * [Collected data](#collected-data-metrics) * [Analyzed data](#analyzed-data-metrics) * [Product metrics](#product-metrics-metrics) ![Listing-specific metrics in search manager](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-listings-metrics.png) ### Hero metrics Hero metrics are the key performance indicators prominently displayed at the top. [%header,cols="2"] |=== |Metric |Definition |Clickthrough rate |The percentage of times a product was clicked when the PLP was viewed. |Revenue |The revenue of products [attributed](https://docs.coveo.com/en/m7l98577/) 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. [%header,cols="2"] |=== |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. |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](https://docs.coveo.com/en/m7l98577/) 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. [%header,cols="2"] |=== |Metric |Definition |Average click rank (ACR) |The average position of clicked products on the PLP. |Revenue per visit (RPV) |The average revenue obtained per visit during which this PLP was viewed. |Average order value (AOV) |The average revenue per transaction [attributed](https://docs.coveo.com/en/m7l98577/) to the PLP. |=== ### "Product metrics" metrics The **Product metrics** section displays the performance of individual products shown on the PLP. [%header,cols="2"] |=== |Metric |Definition |Revenue |The net revenue of the product [attributed](https://docs.coveo.com/en/m7l98577/) 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. ![CMH time picker | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-time-picker.png) 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. * **Today's metrics**: Shows data recorded for the current day. Data is updated every hour. ## 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. 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. ![CMH time picker comparison | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/cmh/cmh-time-picker-comparison.png) :leveloffset!: ### Discrepancies between reports Figures shown for metrics in [Coveo Merchandising Hub (CMH)](https://docs.coveo.com/en/o5290573/) reports may differ from those for the same metrics in the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page of the Coveo Administration Console. These discrepancies typically occur because different reports use distinct filters and processing rules when calculating figures for the same metric. The most common reason is the inclusion of `searchBoxAsYouType` events. By default, reports from the [**Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/reports/)) page include search events where the [event cause](https://docs.coveo.com/en/2948#search-event-cause) is [`searchBoxAsYouType`](https://docs.coveo.com/en/2948#searchboxasyoutype-performsearch-manual). This can result in higher query figures compared to the Commerce Advanced Reports or CMH reports, which exclude these events by default. ## Rules Clicking the **Rules** tab displays the different merchandising rules that are applied to this specific PLP. ![Rules section on the listing details page | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listing-details-rules.png) 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: * [**Filter** rules](https://docs.coveo.com/en/o5sf1454/) * [**Ranking** rules](https://docs.coveo.com/en/o5sf2373/) ## Configuration Clicking the **Configuration** tab displays the configuration details of the PLP. ![Configuration section on the listing details page | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listing-details-configuration.png) 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](https://docs.coveo.com/en/p4tf0351/) 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. ![Preview section on the query details page | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listings-details-preview.png) 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](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listings-details-preview-product-attribute.png) 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](#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](https://docs.coveo.com/en/188/) influences the ranking. They can also view key attributes values for the product. * On the **Product** tab, merchandisers can view the key attributes values for the product. ![Product details in the preview section | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listing-details-product-details.png) * On the **Ranking factors** tab, merchandisers can view the ranking modifiers applied to the product on the PLP. ![Ranking details in the preview section | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/listing-details-ranking-details.png) The following ranking details are displayed: [%header,cols="2*"] |=== |Ranking criteria |Definition |Behavioral AI |The score assigned to the product by [Coveo ML](https://docs.coveo.com/en/188/) [Automatic Relevance Tuning (ART)](https://docs.coveo.com/en/1013/) based on collected [Coveo Analytics events](https://docs.coveo.com/en/260/) that track visitors' behavior for this PLP. The score assigned to the product by [Coveo ML](https://docs.coveo.com/en/188/) [Automatic Relevance Tuning (ART)](https://docs.coveo.com/en/1013/) based on collected [events](https://docs.coveo.com/en/260/) that track visitors' behavior for this PLP. This section also shows the recorded UA events that the [model](https://docs.coveo.com/en/1012/) can use to influence the ranking of the product: **Clicks**: The number of times the product on this PLP was clicked. **Purchases**: The number of times the product was purchased across all [storefront](https://docs.coveo.com/en/p33g0410/) interfaces (as identified by the [tracking ID](https://docs.coveo.com/en/o8rb0139/)). **Adds to cart**: The number of times the product was added to the cart across all storefront interfaces (as identified by the [tracking ID](https://docs.coveo.com/en/o8rb0139/)). |Merchandising rules |The ranking score assigned to this product based on the [merchandising rules](https://docs.coveo.com/en/ncce0176#product-listings-manager-rules) applied to the PLP. This section also shows [query pipeline rules](https://docs.coveo.com/en/236/) defined in the [Coveo Administration Console](https://docs.coveo.com/en/183/). |=== #### About relative difference The **Relative difference** column visually indicates how much a ranking factor affects a product's position on the PLP. ![Relative difference | Coveo](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/relative-difference.png) 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: [%header,cols="2*"] |=== |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. |===