Search dashboard

What’s a session?

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

At Coveo, a session (or visit) starts with the first event a customer (or 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’s search attribution?

Coveo attributes a product in a transaction to the search product discovery solution if a visitor's last registered click action before purchasing the product was selecting it from the search results that were returned after performing a query in the search box.

A search in a search bar | Coveo for Commerce

The search dashboard shows how Coveo-powered searches have contributed to your key commerce metrics.

For more details about how attribution is tracked for the search solution, see About search attribution.

Item revenue from searches chart

The Item revenue from searches chart displays the total 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’s the item revenue from searches calculated?

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

Note

Revenue is reported in USD and calculated in two ways: gross and net revenue.

Gross revenue includes the taxes, shipping costs, and discounts, whereas net revenue excludes the taxes and shipping costs.

All reported revenue metrics use gross revenue (unless otherwise stated), except for the Top selling products metric, which display net revenue figures.

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

Transactions from searches chart

The Transactions from searches chart displays the total number of purchase events 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?

The total number of commerce events that contain the purchase action and attributed to Coveo searches.

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

Conversion rate from searches chart

The Conversion rate from searches chart displays the number of transactions that was attributed to Coveo-powered searches over the total number of sessions, within the chosen filters.

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

How’s the conversion rate from searches calculated?

The number of transactions attributed to Coveo searches divided by the total number of sessions in which at least one search event triggered by a search query occurred, multiplied by 100.

Average order value influenced by searches chart

The Average order value influenced by searches chart displays the average revenue per transaction influenced by Coveo-powered searches, within the chosen filters.

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

How’s the average order value influenced by searches calculated?

Dividing the sum of the total revenue attributed to Coveo searches by the total number of transactions attributed to Coveo searches.

Average clickthrough rate chart

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

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

How’s the average clickthrough rate calculated?

Total number of search events triggered by search queries, that were followed by at least one click event (with a matching searchQueryUid value), divided by the total number of search events triggered by search queries.

Average click rank chart

The Average click rank chart displays the average position of a product when customers have clicked or interacted with it following a Coveo search, within the chosen filters.

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

Tip

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

How’s the average click rank calculated?

The average of the documentPosition value for all click events that followed a search event triggered by a search query.

Top queries and search events chart

This chart displays a list of the top user queries (Query expressions) organized by the attributed number of Coveo searches and their respective total revenue, within the chosen filters.

How are top queries and search events calculated?

In search events triggered by a search query, we look for the expressions that appear in the queryText property the most often.

When purchases are attributed to Coveo searches, we sum the revenue of related purchase events (that contain the same query text) to calculate the total revenue 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 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 search event typically happens after a manual search, when a visitor takes an action that refines a search, like interacting with facets 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 (also known as Did You Mean) feature automatically corrects a user’s query.

    • The search-as-you-type 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 value isn’t recognized.

How are total search events calculated?

The total number of search events triggered by a search query. We then look at the actionCause value to determine whether it’s a manual, refinement, automatic, or unclassified search event.

Note

Requests to the Commerce API don’t need to specify the actionCause value as this is automatically inferred by the Coveo platform.

Top selling products chart

A list of the top ten products or product groups 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 search event, triggered by a search query to which a purchase was attributed, that generated the most revenue.