Recommendation dashboard

This is for:

Developer

The Recommendation dashboard in the Advanced reports (platform-ca | platform-eu | platform-au) page provides an in-depth view of the top performing recommendations. Like in the Overview dashboard, you can view basic metrics such as clickthrough rates, click ranks, and more. However, the Recommendation dashboard provides an emphasis on recommendation attributions.

AdvancedDashboardRecommendation

The Recommendation dashboard includes the following metric charts:

Note

Your site currency is converted to USD, therefore the values are displayed as such in the dashboard. However, if the originating currency is unknown, the values can’t be converted but are still displayed and treated as USD.

What is a session?

Although sessions aren’t specifically listed in the Recommendation dashboard, they are often used in the calculation of the metrics listed in the dashboard.

At Coveo, a session (or visit) starts on the first event a visitor (customer) generates and ends after 30 minutes of inactivity.

For a given visitor, this means that if a new event is generated after 30 minutes of inactivity, this results in a new session, and a new visit ID is generated.

To be considered Coveo-related, the session must contain either search actions, listing actions, and/or recommendations actions.

What is a recommendation event?

In this article, the term recommendation event is often used in metric definitions.

A recommendation event can be either of the following:

What is recommendation attribution?

The Recommendation dashboard shows the extent to which Coveo-powered product recommendations have contributed to the performance of your key commerce metrics.

If the visitor’s last action before adding the product to their cart was to select a product from a recommendation interface, we attribute the purchase to Coveo recommendations.

capture showing a click on a recommended product | Coveo

Recommendation interfaces can appear in different places in a Coveo-powered website. For example, they can appear on home pages, cart pages, product detail pages, etc.

When a page containing a recommendation interface loads, a request to the Search API is sent to query products that will fill the recommendation component. The request generates a unique ID called searchUid.

Sending this request causes the recommendation interface to load and display the products returned by the request to the Search API, which sends a search event to Coveo.

This search event contains in its payload a searchQueryUid property which is filled with the value of the searchUid returned by the request to the Search API.

When the visitor clicks on a product from the recommendation interface, the click event sent to Coveo includes the searchQueryUid property filled with the value of the searchUid generated by the search query.

By tracking the unique ID value used throughout the actions leading up to the purchase, Coveo can determine that the Coveo Recommendations service was responsible for the purchase.

Revenue from recommendations chart

The Revenue From Recommendations chart displays the total revenue influenced by Coveo recommendations, within the chosen filters.

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

How is the revenue from recommendation calculated?

Revenue from recommendations is calculated by adding up the revenue from every product sold in each purchase event that was attributed to Coveo recommendation events.

Note

The Total revenue metric includes the taxes, shipping costs, and discounts, whereas the Net revenue metric excludes the taxes and shipping costs.

Transactions from recommendations chart

The Transactions From Recommendations chart displays the total number of purchase events influenced by Coveo recommendations, within the chosen filters.

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

How are the transactions from recommendations calculated?

Total number of commerce events that contain the purchase action and attributed to Coveo recommendation events.

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

Conversion rate from recommendations chart

The Conversion Rate From Recommendations chart displays the number of transactions that was attributed to Coveo recommendations over the total number of sessions, within the chosen filters.

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

How is the conversion rate from recommendations calculated?

The number of transactions attributed to Coveo recommendation events divided by the total number of sessions in which at least one Coveo recommendation event occurred.

Note

While searches and product listings are manually triggered by users, recommendations can only be interacted with by a click. Visits with at least one recommendation aren’t always representative of user behavior, since almost all sessions trigger recommendations. Therefore, we only consider sessions that have at least one click on a recommended product for conversion rates attributed to recommendations.

Average order value influenced by recommendations chart

The Average Order Value Influenced by Recommendations chart displays the average revenue per transaction event influenced by Coveo recommendations, 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?

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

Clickthrough rate chart

The Clickthrough Rate chart displays the percentage of Coveo recommendation events that were followed by at least one related click event out of the total number of Coveo recommendation events, within the chosen filters.

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

How is the clickthrough rate calculated?

The total number of Coveo recommendation events that were followed by at least one click event (with a matching searchQueryUid value), divided by the total number of Coveo recommendation events.

Average click rank chart

The Average Click Rank chart displays the average click position on recommended products, 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 is the average click rank calculated?

The average of the documentPosition value for all click events for which the actionCause value is recommendationOpen.

Top recommendation components chart

The Top Recommendation Components chart displays a list of the recommendation components that generated the most revenue, within the chose filters. A recommendation component refers to “where” on the website the recommended products appear (e.g., different recommendation components are typically used on product detail pages and on cart pages).

The recommendation component provides you with data on how well these pages perform in terms of the recommendation engine powered by the Coveo ML model.

How are top recommendation components calculated?

For every recommendation component that appears as the value of the originLevel1 property of a Coveo recommendation event, we sum all of the transactions that are attributed to every single recommendation component.

Total recommendation events chart

The Total Recommendation Events chart displays the total number of Coveo recommendation events that occurred within the chosen filters.

Top Selling Products Chart

A list of the top ten products or product groups clicked on recommendations that generated the most revenue, within the chosen filters.

How are top selling products calculated?

The products or product groups contained in Coveo recommendation events that generated the most revenue.