Product listing dashboard

This is for:

Business Analyst System Administrator

The Product listing dashboard on the Advanced Reports (platform-ca | platform-eu | platform-au) page provides an in-depth view of the top-performing product listing pages (PLPs). As in the Overview dashboard, you can view basic metrics such as revenue, conversion rate, clickthrough rate, and more. However, the Product listing dashboard emphasizes product listing attributions.

The Product listing dashboard | Coveo for Commerce

The Product listing dashboard includes the following metric charts:

What is a session?

Although sessions aren’t specifically listed in the Product listing dashboard, they’re often used to calculate the metrics listed there.

At Coveo, a session starts with the first event a visitor generates and ends after 30 minutes of inactivity. For a given visitor, if a new event is generated after 30 minutes of inactivity, it results in a new session with a new visit ID.

To be considered Coveo-related, the session must contain search, product listing, or recommendation actions.

What is a product listing event?

In this article, the term product listing event is often used in metric definitions to simplify the explanation. However, this isn’t an official Coveo Usage Analytics (Coveo UA) event type.

The definition of a product listing event varies depending on whether your Coveo for Commerce implementation targets the Commerce API or the Search API. Expand the following sections to learn about product listing events based on the Coveo API your implementation targets:

Commerce API

A product listing event is triggered when a request is made to the listing endpoint of the Commerce API.

Search API

In practice, a product listing event is a search event that’s triggered when a product listing page (PLP) loads. This happens when a query is made to the Search API to retrieve the products to display on the page. To trigger a product listing event, the query must contain the word listing in the searchHub query parameter.

What is product listing attribution?

A click action on a product category | Coveo for Commerce Coveo attributes a product in a transaction to the Product listing product discovery solution if the visitor's last registered click action before purchasing the product was selecting it on a product listing page (PLP).

For more details about how attribution is tracked for the Product listing solution, see About product listing attribution.

The Product listing dashboard shows how Coveo-powered PLP have contributed to your key commerce metrics.

Item revenue from product listings chart

The Item revenue from product listings chart displays the total revenue influenced by Coveo product listing pages (PLPs) that occurred within the chosen filters.

The line graph delineates the revenue variance over a specific period of time.

How is the item revenue from product listings calculated?

Expand the following sections to learn how the item revenue from product listings is calculated, based on whether you’re tracking events using the Coveo Event protocol or the Coveo UA protocol:

Event protocol

Item revenue from product listings is calculated by adding up the revenue (from the transaction property) from every product sold in each purchase event that was attributed to product listing events.

Coveo UA

Item revenue from product listings is calculated by adding up the revenue from every product sold in each purchase event that was attributed to product listing events.

Note

Revenue is reported in USD and calculated as either net or gross revenue:

  • Net revenue excludes taxes, shipping costs, and discounts.

  • Gross revenue includes taxes, shipping costs, and discounts.

The Top selling products metric displays net revenue figures. All other reported revenue metrics use gross revenue, unless otherwise stated.

See About revenue for more information on how the revenue metrics are calculated.

Transactions from product listings chart

Expand the following sections to learn about the Transactions from product listings chart based on the tracking method you use:

Event protocol

The Transactions from product listings chart displays the total number of purchase events influenced by Coveo product listing pages (PLPs) that occurred within the chosen filters.

The line graph delineates the variance of the purchase events over a specific period of time.

Coveo UA

The Transactions from product listings chart displays the total number of purchase events influenced by Coveo PLP that occurred within the chosen filters.

The line graph delineates the variance of the purchase events over a specific period of time.

How are transactions from product listings calculated?

Expand the following sections to learn how transactions from product listings are calculated, based on the tracking method you use:

Event protocol

The total number of purchase events attributed to product listing events.

See Capture purchase events for more information on how purchase events are logged and measured.

Coveo UA

The total number of commerce events that contain the purchase action and are attributed to product listing events.

See Capture a purchase event for more information on how purchase events are logged and measured.

Conversion rate from product listings chart

The Conversion rate from product listings chart displays the number of sessions that involved Coveo product listing pages (PLPs) and in which at least one transaction occurred over the total number of sessions that involved Coveo PLP, within the chosen filters.

The line graph delineates the variance of the rate over a specific period of time.

How is the conversion rate from product listings calculated?

Number of sessions involving Coveo PLP with at least one transaction, divided by the total number of sessions in which at least one Coveo product listing event occurred, multiplied by 100.

Average order value influenced by product listings chart

The Average order value influenced by product listings chart displays the average revenue per transaction influenced by Coveo product listing pages (PLPs) that occurred within the chosen filters.

The line graph delineates the variance of the average over a specific period of time.

How is the average order value influenced by chart-name calculated?

The sum of the total revenue attributed to product listing events, divided by the total number of transactions attributed to product listing events.

Average clickthrough rate chart

The Average clickthrough rate chart displays the ratio between the number of product listing events that were followed by at least one related click event, out of the total number of product listing events, within the chosen filters.

The line graph delineates the variance of the average clickthrough rate over a specific period of time.

How is the average clickthrough rate calculated?

The number of product listing events that were followed by at least one click event (with a matching unique identifier value), divided by the total number of product listing events.

Average click rank chart

Tip

A lower click rank is better, because it means that the product was well positioned.

The Average click rank chart displays the average position of a product when customers have clicked or interacted with it on a product listing page (PLP), within the chosen filters.

The line graph delineates the variance of the average click rank over a specific period of time.

How is the average click rank calculated?

The average position value for all click events that followed a product listing event.

Total product listing events chart

The Total product listing events chart displays the total number of product listing events, within the chosen filters.

The line graph delineates the variance of the total over a specific period of time.

Top selling products chart

A list of the top ten products or product groups on product listing pages (PLPs) that generated the most revenue, within the chosen filters.

How are top selling products calculated?

The products or product groups contained in click events that followed a product listing event to which a purchase was attributed and that generated the most revenue.

Discrepancies between reports

Figures shown for metrics in the Commerce Advanced 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 Coveo Merchandising Hub (CMH) 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, 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 coveo and Coveo are counted as separate queries in Commerce Advanced Reports and CMH reports, but as the same query on the Reports page.