> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md).

# Statistics

Where you see displays, clicks, carts and revenue from recommendations and how the figures are calculated.

Cross Selling Pro measures how your recommendations perform: how often they are seen, how often customers click on them, add products from them to the cart and buy. You find the figures in several places in the Shopware admin, from a quick look on the start page to the analysis per element or product. This page shows where to find what and how to read the figures.

## Where to find which figures

| Place                        | Path                                                                    | Content                                                                 | Plan                                   |
| ---------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- | -------------------------------------- |
| Statistics                   | Sidebar **Overview → Statistics**                                       | Detailed analysis with periods, placements, types, products, sets       | from Expert                            |
| CMS blocks                   | Sidebar **Overview → CMS blocks**                                       | All recommendation elements in Shopping Experiences with 30-day figures | list in all plans, figures from Expert |
| Widget statistics            | from the list of CMS blocks                                             | Daily and 30-day values and trends for a single element                 | from Expert                            |
| User tracking                | Sidebar **Overview → User tracking**                                    | Individual visitor journeys                                             | all plans                              |
| Product tab                  | **Catalogues → Products →** open a product → "InsightSearch statistics" | Figures for one product with and without recommendations                | no separate lock in the admin          |
| Tile on the admin start page | Shopware dashboard                                                      | Added value, top products, revenue per placement, status                | no separate lock in the admin          |

You reach the sidebar via **Content → InsightSearch**.

{% hint style="info" %}
All statistics require the Shopware permission to view orders. Without it, Shopware's permission lock appears when opening the page, and the tile on the start page stays hidden.
{% endhint %}

Without the Expert plan, locked areas show the notice "Full statistics" with "Compare plans".

## The area "Statistics"

{% hint style="info" %}
Available from the Expert plan.
{% endhint %}

This area shows an embedded analysis from your InsightSearch account. You choose a period of 7, 30 or 90 days, 12 months or a free range of up to 366 days. Calculations use the time zone of your shop.

Among other things you see:

* the funnel from display to order,
* revenue, orders and order values with and without recommendation, each compared with the previous period of the same length,
* breakdowns per placement, per recommendation type and per element,
* top products and product pairs (for which product a recommendation was shown and what went into the cart),
* orders from sets with set revenue, average set value, top sets and top add-on products,
* a separate funnel for the Conversion Booster.

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-dd814b5c2678691aa57b5296699ab6705b706f54%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-statistik.png?alt=media" alt="Statistics section with key figures and revenue per placement"><figcaption></figcaption></figure>

### Placements

The analysis separates by the place where the recommendation was shown:

| Placement                    | Meaning                                               |
| ---------------------------- | ----------------------------------------------------- |
| Offcanvas                    | Offcanvas cart                                        |
| Cart                         | Cart page                                             |
| Checkout                     | Checkout interstitial page                            |
| Sets                         | Bundle/set configurator on the product page           |
| Shopping Experience (slider) | Recommendation elements in Shopping Experiences       |
| Fallback                     | Fallback products when a template had too few results |

### The funnel

| Stage       | When it counts                                                                        |
| ----------- | ------------------------------------------------------------------------------------- |
| Display     | At least half of the recommendation block is in the visible area. Once per page view. |
| Click       | A customer clicks on a recommended product.                                           |
| Add to cart | A customer adds a product from the recommendation to the cart.                        |
| Order       | An order contains a product that was added to the cart from a recommendation.         |

Unique visits are counted per stage. A later stage can therefore never be larger than an earlier one.

## How revenue is attributed to recommendations

* A product counts as "via recommendations" if it was added to the cart from a recommendation. The plugin marks this on the cart line item, and the marker stays until the order.
* A click alone is not enough. If a customer later adds the product to the cart another way, it does not count as recommendation revenue.
* Recommendation revenue is the sum of the amounts of the recommended line items, not the whole order value.
* For sets, only the add-on products count, not the main product of the set.
* Amounts are shown in the main currency. Orders in other currencies are mentioned but not included.
* If the search plugin and Cross Selling Pro report the same order, it is counted only once.

{% hint style="warning" %}
A higher order value for orders with recommendations shows a correlation, not a proven effect.
{% endhint %}

### Which orders count

Cancelled orders never count. Paid orders, open orders and orders with an unknown payment status count.

Which Shopware transaction states count as paid or cancelled is set in the plugin configuration in the card "Tracking":

| Setting                                     | Default                                  | Also selectable    |
| ------------------------------------------- | ---------------------------------------- | ------------------ |
| "Transaction states considered "paid""      | Paid, Paid partially, Refunded partially | Open, Authorized   |
| "Transaction states considered "cancelled"" | Cancelled, Failed, Refunded              | Refunded partially |

If you change this selection, the orders of the last 90 days are re-evaluated automatically. To start this manually, use "Recalculate payment status" in the area "Sources". There you can also use "Sync" to add orders that have not been transferred yet.

## CMS blocks

The page "CMS recommendation widgets" lists all recommendation elements and the bundle/set element from your Shopping Experiences.

