> 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/erlebniswelten-und-empfehlungen.md).

# Erlebniswelten und Empfehlungen

Was das Plugin in der Erlebniswelten-Verwaltung mitbringt, welche Seiten Sie für die Suche gestalten können und wie die Suche mit Cross-Selling Pro zusammenarbeitet.

Diese Seite klärt zwei Fragen: Was bringt das Such-Plugin in die Erlebniswelten-Verwaltung von Shopware mit, und wie arbeitet die Suche mit dem Plugin „Cross-Selling Pro - KI Cross Selling“ zusammen. Sie hilft Ihnen, wenn Sie Seiten für die Suche gestalten oder Empfehlungen im Such-Fenster einsetzen wollen.

## Was das Plugin in der Erlebniswelten-Verwaltung mitbringt

Das Such-Plugin bringt genau **einen Block mit einem Element** mit, und beide sind veraltet.

| Was                               | Bezeichnung im Admin                    |
| --------------------------------- | --------------------------------------- |
| Block (Blockkategorie „Commerce“) | „AI Basis Empfehlungsslider (veraltet)“ |
| Element                           | „KI-Produktempfehlungen (veraltet)“     |

Im Element steht ein Hinweis: Der Slider wird nicht mehr weiterentwickelt. Für neue Seiten verwenden Sie bitte die Empfehlungs-Elemente von „Cross-Selling Pro - KI Cross Selling“. **Bestehende Seiten mit dem alten Block funktionieren weiter**, Sie müssen nichts umbauen.

{% hint style="info" %}
Für neue Seiten empfehlen wir Cross-Selling Pro. Es bringt die Blöcke der Blockkategorie „AI Cross-Selling“ mit, zum Beispiel Karten, Liste, Raster, Mosaik und Spotlight. Die Einrichtung dort beschreibt die Dokumentation von Cross-Selling Pro.
{% endhint %}

### Die Felder des veralteten Sliders

Der Slider zeigt ergänzende Produkte zum aktuellen Artikel (Empfehlungstyp „Passt gut zusammen“, nicht wählbar). Er lädt seine Produkte nach dem Seitenaufbau und zeigt „Empfehlungen werden geladen...“, bei keinem Ergebnis „Keine Empfehlungen verfügbar.“. Er braucht den Suchindex des Verkaufskanals und der Sprache, aber nicht das Plugin Cross-Selling Pro.

| Feld                      | Wirkung                                                                                                             | Standard             |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- | -------------------- |
| „Titel“                   | Überschrift über dem Slider.                                                                                        | „Passt gut zusammen“ |
| „Untertitel“              | Optionaler Zusatztext.                                                                                              | leer                 |
| „Limit“                   | Anzahl der Produkte, 1 bis 50.                                                                                      | 6                    |
| „Modus“                   | „Gemischt“, „Nur gleiche Marke“ oder „Nur gleiche Kategorie“.                                                       | Gemischt             |
| „Nur verfügbare Produkte“ | Blendet nicht lieferbare Produkte aus.                                                                              | aus                  |
| „Produktquelle“           | „Automatisch (Produktdetailseite)“ nutzt das Produkt der aktuellen Seite, „Festes Produkt“ ein von Ihnen gewähltes. | Automatisch          |
| „Referenzprodukt“         | Das feste Produkt. Leer heißt: Produkt der aktuellen Detailseite.                                                   | leer                 |

Unter „Experten-Einstellungen anzeigen“ finden Sie weitere Schalter und Zahlenwerte:

* Schalter: „Gleiche Marke ausschließen“, „Kategorie bevorzugen“, „Artikelgruppe ausschließen“ (blendet Artikel derselben Variantengruppe aus) und „Gleichen Titel verbieten“ (Standard: an).
* Zahlenwerte: „Marken-Abwertung“ (0.25), „Kategoriebonus“ (0.1), „Interne Kategorie-Abwertung“ (0), „Marken-Verstärkung“, „Kategorie-Verstärkung“ und „Kategoriepfad-Verstärkung“ (je 1), „Min. Trefferquote“ (0 bis 3), „Marken-Gewichtung“, „Kategorie-Gewichtung“, „Preis-Gewichtung“, „Attribut-Gewichtung“ und „Tag-Gewichtung“ (je 0.25) sowie „Max. Preisabweichung“ (1 bedeutet bis zu 100 %).

Zu jedem Wert gibt es im Admin einen Hilfetext. Für den Alltag genügen meist die Standardwerte.

## Was kein Erlebniswelten-Element ist

Einige Teile der Suche wirken wie Bausteine, sind aber keine Elemente, die Sie in eine Erlebniswelt ziehen:

