--- title: Search dashboard slug: m16c0086 canonical_url: https://docs.coveo.com/en/m16c0086/ collection: coveo-for-commerce source_format: adoc --- # Search dashboard The **Search** [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 [attribution](#what-is-search-attribution) that's specific to the Search [product discovery solution](https://docs.coveo.com/en/o9cf0524/). It's divided into several charts, each dedicated to a key [metric](https://docs.coveo.com/en/263/). ![The Search dashboard | Coveo for Commerce](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/value-reporting/dashboard-search.png) The **Search** [dashboard](https://docs.coveo.com/en/256/) includes the following [metric](https://docs.coveo.com/en/263/) charts: * [Revenue from searches](#revenue-from-searches-chart) * [Transactions from searches](#transactions-from-searches-chart) * [Conversion rate from searches](#conversion-rate-from-searches-chart) * [Average order value influenced by searches](#average-order-value-influenced-by-searches-chart) * [Average clickthrough rate](#average-clickthrough-rate-chart) * [Average click rank](#average-click-rank-chart) * [Top queries and search events](#top-queries-and-search-events-chart) * [Total search events](#total-search-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 **Search-UA** [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 search attribution? -- ![A click action on a search result | Coveo for Commerce](coveo-for-commerce/images/value-reporting/attribution-search.png) Coveo [attributes](https://docs.coveo.com/en/m7l98577/) a product in a transaction to the Search-UA [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 the search results that were returned after performing a [query](https://docs.coveo.com/en/231/) in the search box. 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 Search-UA [solution](https://docs.coveo.com/en/o9cf0524/), see [About search attribution](https://docs.coveo.com/en/m1ae0440#about-search-attribution). The **Search-UA** dashboard shows how Coveo-powered searches 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 Search-UA [solution](https://docs.coveo.com/en/o9cf0524/): ![Search-UA attribution sequence | Coveo for Commerce](https://docs.coveo.com/en/assets/images/coveo-for-commerce/images/value-reporting/attribution-sequence-search.png) ## Revenue from searches chart The **Revenue from searches** chart displays the sum of the [gross revenue](https://docs.coveo.com/en/nc1a0009#gross-revenue) influenced by Coveo-powered searches (coming from the search bar) that occurred within the chosen filters. The line graph delineates the revenue variance over a specific period of time. ## How is the revenue from searches calculated? Expand the following sections to learn how the revenue from searches is calculated, based on whether you're tracking events using the Coveo Event protocol or the Coveo UA protocol: **Event protocol**
Details 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 Coveo searches. ```txt SUM (gross revenue attributed to Coveo searches) ```
**Coveo UA**
Details 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 Coveo searches. ```txt SUM (gross revenue attributed to Coveo searches) ```
: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 searches chart Expand the following sections to learn about the **Transactions from searches** chart based on the tracking method you use: **Event protocol**
Details The **Transactions from searches** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo-powered searches (coming from the search bar) that occurred within the chosen filters. The line graph delineates the variance of the purchase events over a specific period of time.
**Coveo UA**
Details The **Transactions from searches** chart displays the total number of [purchase events](https://docs.coveo.com/en/l39m0327/) influenced by Coveo-powered searches (coming from the search bar) 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 searches calculated? Expand the following sections to learn how transactions from searches are calculated, based on the tracking method you use: **Event protocol**
Details The total number of purchase events [attributed](https://docs.coveo.com/en/m7l98577/) to Coveo searches. 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 searches) ```
**Coveo UA**
Details 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 Coveo searches. 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 searches) ```
## Conversion rate from searches chart The **Conversion rate from searches** chart displays the sum of the completed [sessions](https://docs.coveo.com/en/oa8g3582/) that involved Coveo-powered searches (coming from the search bar) with at least one transaction, divided by the sum of completed sessions that involved Coveo-powered searches (coming from the search bar), 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 searches calculated? The sum of the completed [sessions](https://docs.coveo.com/en/oa8g3582/) involving Coveo-powered searches (coming from the search bar) with at least one [transaction](#transactions-from-searches-chart), divided by the sum of the completed sessions with at least one [search event](https://docs.coveo.com/en/2949#search-performsearch) triggered by a search query, multiplied by 100. ```txt SUM (completed sessions involving Coveo searches with at least one transaction) / SUM (completed sessions involving Coveo searches) * 100 ``` :leveloffset!: ## Average order value influenced by searches chart The **Average order value influenced by searches** chart displays the average gross [revenue](#revenue-from-searches-chart) per [transaction](#transactions-from-searches-chart) influenced by Coveo-powered searches (coming from the search bar) 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 searches calculated? The sum of the gross [revenue](#revenue-from-searches-chart) [attributed](https://docs.coveo.com/en/m7l98577/) to Coveo searches, divided by the total number of [transactions](#transactions-from-searches-chart) [attributed](https://docs.coveo.com/en/m7l98577/) to Coveo searches. ```txt SUM (gross revenue attributed to Coveo searches) / SUM (transactions attributed to Coveo searches) ``` :leveloffset!: ## Average clickthrough rate chart Expand the following sections to learn how the average clickthrough rate is calculated, based on the tracking method you use: **Commerce API**
Details The **Average clickthrough rate** chart displays the ratio between the number of [search events](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) that were followed by at least one related click event, out of the total number of search events influenced by Coveo-powered searches, 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.
**Search API**
Details The **Average clickthrough rate** chart displays the ratio between the number of [search events](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) that were followed by at least one related click event, out of the total number of search events influenced by Coveo-powered searches, 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? Expand the following sections to learn how the average clickthrough rate is calculated, based on the Coveo API your implementation targets: **Commerce API**
Details The sum of [search events](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) that were followed by at least one click event (with a matching unique identifier value), divided by the total number of search events influenced by Coveo-powered searches. ```txt SUM (search requests to the Commerce API followed by a click event) / SUM (search requests to the Commerce API) ```
**Search API**
Details The sum of [search events](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) that were followed by at least one click event (with a matching unique identifier value), divided by the total number of search events influenced by Coveo-powered searches. ```txt SUM (search events influenced by Coveo-powered searches followed by a click event) / SUM (search events influenced by Coveo-powered searches) ```
## 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 searches, 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? Expand the following sections to learn how the average click rank is calculated, based on the Coveo API your implementation targets: **Commerce API**
Details The average position value for all click events that followed a [search event](https://docs.coveo.com/en/2949#search-performsearch) triggered by a search query. ```txt SUM (position values for all click events that followed a Coveo search) / SUM (click events that followed a Coveo search) ```
**Search API**
Details The average position value for all click events that followed a [search event](https://docs.coveo.com/en/2949#search-performsearch) triggered by a search query. ```txt SUM (documentPosition values for all click events that followed a search event) / SUM (click events that followed a search event) ```
## Top queries and search events chart This chart displays a list of the top user queries (**Query expressions**) organized by the [attributed](https://docs.coveo.com/en/m7l98577/) number of Coveo searches and their respective total [revenue](#revenue-from-searches-chart), within the chosen filters. ### How are top queries and search events calculated? Expand the following sections to learn how the top queries and search events are calculated, based on the Coveo API your implementation targets: **Commerce API**
Details The expressions that appear in the `query` property of [search requests to the Commerce API](https://docs.coveo.com/en/103#tag/Search) the most often.
**Search API**
Details The expressions that appear in the [`queryText`](https://docs.coveo.com/en/1502#querytext-string) property the most often in [search events](https://docs.coveo.com/en/2949#search-performsearch) triggered by a search query.
When purchases are [attributed](https://docs.coveo.com/en/m7l98577/) to the Search [solution](https://docs.coveo.com/en/o9cf0524/), the sum of the [revenue](#revenue-from-searches-chart) of related purchase events is used to calculate the total [revenue](#revenue-from-searches-chart) generated by that specific query. ## Total search events chart The **Total search events** chart displays the total number of search events. The total is broken down into _manual_, _refinement_, _automatic_, or _unclassified_ search events: * A [manual](https://docs.coveo.com/en/2041#manual-search-event-count) search event happens when a visitor takes a manual action that causes products to be displayed, like sending a query from the search box. * A [refinement](https://docs.coveo.com/en/2041#refined-search-event-count) search event typically happens after a manual search, when a visitor takes an action that refines a search, like interacting with [facets](https://docs.coveo.com/en/198/) or sort options. * An automatic search event happens when a search event is triggered automatically by a Coveo-powered feature, such as when: ** The [query correction](https://docs.coveo.com/en/1810/) (also known as _Did You Mean_) feature automatically corrects a user's query. ** The [search-as-you-type](https://docs.coveo.com/en/2068/) feature triggers search events when a user types a query in the search box. ** A Coveo-powered interface loads without any user interaction, such as when a user lands on a page where search results are automatically displayed. * An unclassified search event, depending on whether your implementation targets the Commerce API or Search API, is: ** Commerce API: Any search event that doesn't fall into the manual, refinement, or automatic categories. ** Search API: Any search event for which the [`actionCause`](https://docs.coveo.com/en/1502#actioncause-string) value isn't recognized. ### How are total search events calculated? Expand the following sections to learn how total search events are calculated, based on the Coveo API your implementation targets: **Commerce API**
Details The total number of [search requests](https://docs.coveo.com/en/103#tag/Search) made to the Commerce API. ```txt SUM (search requests to the Commerce API) ``` [NOTE] **Note**
Requests to the Commerce API don't need to specify the `actionCause` value, as this is automatically inferred by the Coveo platform. ##### ==== **Search API**
Details The total number of [search events](https://docs.coveo.com/en/2949#search-performsearch) triggered by a search query. The [`actionCause`](https://docs.coveo.com/en/1502#actioncause-string) value is used to determine whether it's a manual, refinement, automatic, or unclassified search event. ```txt SUM (search events triggered by a search query) ```
## Top selling products chart A list of the top ten products or product groups in search results that generated the most net [revenue](#revenue-from-searches-chart), within the chosen filters. ### How are top selling products calculated? Expand the following sections to learn how the top selling products are calculated based on the Coveo API your implementation targets: **Commerce API**
Details The products or product groups contained in click events that followed a [search event](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) to which a purchase was [attributed](https://docs.coveo.com/en/m7l98577/) and that generated the most net [revenue](#revenue-from-searches-chart).
**Search API**
Details The products or product groups contained in click events that followed a [search event](https://docs.coveo.com/en/2949#search-performsearch) influenced by Coveo-powered searches (coming from the search bar) to which a purchase was [attributed](https://docs.coveo.com/en/m7l98577/) and that generated the most net [revenue](#revenue-from-searches-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.