---
title: Product listing dashboard
slug: m16f0307
canonical_url: https://docs.coveo.com/en/m16f0307/
collection: coveo-for-commerce
source_format: adoc
---
# Product listing dashboard

The **Product listing** [dashboard](https://docs.coveo.com/en/256/) on the [**Advanced Reports**](https://platform.cloud.coveo.com/admin/#/orgid/usage/advanced-reports/) ([platform-ca](https://platform-ca.cloud.coveo.com/admin/#/orgid/usage/advanced-reports/) | [platform-eu](https://platform-eu.cloud.coveo.com/admin/#/orgid/usage/advanced-reports/) | [platform-au](https://platform-au.cloud.coveo.com/admin/#/orgid/usage/advanced-reports/)) page provides an in-depth view of the top-performing [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/).
As in the **Overview** [dashboard](https://docs.coveo.com/en/256/), you can view basic [metrics](https://docs.coveo.com/en/263/) such as revenue, conversion rate, clickthrough rate, and more.
However, the **Product listing** [dashboard](https://docs.coveo.com/en/256/) emphasizes [product listing attribution](#what-is-product-listing-attribution).

![The Product listing dashboard | Coveo for Commerce](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/value-reporting/dashboard-listing.png)

The **Product listing** [dashboard](https://docs.coveo.com/en/256/) includes the following [metric](https://docs.coveo.com/en/263/) charts:

* [Revenue from product listings](#revenue-from-product-listings-chart)

* [Transactions from product listings](#transactions-from-product-listings-chart)

* [Conversion rate from product listings](#conversion-rate-from-product-listings-chart)

* [Average order value influenced by product listings](#average-order-value-influenced-by-product-listings-chart)

* [Average clickthrough rate](#average-clickthrough-rate-chart)

* [Average click rank](#average-click-rank-chart)

* [Total product listing events](#total-product-listing-events-chart)

* [Top selling products](#top-selling-products-chart)

## What is a session?

Although [sessions](https://docs.coveo.com/en/oa8g3582/) aren't specifically listed in the **Product listing** [dashboard](https://docs.coveo.com/en/256/), they're often used to calculate the [metrics](https://docs.coveo.com/en/263/) listed there.

At Coveo, a [session](https://docs.coveo.com/en/oa8g3582/) starts with the first [event](https://docs.coveo.com/en/260/) a [visitor](https://docs.coveo.com/en/nbub9475/) generates and ends after 30 minutes of inactivity.
For a given [visitor](https://docs.coveo.com/en/nbub9475/), if a new [event](https://docs.coveo.com/en/260/) is generated after 30 minutes of inactivity, it results in a new [session](https://docs.coveo.com/en/oa8g3582/) with a new [visit ID](https://docs.coveo.com/en/272/).

To be considered Coveo-related, the [session](https://docs.coveo.com/en/oa8g3582/) 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](https://docs.coveo.com/en/263/) definitions to simplify the explanation.
However, this isn't an official [Coveo Analytics event](https://docs.coveo.com/en/260/) 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**
<details><summary>Details</summary>

A product listing event is triggered when a request is made to the [listing](https://docs.coveo.com/en/103#tag/Listings/operation/getListing) endpoint of the Commerce API.

</details>

**Search API**
<details><summary>Details</summary>

In practice, a product listing event is a [search event](https://docs.coveo.com/en/1502/) that's triggered when a [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187/) loads.
This happens when a [query](https://docs.coveo.com/en/231/) is made to the Search API to retrieve the products to display on the page.
To trigger a product listing event, the [query](https://docs.coveo.com/en/231/) must contain the word `listing` in the [`searchHub`](https://docs.coveo.com/en/13#operation/searchUsingPost-searchHub) query parameter.

</details>

## What is product listing attribution?

--
![A click action on a product category | Coveo for Commerce](coveo-for-commerce/images/value-reporting/attribution-product-listing.png)
Coveo [attributes](https://docs.coveo.com/en/m7l98577/) a product in a transaction to the Product listing [product discovery solution](https://docs.coveo.com/en/o9cf0524/) if the [visitor](https://docs.coveo.com/en/nbub9475/)’s last registered click action before purchasing the product was selecting it on a [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187/).

The events that are tracked as part of the user journey differ depending on the protocol you're using ([Event Protocol](https://docs.coveo.com/en/o1n91230/) or [Coveo UA Protocol](https://docs.coveo.com/en/o1n91392/)) and the Coveo API you're making calls to ([Commerce API](https://docs.coveo.com/en/103/) or [Search API](https://docs.coveo.com/en/13/)).

For more details about how [attribution](https://docs.coveo.com/en/m7l98577/) is tracked for the Product listing [solution](https://docs.coveo.com/en/o9cf0524/), see [About product listing attribution](https://docs.coveo.com/en/m1ae0440#about-product-listing-attribution).

The **Product listing** dashboard shows how Coveo-powered on a [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187/) have contributed to your key commerce metrics.
--

The following diagram illustrates the sequence of events in which Coveo [attributes](https://docs.coveo.com/en/m7l98577/) a product to the Product listing [solution](https://docs.coveo.com/en/o9cf0524/):

![Product listing attribution sequence | Coveo for Commerce](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/value-reporting/attribution-sequence-product-listing.png)

## Revenue from product listings chart

The **Revenue from product listings** chart displays the sum of the [gross revenue](https://docs.coveo.com/en/nc1a0009#gross-revenue) influenced by Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) that occurred within the chosen filters.

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

## How is the revenue from product listings calculated?

Expand the following sections to learn how the 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**
<details><summary>Details</summary>

The sum of the [gross](https://docs.coveo.com/en/nc1a0009#gross-revenue) [`revenue`](https://docs.coveo.com/en/n9da0377#ec.purchase) (from the `transaction` property) from every product sold in each [purchase event](https://docs.coveo.com/en/o1n93059/) that was [attributed](https://docs.coveo.com/en/m7l98577/) to [product listing events](#what-is-a-product-listing-event).

```txt
SUM (gross revenue attributed to Coveo product listing pages)
```

</details>

**Coveo UA**
<details><summary>Details</summary>

The sum of the gross [`revenue`](https://docs.coveo.com/en/l29e0540#revenue-monetary-values) from every product sold in each [purchase event](https://docs.coveo.com/en/l39m0327/) that was [attributed](https://docs.coveo.com/en/m7l98577/) to [product listing events](#what-is-a-product-listing-event).

```txt
SUM (gross revenue attributed to Coveo product listing pages)
```

</details>

:leveloffset!:

> **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**](#top-selling-products-chart) [metric](https://docs.coveo.com/en/263/) displays net revenue figures.
> All other reported revenue [metrics](https://docs.coveo.com/en/263/) use gross revenue, unless otherwise stated.
> 
> See [About revenue](https://docs.coveo.com/en/nc1a0009/) for more information on how the revenue [metrics](https://docs.coveo.com/en/263/) 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**
<details><summary>Details</summary>

The **Transactions from product listings** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) that occurred within the chosen filters.

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

</details>

**Coveo UA**
<details><summary>Details</summary>

The **Transactions from product listings** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) that occurred within the chosen filters.

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

</details>

### 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**
<details><summary>Details</summary>

The total number of purchase events [attributed](https://docs.coveo.com/en/m7l98577/) to [product listing events](#what-is-a-product-listing-event).

See [Capture purchase events](https://docs.coveo.com/en/o1n93059/) for more information on how purchase events are logged and measured.

```txt
SUM (purchase events attributed to Coveo product listing pages)
```

</details>

**Coveo UA**
<details><summary>Details</summary>

The total number of [commerce events](https://docs.coveo.com/en/l29e0540/) that contain the `purchase` [action](https://docs.coveo.com/en/l29e0540#product-action-types) and are [attributed](https://docs.coveo.com/en/m7l98577/) to [product listing events](#what-is-a-product-listing-event).

See [Capture a purchase event](https://docs.coveo.com/en/l39m0327/) for more information on how purchase events are logged and measured.

```txt
SUM (commerce events with action = purchase attributed to Coveo product listing pages)
```

</details>

## Conversion rate from product listings chart

The **Conversion rate from product listings** chart displays the sum of the completed [sessions](https://docs.coveo.com/en/oa8g3582/) that involved Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) with at least one transaction, divided by the sum of completed sessions that involved Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/), 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?

The sum of the completed [sessions](https://docs.coveo.com/en/oa8g3582/) involving Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) with at least one [transaction](#transactions-from-product-listings-chart), divided by the sum of the completed sessions with at least one [product listing event](#what-is-a-product-listing-event), multiplied by 100.

```txt
SUM (completed sessions involving Coveo product listing pages with at least one transaction) / SUM (completed sessions involving Coveo product listing pages) * 100
```

:leveloffset!:

## Average order value influenced by product listings chart

The **Average order value influenced by product listings** chart displays the average gross [revenue](#revenue-from-product-listings-chart) per [transaction](#transactions-from-product-listings-chart) influenced by Coveo [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) 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 product listings calculated?

The sum of the gross [revenue](#revenue-from-product-listings-chart) [attributed](https://docs.coveo.com/en/m7l98577/) to [product listing events](#what-is-a-product-listing-event), divided by the total number of [transactions](#transactions-from-product-listings-chart) [attributed](https://docs.coveo.com/en/m7l98577/) to product listing events.

```txt
SUM (gross revenue attributed to Coveo product listing pages) / SUM (transactions attributed to Coveo product listing pages)
```

:leveloffset!:

## Average clickthrough rate chart

The **Average clickthrough rate** chart displays the ratio between the number of [product listing events](#what-is-a-product-listing-event) 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](https://docs.coveo.com/en/2041#search-event-clickthrough-2) over a specific period of time.

### How is the average clickthrough rate calculated?

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

```txt
SUM (product listing events followed by a click event) / SUM (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 clicked products on a [product listing page (PLP)](https://docs.coveo.com/en/m1sf3187/), within the chosen filters.

The line graph delineates the variance of the [average click rank](https://docs.coveo.com/en/2041#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](#what-is-a-product-listing-event).

```txt
SUM (position values for all click events that followed a product listing event) / SUM (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](#what-is-a-product-listing-event), within the chosen filters.

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

```txt
SUM (product listing events)
```

## Top selling products chart

A list of the top ten products or product groups on [product listing pages (PLPs)](https://docs.coveo.com/en/m1sf3187/) that generated the most net [revenue](#revenue-from-product-listings-chart), 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](#what-is-a-product-listing-event) to which a purchase was [attributed](https://docs.coveo.com/en/m7l98577/) and that generated the most net [revenue](#revenue-from-product-listings-chart).

## Discrepancies between reports

Figures shown for metrics in the Commerce Advanced 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.