> 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/search-intelligent-and-ai-optimized/statistics.md).

# Statistics

Search metrics in the plugin dashboard and as a tile on the Shopware home page, with definitions, periods and CSV export.

The statistics show how your customers search and what the search delivers: search queries, clicks, searches without results, orders and revenue via search. You find them in the plugin dashboard in the group "Overview" under **Statistics**. A short version of the most important numbers is also available as a tile on the home page of the Shopware admin.

{% hint style="info" %}
Only admin users with the permission to view orders can see the statistics. If there is no search index yet, it says "No search index available".
{% endhint %}

## Layout

At the top is the toolbar, below it a time line, then the sub-areas. In the search plugin they are called "Overview", "Search quality", "Search terms", "Products" and "Revenue". A click on a search term or a product opens its own detail page.

### Periods and comparison

In the toolbar you choose the period with the buttons "Today", "7 days", "30 days" (default), "90 days" and "12 months", or freely with "From" and "To" (at most 366 days). "Refresh" reloads the numbers.

The checkbox "Compare with previous period" (default on) compares with the period of equal length directly before. Shares change in percentage points, all other values relatively in percent. For "Searches without results" and "Refined searches", a decrease counts as an improvement.

The time line names the period, the previous period, the time zone and the data's age.

### Cache

Numbers are cached. For periods that include today, they are about 5 minutes fresh. Completed periods are kept for several hours. The age is shown in the time line.

## The sub-areas

### Overview

Tiles with change against the previous period:

* "Revenue via search": the total order value of all orders attributed to the search.
* "Orders via search"
* "Ø order value with search", compared with "without search". This shows a correlation, not a proven effect.
* "Search queries", "Click rate", "Searches without results" (color-rated), "Purchase rate of search" and "Visits with search click".

Below follow charts and lists: "Revenue per day: via search vs. other orders", "Top search terms by revenue", "Path to order", "Trend per day" (searches, clicks, orders) and the "Origin of searches" (Typed, Suggestion, Recently searched, Popular searches, Correction, Rescue link).

If you have both the search and the recommendations plugin in your shop, a block "Search + recommendations" sits above, with visits in which both were used, the revenue from them and the "Rescued searches".

### Search quality

* Tiles: "Ø results", "Searches without results", "Click rate", "Ø click position" (lower means matching products appear higher), "Clicks in top 3" and "Quick view opened".
* Charts: "Clicks by hit position" and "Searches without results per day".
* Table "Top search terms without results" with the link "Edit lost opportunities" and a synonym link.
* Table "Search terms with low click rate".
* "Languages" and "Clicks by result type" (product, manufacturer, suggestion, goes with, substitute for searches without results and more).

### Search terms

The table "All search terms" shows per term searches, Ø results, clicks, click rate, orders, revenue, purchase rate and when it was last searched.

### Products

"Revenue via search by product", "Top products" and "Flop products (often shown, rarely clicked)". As long as impressions are not recorded, the last list is called "Often clicked, not bought".

### Revenue

Tiles for "Revenue via search", "Share of shop revenue", "Orders via search", "Units via search" and the Ø order values with and without search, plus a chart "Revenue per day" and the table "Revenue by search term". The revenue per term counts only items bought via the search and is therefore lower than the tile "Revenue via search".

### Detail pages

The **Search term** page shows search queries, searches without results, clicks, click rate, orders and revenue, the chart "Searches per day", the "Clicked products" and "Bought products" as well as the "Synonyms with this term" and "Rules for this term". With "Create synonym" and "Open rules in the plugin" you jump straight to maintenance.

The **Product** page shows clicks from the search, clicks on recommendations, "Added to cart", orders, revenue, the Ø position in the search and "Searched with".

## Metrics and their definitions

| Metric                              | Definition                                                                                                                                                   |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Search queries                      | How often customers searched. Further result pages of the same search, intermediate states while typing and bots do not count.                               |
| Searches without results            | Share of search queries that had no results even after the automatic rescue. Lower is better.                                                                |
| Ø hits per search                   | Average number of hits per search query.                                                                                                                     |
| Click rate                          | Share of search queries after which at least one hit was clicked.                                                                                            |
| Refined searches                    | Share of visits with a search in which more than one search query was made. Lower is better.                                                                 |
| Purchase rate of search             | Orders with search divided by visits in which a search result was clicked. In the tile in the Shopware dashboard it is called "Conversion".                  |
| Purchase rate per search term       | Orders with this search term divided by search queries with this term.                                                                                       |
| Click rate per product              | Clicks on the product divided by its impressions in the search. Without measured impressions there is no value.                                              |
| Purchase rate per product           | Orders in which the product was bought via the search, divided by the clicks on the product in the search.                                                   |
| Revenue via search                  | Sum of order items whose product was found via the search. Paid or open, never cancelled.                                                                    |
| Orders with search                  | Number of distinct orders with at least one item via the search.                                                                                             |
| Share of search in revenue          | Revenue via search divided by the sum of all order items.                                                                                                    |
| Share of orders with search         | Orders with search divided by all orders.                                                                                                                    |
| Ø order value with / without search | Average order value of orders with or without search.                                                                                                        |
| Shop revenue                        | Sum of order values of all distinct orders in the main currency, paid or open, never cancelled. Other currencies are named separately.                       |
| Orders, open and cancelled orders   | Number of distinct orders. Open ones are not yet paid and count toward revenue. Cancelled ones never count toward revenue. Orders reported twice count once. |
| Added to cart                       | Cart items that were added via the search or a recommendation.                                                                                               |
| Ø per day                           | Sum of the last 7 completed days divided by 7. Today does not count.                                                                                         |
| Visit (session)                     | All page views of a person until they do nothing in the shop for 30 minutes.                                                                                 |

