---
title: Recommendation dashboard
slug: m16h0193
canonical_url: https://docs.coveo.com/en/m16h0193/
collection: coveo-for-commerce
source_format: adoc
---
# Recommendation dashboard

The **Recommendation** dashboard 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 recommendations.
As in the **Overview** dashboard, you can view basic metrics such as clickthrough rates, click ranks, and more.
However, the **Recommendation** dashboard emphasizes [recommendation attribution](#what-is-recommendation-attribution).

The **Recommendation** dashboard includes the following metric charts:

* [Revenue from recommendations](#revenue-from-recommendations-chart)

* [Transactions from recommendations](#transactions-from-recommendations-chart)

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

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

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

* [Recommendation components](#recommendation-components-chart)

* [Total recommendation events](#total-recommendation-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 **Recommendation** [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 recommendation event?

In this article, the term _recommendation event_ is often used in metric definitions.

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

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

A recommendation event is triggered when a request is made to the [recommendations](https://docs.coveo.com/en/103#tag/Recommendations) endpoint of the Commerce API.

</details>

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

In practice, a recommendation event can be any of the following:

* A [search event](https://docs.coveo.com/en/2949#search-performsearch) in which the [`originLevel1`](https://docs.coveo.com/en/1502#originlevel1-string) value contains the word `Recs`.

* A search event in which the [`actionCause`](https://docs.coveo.com/en/1502#actioncause-string) value is `recommendationInterfaceLoad`.

* A [click event](https://docs.coveo.com/en/2949#click-documentview) in which the [`actionCause`](https://docs.coveo.com/en/2064#actioncause-string) value is `recommendationOpen`.

</details>

## What is recommendation attribution?

--
![A click action on a recommended product | Coveo for Commerce](coveo-for-commerce/images/value-reporting/attribution-recommendation.png)
Coveo [attributes](https://docs.coveo.com/en/m7l98577/) a product in a transaction to the Recommendation [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 from a [recommendation slot](https://docs.coveo.com/en/o9b80563/).

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 Recommendation [solution](https://docs.coveo.com/en/o9cf0524/), see [About recommendation attribution](https://docs.coveo.com/en/m1ae0440#about-recommendation-attribution).

The **Recommendation** dashboard shows how Coveo-powered product recommendations 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 Recommendation [solution](https://docs.coveo.com/en/o9cf0524/):

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

## Revenue from recommendations chart

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

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

## How is the revenue from recommendations calculated?

Expand the following sections to learn how the revenue from recommendations 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 [recommendation events](#what-is-a-recommendation-event).

```txt
SUM (gross revenue attributed to Coveo recommendations)
```

</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 [recommendation events](#what-is-a-recommendation-event).

```txt
SUM (gross revenue attributed to Coveo recommendations)
```

</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 recommendations chart

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

**Event protocol**
<details><summary>Details</summary>

The **Transactions from recommendations** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo recommendations 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 recommendations** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo recommendations 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 recommendations calculated?

Expand the following sections to learn how transactions from recommendations 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 [recommendation events](#what-is-a-recommendation-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 recommendations)
```

</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 [recommendation events](#what-is-a-recommendation-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 recommendations)
```

</details>

## Conversion rate from recommendations chart

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

The sum of the completed [sessions](https://docs.coveo.com/en/oa8g3582/) involving Coveo recommendations with at least one [transaction](#transactions-from-recommendations-chart), divided by the sum of the completed sessions with at least one recommendation event, multiplied by 100.

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

:leveloffset!:

## Average order value influenced by recommendations chart

The **Average order value influenced by recommendations** chart displays the average gross [revenue](#revenue-from-recommendations-chart) per [transaction](#transactions-from-recommendations-chart) influenced by Coveo recommendations 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 recommendations calculated?

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

```txt
SUM (gross revenue attributed to Coveo recommendations) / SUM (transactions attributed to Coveo recommendations)
```

:leveloffset!:

## Average clickthrough rate chart

The **Average clickthrough rate** chart displays the ratio between the number of [recommendation events](#what-is-a-recommendation-event) that were followed by at least one related click event, out of the total number of recommendation 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 [recommendation events](#what-is-a-recommendation-event) that were followed by at least one click event (with a matching unique identifier value), divided by the total number of recommendation events.

```txt
SUM (recommendation events followed by a click event) / SUM (recommendation events)
```

## Recommendation components chart

The **Recommendation component** chart displays a list of the [recommendation slots](https://docs.coveo.com/en/o9b80563/) with the most interactions, as well as the [revenue](#revenue-from-recommendations-chart) generated by each component, within the chosen filters.

### How are recommendation components calculated?

For each recommendation component, the chart displays the following metrics:

* **Total searches**: The number of [recommendation events](#what-is-a-recommendation-event) triggered by the component.

* **With clicks**: The [recommendation events](#what-is-a-recommendation-event) followed by a click event.

* **Revenue**: The [revenue](#revenue-from-recommendations-chart) generated by the component.

## Total recommendation events chart

The **Total recommendation events** chart displays the total number of [recommendation events](#what-is-a-recommendation-event), within the chosen filters.

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

```txt
SUM (recommendation events)
```

## Top selling products chart

A list of the top ten products or product groups in [recommendation slots](https://docs.coveo.com/en/o9b80563/) that generated the most net [revenue](#revenue-from-recommendations-chart), within the chosen filters.

### How are top selling products calculated?

The products or product groups contained in click events that followed a [recommendation event](#what-is-a-recommendation-event) to which a purchase was [attributed](https://docs.coveo.com/en/m7l98577/) and that generated the most net [revenue](#revenue-from-recommendations-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.