| Column                                                                         | Content                                           |
| ------------------------------------------------------------------------------ | ------------------------------------------------- |
| "CMS page", "Element", "Widget ID"                                             | Where the element is placed                       |
| "Recommendation type", "Template"                                              | What it shows ("No template" if none is selected) |
| "Loads (30 days)", "Clicks (30 days)", "Orders (30 days)", "Revenue (30 days)" | Figures, from the Expert plan                     |

At the top right you find "Reload CMS blocks" and "Refresh statistics". The row menu offers "Open widget stats".

### Widget statistics of an element

The detail page shows the "Performance overview" for a single element: loads, clicks, cart clicks, orders and order revenue for today and the last 30 days, plus the charts "Revenue trend (30 days)" and "Click trend (30 days)". "Refresh" reloads the values.

## User tracking

This page shows individual visitor journeys on which the personal recommendations are based. The list contains "Session ID", "Customer", "Events", "Clicks", "First seen", "Last seen", "Last event" and "Last page". "Details" opens the journey of one visit with pages, search terms, clicks, cart and order.

For logged in customers the visit is linked to the customer as long as "Send customer reference" is switched on in the plugin configuration. According to its help text, the customer ID and customer number are then sent to InsightSearch with orders, cart events and clicks. If the switch is off, these events are only linked by the session identifier.

## Product tab "InsightSearch statistics"

In a product under **Catalogues → Products** you find the tab "InsightSearch statistics" with the heading "Product statistics".

| Section                                            | Content                                                                                                                                                                                      |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "Totals"                                           | Clicks, cart events, cart quantity and value, orders, order quantity, order revenue, cart abandonments and abandonment rate, each with recommendations, without recommendations and in total |
| "Rates"                                            | Click to cart, cart to order, click to order, revenue share and cart value share with recommendations                                                                                        |
| "Breakdown by recommendation type" and "by widget" | Which types and elements sold the product                                                                                                                                                    |
| "Click event types", "Daily trends"                | Kinds of clicks and charts per day                                                                                                                                                           |

## Tile on the admin start page

On the start page of the Shopware admin, the tile "InsightSearch Cross-Selling" shows the most important values. You choose "Today", "7 days", "30 days" or "90 days"; calculations use the time zone of your browser. Links lead to "Open statistics" and "Open plugin configuration".

* **Added value:** the selected key figures compared with the previous period.
* **Top products (recommendation revenue)** and **Revenue per placement**.
* **Status:** quota with a projection for the end of the month, tracking of orders and cart, active placements per sales channel.

You configure the tile in the plugin configuration in the card "Admin dashboard":

| Setting                                            | Effect                                                 | Default                                                                                                                            |
| -------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- |
| "Show tiles on the admin dashboard"                | Tile on or off                                         | on                                                                                                                                 |
| "Position"                                         | Above or below the Shopware tiles                      | Below                                                                                                                              |
| "Default period"                                   | Period when opening                                    | Last 30 days                                                                                                                       |
| "Key figures in the "Added value" tile"            | Which key figures appear in which order                | Revenue from recommendations, Share of shop revenue, Average order value with / without recommendation, Orders with recommendation |
| "Show top products and revenue per placement"      | Sections on or off                                     | on                                                                                                                                 |
| "Show status (quota, tracking, active placements)" | Section on or off                                      | on                                                                                                                                 |
| "Show current notices"                             | Notices about incidents and maintenance above the tile | on                                                                                                                                 |

Further selectable key figures are "Share of orders with recommendation", "Units sold via recommendations", "Purchase rate (cart → order)" (requires cart tracking) and "Total shop revenue".

## When new figures appear

* Clicks, carts and orders appear after a few minutes if your shop's background processing is running. Shopware processes these events in the queue `low_priority`. If it is not running, figures arrive late or not at all, and the plugin dashboard shows a notice.
* Statistics results are cached for about 2 minutes.
* If "Events from the browser" is set to "Only with consent" or "Off", displays and click rate are partly or completely missing. The default is "Always (as before)".

## Data protection

Which data tracking collects, which cookies it sets and which switches exist is described on the page [Tracking and data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/tracking-and-data-protection.md). Coordinate the settings with your data protection officer.

## Read more

{% content-ref url="/pages/tS4JTCj4GmgmDzAXPYMj" %}
[Tracking and data protection](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/tracking-and-data-protection.md)
{% endcontent-ref %}

{% content-ref url="/pages/mKxITzjqofyIV1LBMwPL" %}
[Conversion Booster](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/conversion-booster.md)
{% endcontent-ref %}

{% content-ref url="/pages/e00VEeT8TubzE8TB5J6M" %}
[When do changes take effect?](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/when-changes-take-effect.md)
{% endcontent-ref %}

{% content-ref url="/pages/H7hG7KNHBotOdMhNijf5" %}
[Requirements and plans](https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/requirements-and-plans.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/en/apps/cross-selling-pro-ai-cart-cross-selling-bundles-and-sets/statistics.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
