> 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/apps/suche-intelligent-und-ki-optimiert/suchergebnisseite.md).

# Suchergebnisseite

Die Suchergebnisseite von Shopware mit den Treffern und der Reihenfolge von InsightSearch beliefern: was sich ändert, Grenzen und Einschränkungen.

Wenn ein Kunde im Shop Enter drückt, öffnet Shopware seine eigene Suchergebnisseite. Mit der Einstellung „Shopware-Suchergebnisseite durch InsightSearch beliefern“ bleibt diese Seite, wie sie ist, die Treffer und ihre Reihenfolge kommen aber von InsightSearch. So sehen Kunden im Such-Fenster und auf der Ergebnisseite dieselbe Qualität, ohne dass Sie Ihr Theme anfassen müssen.

Die Einstellung finden Sie in der Plugin-Konfiguration auf der Karte „Sucheinstellungen“ im Bereich „Suchergebnisseite und Varianten“. Sie ist standardmäßig aus.

## Was bei Shopware bleibt

* die Seite selbst mit Ihrem Theme und der Überschrift „Suchergebnisse für …“
* die Produktkacheln des Themes mit Merkzettel- und Kaufen-Knöpfen
* die Filterleiste
* die Sortier-Auswahl
* das Blättern
* SEO-Angaben und Hinweistexte

## Was sich ändert

* **Treffer und Reihenfolge** kommen von InsightSearch, mit Tippfehler-Toleranz, KI-Treffern, Regeln wie Anpinnen und Ausblenden, Personalisierung und den Rettungsstufen bei null Treffern. Die Standard-Sortierung „Beste Ergebnisse“ folgt vollständig dem Ranking von InsightSearch.
* **Enter** in den Suchfeldern öffnet diese Seite. Wer im Such-Fenster tippt, bekommt weiter die Treffer im Fenster.
* **Filter** grenzen nur innerhalb der Treffer von InsightSearch ein, nicht über den ganzen Katalog. Zähler und Optionen der Filterleiste beziehen sich auf diese Treffermenge.
* **Sortierung und Blättern** (Preis, Name und so weiter) arbeiten innerhalb dieser Treffermenge. Die Seitengröße von Shopware („Produkte pro Seite“) dürfen Sie frei wählen.
* **Varianten:** Mit „Varianten desselben Produkts zu einem Treffer zusammenfassen“ (Standard: an) weist die Seite dieselbe Trefferzahl aus wie Shopwares eigene Produktliste. Die Zähler der Filter zählen weiterhin Varianten.
* **Hinweiszeile** unter der Überschrift, wenn gelockert oder korrigiert gesucht wurde („Keine genauen Treffer für …“ oder „Ergebnisse für …“ mit Link „Stattdessen nach … suchen“).
* **Produktboxen** unter der Liste: „Das könnte auch passen“ (verwandte Treffer) und „Das könnte Sie interessieren“ (Ersatzprodukte), je bis zu 12 Produkte in den Standardkacheln Ihres Themes.

Die Stufen bei null Treffern sind dieselben wie im Such-Fenster. Sie stehen auf der Seite [Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md).

## Grenzen

| Einstellung                                                    | Wirkung                                                                                                                                                                                                                         | Standard |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| „Maximale Trefferanzahl der Suchergebnisseite“                 | Obergrenze für die von InsightSearch gelieferten Treffer. Erlaubt sind 1 bis 10000, denn Shopware kann technisch nur bis 10000 Einträge blättern. Größere Werte bedeuten mehr Anfragen bei der ersten Suche nach einem Begriff. | 2000     |
| „Varianten desselben Produkts zu einem Treffer zusammenfassen“ | Fasst Varianten zu einer Kachel zusammen, wie Shopwares Liste.                                                                                                                                                                  | an       |

Dazu kommen feste Grenzen, die Sie nicht einstellen:

* **Zeitbudget:** Der Seitenaufbau wartet höchstens rund 3 Sekunden auf die Trefferliste. Wird die Zeit überschritten, nutzt die Seite die bis dahin geholte Liste (gekürzt). Ist noch nichts da, übernimmt Shopware.
* **Zwischenspeicher:** Die Trefferliste je Begriff, Verkaufskanal und Sprache wird 120 Sekunden zwischengespeichert. Das beschleunigt wiederholte Suchen. Bei aktiver Personalisierung wird nicht gemeinsam zwischengespeichert, damit nicht alle Besucher die Reihenfolge des Ersten bekommen.
* **Null Treffer heißt null Treffer:** Es gibt keinen Rückfall auf Shopwares Suche. Sonst würden sich Fenster und Seite widersprechen.
* **Rückfall auf Shopware** gibt es nur bei einem Fehler, bei einer Zeitüberschreitung, bei einer Sprache ohne Zuordnung und wenn der Schalter aus ist. Dann zeigt Shopware seine eigenen Treffer.