* **Suchfeld und Such-Fenster:** Teil der Storefront-Suche. Sie schalten sie in der Plugin-Konfiguration ein („Suche aktivieren“, „Aktivierungsmodus der Suche“).
* **Suchergebnisseite und Listing-Filter:** Die Suche beliefert die Suchergebnisseite von Shopware („Shopware-Suchergebnisseite durch InsightSearch beliefern“). Es gibt dafür kein eigenes Element.
* **Regel-Banner:** Eine Erlebniswelt, die Sie einer Suchbegriff-Regel zuordnen, erscheint als Banner über den Treffern. Sie wählen die Erlebniswelt in der Regel selbst, nicht in einem Block. Mehr dazu auf der Seite [Suchbegriff-Regeln](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md).
* **Zuordnung von Käufen:** Dahinter steckt keine sichtbare Stelle, sondern eine unsichtbare Markierung, mit der ein Kauf der Suche zugerechnet wird (siehe unten).

## CMS-Seiten für die Suche

Für zwei Situationen im Such-Fenster können Sie eine eigene Erlebniswelt anzeigen lassen. Sie wählen sie im Shopware-Admin unter Erweiterungen → Meine Erweiterungen → Plugin-Konfiguration in der Karte „Sucheinstellungen“. Beide Felder lassen sich je Verkaufskanal setzen.

### CMS-Seite für leeren Suchzustand

„CMS-Seite für leeren Suchzustand“ erscheint, wenn das Such-Fenster ohne Suchbegriff geöffnet wird. Ohne Auswahl steht dort der Standard-Platzhaltertext. Darunter erscheinen, falls vorhanden, die Suchvorschläge und beliebten Suchen. Ist eine Seite gewählt, öffnet sich das Such-Fenster beim Klick ins leere Feld auch dann, wenn es keine Vorschläge gibt. Diese Funktion ist frei verfügbar.

Gut geeignet sind Bild- und Textbanner, Einstiege in Kategorien, Aktionen oder ein Bestseller-Slider. Halten Sie die Seite kompakt: Auf dem Handy füllt das Such-Fenster den Bildschirm.

### CMS-Seite bei Suchanfragen ohne Ergebnisse

„CMS-Seite bei Suchanfragen ohne Ergebnisse“ erscheint im Such-Fenster, wenn eine Suche nichts findet. Ohne Auswahl steht die Standardmeldung.

{% hint style="warning" %}
Dieses Auswahlfeld gibt es nur mit dem gekauften Zusatz **„CMS bei keinen Treffern“** (Kauf in Shopware). Ohne den Zusatz zeigt die Plugin-Konfiguration an dieser Stelle einen Hinweis mit dem Knopf „Details“. Ist der Zusatz aktiv, steht dort „Die Funktion ist für deinen Shop aktiv.“
{% endhint %}

Die Seite erscheint nur im Such-Fenster, nicht auf der Suchergebnisseite. Gut geeignet sind ein Hilfetext, Links zu Kategorien, ein Slider mit Bestsellern oder Empfehlungen und Kontaktdaten.

Mit der Einstellung „Ersatzprodukte zusätzlich zur CMS-Seite bei Suchen ohne Ergebnisse“ (Standard: aus) bestimmen Sie, ob unter der Seite noch Ersatzprodukte folgen. Lassen Sie sie aus, wenn Ihre Seite selbst Produkte zeigt, sonst erscheinen doppelte Produktblöcke. Der Hinweis „Lass dich beraten“ des [Shopping-Assistenten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.md) erscheint auch neben der CMS-Seite.

{% hint style="info" %}
Auf diesen Seiten gibt es kein „aktuelles Produkt“. Ein Empfehlungs-Slider mit „Produktquelle: Automatisch (Produktdetailseite)“ findet dort kein Produkt. Wählen Sie ein festes Produkt oder einen Empfehlungstyp ohne Produktbezug. Wir haben diesen Fall nicht für alle Elemente getestet.
{% endhint %}

Auf dem Handy stehen die Banner und Seiten in den Designs „Treffer zuerst“ und „Wie eine App“ unter den Produkten.

## Zusammenspiel mit Cross-Selling Pro

Ist „Cross-Selling Pro - KI Cross Selling“ im selben Shop installiert, kann die Suche zwei Dinge daraus nutzen: ergänzende Produkte unter den Treffern und bessere Ersatzprodukte bei Suchen ohne Treffer.

### Voraussetzungen

Die Funktionen sind aktiv („gekoppelt“), wenn

1. Cross-Selling Pro im selben Shop installiert und aktiv ist,
2. es mit Ihrem InsightSearch-Konto verbunden ist und
3. dem Verkaufskanal und der Sprache ein Empfehlungs-Index zugeordnet ist.

Fehlt eine Voraussetzung, sind die beiden Schalter ausgegraut. Der Hinweis lautet dann „Benötigt Cross-Selling Pro - KI Cross Selling. Installiere und verbinde das Plugin im selben Shop, dann lässt sich die Funktion einschalten.“ Ein gespeicherter Wert bleibt dabei erhalten. Beide Schalter gelten ohne gespeicherten Wert als **an**.

### „Passt dazu“ im Such-Fenster

Mit dem Schalter „„Passt dazu“ im Such-Overlay“ (Karte „Sucheinstellungen“) zeigt das Such-Fenster unter den Treffern bis zu vier passende Produkte zum ersten Treffer. Die Überschrift lautet „Passt zu {Name des ersten Treffers}“. Bereits sichtbare Treffer werden nicht noch einmal gezeigt. Gibt es kein Ergebnis oder dauert es zu lange (länger als etwa 1,5 Sekunden), erscheint nichts.