## How counting works

* **Revenue via search:** A purchase counts per bought product (or its variant) if that product was clicked in the search or added to the cart from there. Up to 72 hours may lie between the click and the order, in the same browser.
* **Visit:** A visit ends after 30 minutes without activity. Search, clicks, cart and order belong to the same visit even after login.
* **Crawlers:** Search engine and AI crawlers do not count.
* **Time zone:** Days begin at midnight in the time zone you set in the plugin configuration, in the card "Admin dashboard", under "Time zone for statistics". Without a valid entry, "Europe/Berlin" applies, i.e. German time.
* **Order status:** Which orders count as paid or cancelled, you define in the card "Order tracking". Cancelled orders never count toward revenue.
* **Very many orders:** With very many orders in the period, only the latest 10,000 are evaluated. A note then says revenue values may be too low.

## CSV export

Seven tables have a CSV export button:

* "All search terms"
* "Top search terms without results"
* "Search terms with low click rate"
* "Top products"
* "Flop products" (only if impressions are recorded)
* "Revenue by search term"
* "Revenue via search by product"

The export applies to the selected period, including a free "From" and "To". The file is separated by semicolons, is UTF-8 with a marker for Excel and uses a decimal comma. The file name contains table and period. The download link is valid for only 2 minutes, so start the download right away.

## Lost opportunities

In the table "Top search terms without results", the link "Edit lost opportunities" leads straight to the action list of the search term rules. From the search term page, "Open rules in the plugin" leads there. Both switch in the plugin to **Products** → tab **Rules**. More on the page [Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md).

## Tile in the Shopware dashboard

<figure><img src="https://923488348-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FebcjSiStaIxyVJ83vjsL%2Fuploads%2Fgit-blob-198a0196b70838d28a4eb2af29c188ee937cb0bc%2Fsuche-intelligent-und-ki-optimiert-dashboard-kachel.png?alt=media" alt="Tile InsightSearch Search on the home page of the Shopware admin with metrics, trend, top search terms and status (sample data)"><figcaption></figcaption></figure>

The home page of the Shopware admin shows the tile "InsightSearch Search". It is only visible to admin users with the permission to view orders, and only if "Show tile in admin dashboard" is on (default on).

### Metrics

Each metric shows the change against the previous period of equal length, percentages in percentage points ("pp"). By default four metrics are active: "Revenue via search", "Share of shop revenue", "Search queries" and "Searches without results". For "Searches without results", a decrease counts as an improvement. Each metric has a tooltip with an explanation.

Additionally selectable are "Orders via search", "Ø order value with / without search", "Click rate", "Conversion rate of search", "Clicks on search results" and "Sessions with search". You make the selection in the plugin configuration in the field "Metrics in the tile", the order follows your selection.

### Further sections

* "Searches and clicks per day" (trend, not shown for "Today")
* "Top search terms" with searches, click rate and revenue
* "Revenue by search term"
* "Searches without results" with the link "Maintain synonyms →"
* "Status" with quota ("x of y" with a forecast for the end of the month, or unlimited), "Search active" and "Order tracking", per channel when there are several sales channels
* a message banner for notes on disruptions or maintenance

You can switch off each section individually in the card "Admin dashboard" of the plugin configuration.

### Period and cache

You switch the period directly on the tile: "Today", "7 days", "30 days" or "90 days". Which period applies on opening is set by "Default period" (default "Last 30 days"). The tile's data is cached for 10 minutes. Via "To statistics →" you reach the detailed statistics.

### Tile settings

| Setting                        | Effect                                                    | Default                                                                    |
| ------------------------------ | --------------------------------------------------------- | -------------------------------------------------------------------------- |
| "Show tile in admin dashboard" | Tile on or off.                                           | on                                                                         |
| "Position"                     | "Above the Shopware tiles" or "Below the Shopware tiles". | below                                                                      |
| "Default period"               | "Today", "Last 7 days", "Last 30 days" or "Last 90 days". | Last 30 days                                                               |
| "Metrics in the tile"          | Multiple selection of metrics.                            | four metrics (see above)                                                   |
| "Time zone for statistics"     | For example Europe/Berlin.                                | empty, then the time zone of the first admin user, otherwise Europe/Berlin |

Further switches show or hide trend, top search terms, revenue by search term, searches without results, status and current messages.

### If the tile shows nothing

* If the plugin is not yet connected to InsightSearch, a note with the link "To plugin configuration →" appears. Enter the account and installation secret.
* On an error, "The metrics could not be loaded right now." appears with the button "Reload".
* If there were no searches in the period yet, it says "No searches were recorded in this period."
* If individual values are missing, the tile points this out.

## Read more

{% content-ref url="/pages/DH2IbZLins4ioA38ZbKv" %}
[Search term rules](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/search-term-rules.md)
{% endcontent-ref %}

{% content-ref url="/pages/jaQ6nXm2Ug0rov8AO38O" %}
[Synonyms](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/synonyms.md)
{% endcontent-ref %}

{% content-ref url="/pages/v20EC98NJrD47BUleH4w" %}
[Plugin settings](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/plugin-settings.md)
{% endcontent-ref %}

{% content-ref url="/pages/UbPgPTIvpH80zt0F5BMB" %}
[Permissions](https://docs.codegiganten.de/plugin-documentation/en/apps/search-intelligent-and-ai-optimized/permissions.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/search-intelligent-and-ai-optimized/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.