## Einschränkungen

{% hint style="warning" %}
Die Funktion ist nicht kombinierbar mit einer aktiven Elasticsearch- oder OpenSearch-Anbindung von Shopware für Produkte. Ist diese aktiv, übernimmt das Plugin die Seite nicht, statt eine falsche Seite zu liefern.
{% endhint %}

* Plugins von Drittanbietern, die Sortierung oder Produktliste umstellen, können die Reihenfolge verändern.
* Die Seite wird für alle Besucher zwischengespeichert. Deshalb enthalten die Empfehlungen und Ersatzprodukte dort keine personalisierte Auswahl.
* Das Ersatzbild für Produkte ohne Bild gilt hier nicht. Shopware zeigt die eigene Darstellung.

## Einblendungs-Tracking

Damit die [Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md) stimmt, meldet die Seite, welche Treffer ein Besucher tatsächlich gesehen hat:

* Eine Kachel gilt als eingeblendet, wenn mindestens die Hälfte im Bild ist, und zwar einmal je Kachel.
* Die Meldungen werden gebündelt gesendet, nach etwa einer Sekunde, bei 50 Stück und beim Verlassen der Seite.
* Nach einem Filterwechsel oder dem Blättern wird neu erfasst.
* Klicks auf den Treffer (auch mit der mittleren Maustaste), „In den Warenkorb“ und der Merkzettel werden getrennt gezählt.
* Stimmt die Zahl der angezeigten Kacheln nicht mit der gelieferten Trefferliste überein, wird gar nicht erfasst.
* Das Tracking nutzt die Besucher-Kennung. Mit Einwilligung im Cookie-Banner („Komfortfunktionen“) ist das die gemeinsame Kennung, sonst eine Kennung nur für den Browser-Tab.

## Suchmaschinen-Crawler

Auch Crawler bekommen beim Abruf der Seite die Treffer von InsightSearch. Für Crawler werden keine Ersatzprodukte aus Cross-Selling Pro abgefragt, damit sie das Kontingent nicht verbrauchen. Ereignisse von Crawlern und Skripten werden nicht gezählt, sie gelten nicht als Besucher.

## Weiterleitung und Banner

Regeln aus den [Suchbegriff-Regeln](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md) wirken auf der Suchergebnisseite auch dann, wenn die Seite nicht von InsightSearch beliefert wird:

* **Weiterleitung:** Sie greift, bevor die Seite angezeigt wird, also auch bei Lesezeichen und bei Shopwares eigenem Suchformular. Erlaubte Ziele sind relative Pfade, die Domains des Verkaufskanals und die unter „Freigegebene externe Domains für Suchbegriff-Weiterleitungen“ eingetragenen Domains.
* **Banner:** Eine Erlebniswelt steht über den Treffern.

## So schalten Sie die Funktion ein

1. Öffnen Sie die Plugin-Konfiguration und die Karte „Sucheinstellungen“.
2. Schalten Sie „Shopware-Suchergebnisseite durch InsightSearch beliefern“ ein. Damit ist auch „Weiterleitung zur Shopware-Suchergebnisseite per Enter erlauben“ gemeint, Sie müssen es nicht zusätzlich einschalten.
3. Entscheiden Sie über „Varianten desselben Produkts zu einem Treffer zusammenfassen“ und die „Maximale Trefferanzahl der Suchergebnisseite“.
4. Speichern Sie, suchen Sie im Shop und drücken Sie Enter.

## Weiterlesen

{% content-ref url="/pages/OXAoj5NTuVjQy9UJJi7n" %}
[Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md)
{% endcontent-ref %}

{% content-ref url="/pages/EFhYbJhqfikKs7df9Kz1" %}
[Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)
{% endcontent-ref %}

{% content-ref url="/pages/vwo6GMbWlwFTx1rLm8ey" %}
[Suchbegriff-Regeln](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md)
{% endcontent-ref %}

{% content-ref url="/pages/Ldiml6Xb2DKBYoCOFNLC" %}
[Plugin Einstellungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/plugin-einstellungen.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/apps/suche-intelligent-und-ki-optimiert/suchergebnisseite.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.
