Product listings dashboard

This is for:

Developer

The Product Listings dashboard of the Advanced reports (platform-ca | platform-eu | platform-au) page provides an in-depth view of the top performing product listing pages. Like in the Overview dashboard, you can view basic metrics such as revenue, conversion rate, clickthrough rate, and more. However, the Product Listings dashboard provides an emphasis on product listing attributions.

AdvancedDashboardProductlisting

The Product Listings dashboard comprises 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 Product Listings 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 product listings attribution?

The Product listings dashboard shows the extent to which Coveo-powered product listing pages 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 click on a search result that was shown on a product listing page they accessed by selecting a product category, we attribute the purchase to Coveo product listings.

capture showing a click on a product category | Coveo

In this case, selecting a product category sends a request to the Search API, which generates a unique ID called searchUid.

Sending this request causes the product listing page to load and display products that are relevant to the selected category, 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, 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 Listings service was responsible for the purchase.

Revenue from product listings chart

The Revenue from Product Listings chart displays the total revenue influenced by Coveo product listing pages that were consulted within the chosen filters.

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

How is the revenue from product listings calculated?

Revenue from product listings is calculated by adding up the revenue from every product sold in each purchase event that was attributed to Coveo product listing search events (search events for which the originLevel1 value contains Listings).

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 product listings chart

The Transactions from Product Listings chart displays the total number of purchase events influenced by product listing pages that were consulted within the chosen filters.

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

How are the transactions from product listings calculated?

The total number of commerce events that contain the purchase action and attributed to Coveo product listing search events (search events for which the originLevel1 value contains Listings).

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

Conversion rate from product listings chart

The Conversion Rate from Product Listings chart displays the number of transactions that was attributed to Coveo product listing pages 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 product listings calculated?

The number of transactions attributed to Coveo product listing pages (search events for which the originLevel1 value contains Listings) divided by the total number of sessions in which at least one Coveo product listing search event occurred, multiplied by 100.

Average order value influenced by product listings chart

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

Dividing the sum of the total revenue attributed to Coveo product listing search events (search events for which the originLevel1 value contains Listings) by the total number of transactions attributed to Coveo product listing search events.

Clickthrough rate chart

The Click Through Rate chart displays the percentage of search events influenced by Coveo product listing pages that were followed by at least one related click event out of the total number of search events influenced by Coveo product listing pages that were consulted within the chosen filters.

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

How is the clickthrough rate calculated?

The total number of search events for which the originLevel1 value contains Listings that were followed by at least one click event (with a matching searchQueryUid value), divided by the total number of search events for which the originLevel1 value contains Listings.

Average click rank chart

The Average Click Rank chart displays the average position of a product when customers have clicked or interacted with it on a product listings page, 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 that followed a search event for which the originLevel1 value contains Listings.

Top 10 product listings chart

The Top 10 Product Listings chart displays a list of the ten product listing pages that generated the most revenue.

To view more metrics on the top queries, click View More.

In the window that opens, you can specify the number of queries you want to view by entering the number in the Show Top text box, and then filter through the queries by entering a keyword in the Filter by Keyword text box.

How are top 10 product listings calculated?

Summing the revenue of purchase events attributed to a given product listing page.

We then list the ten product listing pages that generated the most revenue.

Top categories with redirects chart

The Top Categories with Redirects chart displays a list of the top ten categories with redirects that generated the most revenue.

In Coveo-powered Commerce implementation, a redirect is when a click on a web category leads to a brand page.

How are top categories with redirect calculated?

Redirects are custom events for which the eventType value is queryPipelineTriggers AND eventValue value is redirect. They are triggered along with a product listing search event (search event for which the originLevel1 value contains Listings) when a user accesses a brand-oriented listing page.

When the events are attributed to purchases, we sum the revenue of related purchase events to calculate the total revenue generated by that listing page.

Total product listings events chart

The Total Product Listings Events chart displays the total number of searches triggered by a click on any web category, within the chosen filters.

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

How are product listing search events calculated?

The total number of product listing search events (search events for which the originLevel1 value contains Listings).

Top selling products chart

A list of the top ten products or product groups clicked on listing pages 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 for which the originLevel1 value contains Listings to which a purchase was attributed and that generated the most revenue.