### Ersatzprodukte bei Suchen ohne Treffer

Mit dem Schalter „Ersatzprodukte aus Cross-Selling Pro - KI Cross Selling“ (Karte „Keine Treffer & verwandte Treffer“) kommen die Ersatzprodukte bei einer Suche ohne Treffer aus der Empfehlungs-KI und passen zum Suchbegriff, statt nur beliebt zu sein.

* Sie gelten im Such-Fenster **und** auf der Suchergebnisseite. Die Überschrift lautet „Das könnte Sie interessieren“.
* Die Anzahl stellen Sie mit „Anzahl Ersatzprodukte“ ein (4 bis 12, Standard 8).
* Im Such-Fenster fragt die Suche die Empfehlungs-KI nur, wenn sie selbst nichts retten konnte. Eine gelockerte oder korrigierte Suche hat Vorrang.
* Voraussetzung ist ein Paket von Cross-Selling Pro ab **Starter**. Im kostenlosen Paket bleibt es bei den normalen Ersatzprodukten der Suche.
* Auf der Suchergebnisseite sind die Produkte nicht personalisiert. Für Suchmaschinen-Crawler werden sie nicht geliefert.

### Warenkorb-Knopf

Im Such-Fenster folgen die Karten der Einstellung „In-den-Warenkorb-Button im Such-Overlay“ (Standard: aus). Das gilt gleich für Treffer, „Passt dazu“ und die Ersatzprodukte aus Cross-Selling Pro. Einfache Artikel kommen direkt in den Warenkorb, bei Artikeln mit Varianten steht „Auswählen“, bei ausverkauften Artikeln gibt es keinen Knopf. Im Layout „Nativ“ hat die Einstellung keine Wirkung. Auf der Suchergebnisseite zeigen die Ersatzprodukte die normalen Produktboxen von Shopware.

### Kontingent

Jeder Abruf der Empfehlungs-KI zählt auf das Empfehlungs-Kontingent von Cross-Selling Pro, nämlich „Passt dazu“ (je Suche mit Treffern) und die Ersatzprodukte bei Suchen ohne Treffer. Automatische Zugriffe wie Suchmaschinen-Crawler fragen nicht ab. Ist das Kontingent erreicht, erscheint in diesen Bereichen einfach nichts, das Such-Fenster bleibt sonst unverändert.

### Personalisierung

Beide Plugins verwenden dieselbe Besucher-Erkennung. Im Cookie-Banner steht dafür ein Eintrag „Wiedererkennung für Suche und Empfehlungen“, eine Einwilligung deckt beide Plugins ab. Mit „Suchergebnisse personalisieren“ (Standard: aus) rücken Marken und Kategorien, die ein Besucher zuletzt angesehen hat, leicht nach oben. Das gilt nur mit Einwilligung oder bei angemeldeten Kunden. Die Empfehlungen im Such-Fenster („Passt dazu“, Ersatzprodukte) sind nicht auf den einzelnen Kunden zugeschnitten, weil die Seiten zwischengespeichert werden.

### Ersatzbild

Das „Ersatzbild für Produkte ohne Bild“ aus den Sucheinstellungen erscheint im Such-Fenster, bei Ersatzprodukten und im Shopping-Assistenten. Cross-Selling Pro nutzt es ebenfalls, wenn dort kein eigenes Bild gepflegt ist. Ein dort gepflegtes Bild hat Vorrang, sonst gilt das Bild der Suche, sonst ein grauer Platzhalter. Suchergebnisseite und Kategorieseiten zeigen weiter die Darstellung von Shopware.

### Zuordnung von Umsatz

Ein Kauf zählt als „Umsatz über die Suche“ je gekauftem Produkt (oder dessen Variante), wenn dieses Produkt in der Suche angeklickt oder von dort in den Warenkorb gelegt wurde. Zwischen Klick und Bestellung dürfen bis zu 72 Stunden liegen, im selben Browser. Trägt eine Warenkorbposition die Markierung der Suche **und** die einer Empfehlung, zählt sie als Empfehlungs-Umsatz und nicht als Such-Umsatz.

### Wenn Cross-Selling Pro fehlt

Ohne Cross-Selling Pro ändert sich im Shop nichts. Es erscheint kein „Passt zu …“. Bei Suchen ohne Treffer zeigt die Suche ihre eigenen Ersatzprodukte (beliebte Produkte), solange „Ersatzprodukte zeigen, wenn nichts gefunden wird“ eingeschaltet ist (Standard: an, 4 bis 12 Produkte, Standard 8). Der alte Slider funktioniert weiter.

## Weiterlesen

{% 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/Yh2Xre5VlEtZ825C1NVO" %}
[Weitere Konfigurationskarten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/weitere-konfiguration.md)
{% endcontent-ref %}

{% content-ref url="/pages/ygPmevhI5XOJUeRPfFTy" %}
[Shopping-Assistent (Beta)](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/shopping-assistent.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/erlebniswelten-und-empfehlungen.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.
