> 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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/so-entstehen-empfehlungen.md).

# So entstehen die Empfehlungen

So wählt InsightSearch die Produkte für einen Empfehlungsblock aus: Filter, Kandidaten, Gewichtung, Vielfalt und KI-Anteile Schritt für Schritt erklärt.

Diese Seite erklärt, was zwischen dem Aufruf einer Seite im Shop und den angezeigten Produkten passiert. Wenn Sie wissen, in welcher Reihenfolge Filter, Gewichtung und Booster wirken, können Sie Vorlagen gezielt einstellen und verstehen, warum ein Block einmal mehr und einmal weniger Produkte zeigt.

Sie brauchen diese Seite nicht für den Start. Sie hilft, sobald Sie Vorlagen anpassen oder ein Ergebnis nachvollziehen möchten.

## Der Weg in Kürze

Für jeden Empfehlungsblock auf einer Seite fragt der Browser Ihres Besuchers einmal bei InsightSearch an. Mit der Anfrage gehen die Einstellungen Ihrer Vorlage mit, also Empfehlungstyp, Filter, Gewichtung, Booster und Anzahl. InsightSearch berechnet die Liste und schickt sie zurück. Danach prüft das Plugin im Shop, ob der Besucher die Produkte sehen darf, und ergänzt feste Produkte oder Ersatzprodukte.

Es gibt zwei Arten von Empfehlungen, die unterschiedlich berechnet werden:

| Art                 | Empfehlungstypen                                                                                                | So wird gerechnet                                                                                       |
| ------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Zu einem Produkt    | „Ähnliche Produkte (Alternativen)“, auch im Warenkorb und im Offcanvas                                          | Volle Berechnung mit Filtern, Gewichtung, Boostern und Vielfalt                                         |
| Aus Verhaltensdaten | Bestseller, Trends, Zuletzt angesehen, Personalisiert, Passt gut dazu, Weitermachen, Erneut kaufen, Wunschliste | Eine Rangliste aus Bestellungen oder Besucherverhalten, danach nur Ausschlüsse, Regeln und Lagerprüfung |

Was die einzelnen Typen brauchen, steht unter [Empfehlungs-Typen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/empfehlungs-typen.md).

## Empfehlungen zu einem Produkt, Schritt für Schritt

### 1. Einstellungen zusammensetzen

InsightSearch übernimmt die Werte Ihrer Vorlage. Felder, die Sie leer lassen, ersetzt InsightSearch durch eigene Standardwerte. Im Vorlagenformular sehen Sie diese Standards bei den Reglern mit der Plakette „Standard“. Danach wirken die KI-Einstellungen aus dem Bereich **Produkte & Daten → KI** (siehe unten).

### 2. Ausgangsprodukt laden

Das Produkt, zu dem empfohlen wird, ist das Ausgangsprodukt (in der Oberfläche auch „Referenzprodukt“). Auf der Produktseite ist es das angezeigte Produkt. Im Warenkorb bestimmt das Feld „Warenkorb: Referenzprodukt“, welche Position zählt: „Höchster Positionswert (Preis × Menge)“, „Höchster Einzelpreis“, „Zuletzt hinzugefügt“ oder „Mischung aus mehreren Positionen“. Bei der Mischung rechnet InsightSearch für bis zu fünf Positionen getrennt und fügt die Listen abwechselnd zusammen.

Findet InsightSearch das Ausgangsprodukt nicht in Ihren Produktdaten (zum Beispiel ein ganz neues Produkt vor der nächsten Synchronisation), kommt keine Liste zurück. Dann greift der Fallback, den Sie in der Vorlage eingestellt haben.

### 3. Harte Filter

Filter entscheiden, welche Produkte überhaupt in Frage kommen. Was ein Filter ausschließt, holt keine Gewichtung zurück. InsightSearch wendet sie in dieser Reihenfolge an:

1. Das Ausgangsprodukt selbst fällt immer heraus.
2. Varianten des Ausgangsprodukts fallen heraus.
3. „Nur lieferbar“, wenn Sie diesen Baustein im Regel-Baukasten gesetzt haben. Maßgeblich ist die Lieferbarkeit aus Shopware.
4. Der „Modus“: „Nur gleiche Marke“ oder „Nur gleiche Kategorie“. Bei der Kategorie zählt die Hauptkategorie des Produkts. Hat das Ausgangsprodukt keine Marke oder Kategorie, entfällt der Modus.
5. Ihre Regeln aus dem Regel-Baukasten, auch mit Bezug auf das Ausgangsprodukt, etwa „Gleiche Farbe wie Referenz“ oder „Ähnliche Preislage (±20 %)“.
6. Produkte, die schon im Warenkorb liegen, samt ihrer Varianten (im Warenkorb und Offcanvas immer, sonst mit „Warenkorb-Produkte ausschließen“).

Mehr zu Regeln unter [Filter und Regel-Baukasten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/filter-und-regeln.md).

### 4. Kandidaten sammeln

InsightSearch sucht passende Produkte aus bis zu vier Quellen gleichzeitig. Für jede Quelle gelten dieselben Filter.

* **KI-Ähnlichkeit:** Produkte, die inhaltlich nah am Ausgangsprodukt sind, auch bei anderem Wortlaut oder anderer Kategorie.
* **Produktdaten:** gleiche Marke, gleiche oder verwandte Kategorien.
* **Kaufverhalten:** Produkte, die Besucher zusammen mit dem Ausgangsprodukt in den Warenkorb gelegt oder angesehen haben.
* **Nächtlich berechnete Nachbarn:** ähnliche Produkte, die InsightSearch jede Nacht vorab ermittelt.

Fällt eine Quelle aus, liefern die anderen weiter.

### 5. Endkontrolle

Jeder Kandidat wird noch einmal geprüft. Doppelte Produkte fallen heraus. Von mehreren Varianten desselben Produkts bleibt nur eine. Mit „Gleichen Titel verbieten“ (Standard an) erscheinen Produkte mit gleichem Namen nur einmal.

### 6. Bewerten (Gewichtung)

Jetzt bekommt jeder Kandidat eine Punktzahl für die Ähnlichkeit. Sie setzt sich aus neun Anteilen zusammen, die Sie im Abschnitt „3. Gewichtung“ der Vorlage einstellen: Kategorie, Marke, Inhaltliche Ähnlichkeit (KI), Preis, Kundenverhalten, Beliebtheit, Kontext, Attribute und Tags. Jedes Gewicht zählt als Anteil an der Summe aller Gewichte.

Zwei Dinge sind wichtig:

* **Fehlende Daten bestrafen nicht.** Hat ein Produkt noch keine KI-Daten, kein Kaufverhalten oder keine Beliebtheit, wird dieser Anteil für das Produkt einfach weggelassen. Die übrigen Anteile zählen dann stärker.
* **Bewertung im Vergleich.** KI-Ähnlichkeit und Preisnähe werden relativ zu den übrigen Kandidaten bewertet. Der beste Kandidat bekommt den vollen Wert.

Danach kommen die **Booster** dazu. Booster sind Zusatzpunkte für Produkte, die eine Bedingung erfüllen, zum Beispiel „Lieferbare Produkte bevorzugen“ oder die Verstärkung für gleiche Marke oder Kategorie im Expertenmodus. Die Einstellung „Mindest-Ähnlichkeitsscore“ prüft die Ähnlichkeit **ohne** Booster. Ein Booster hebt also kein unpassendes Produkt über diese Schwelle.

Details stehen unter [Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md).

### 7. Vielfalt

Im Modus „Gemischt“ achtet InsightSearch darauf, dass nicht nur Produkte einer Marke oder einer Kategorie nebeneinander stehen. Jeder weitere Platz geht an das Produkt, das gut passt und sich von den schon gewählten unterscheidet. Die Marke des Ausgangsprodukts wird dabei zusätzlich etwas zurückgestellt. Wie stark das wirkt, steuert „Vielfalt“ im Expertenmodus. In den Modi „Nur gleiche Marke“ und „Nur gleiche Kategorie“ entfällt dieser Schritt.

### 8. Lockern statt leer

Reichen die Treffer nicht für die gewünschte Anzahl, lockert InsightSearch vorsichtig:

* Im Modus „Nur gleiche Kategorie“ wird auf die übergeordnete Kategorie erweitert. Die genaueren Treffer bleiben vorne.
* Lager, Regeln und Ausschlüsse bleiben in jeder Stufe bestehen. InsightSearch füllt nie ungefiltert auf.

Reicht es danach immer noch nicht, kommen weniger Produkte zurück. Dann greift der Fallback der Vorlage, wenn Sie einen eingestellt haben („Fallback-Typ“ und „Fallback-Schwelle (≤)“ im Abschnitt „5. Darstellung“).

### 9. Sichtbarkeit im Shop

Ist in der Plugin-Konfiguration „Nur Produkte zeigen, die der Kunde sehen darf“ aktiv (Standard an), fordert das Plugin etwas mehr Produkte an als nötig. Danach blendet es im Shop alles aus, was für den Kunden nicht sichtbar ist, etwa wegen Kundengruppe oder Verkaufskanal. So bleiben genug Produkte übrig. Feste Produkte stellt das Plugin an den Anfang. Sie zählen auf die Anzahl.

## Empfehlungen aus Verhaltensdaten

Bei Bestseller, Trends, Zuletzt angesehen, Personalisiert, Passt gut dazu, Weitermachen, Erneut kaufen und Wunschliste liefert eine Datenquelle die Reihenfolge, zum Beispiel die Bestellungen der letzten 30 Tage. Danach passiert nur noch Folgendes:

1. Ausschlüsse: das Ausgangsprodukt (falls vorhanden) und Produkte im Warenkorb samt Varianten.
2. Regeln und Modus der Vorlage, aber nur, wenn ein Ausgangsprodukt mitgeschickt wird.
3. Lagerprüfung und je Produkt nur eine Variante.

{% hint style="warning" %}
Gewichtung, Booster und Vielfalt wirken bei diesen Typen nicht. Die Reihenfolge kommt allein aus den Verhaltensdaten. Wenn Sie die Regler im Formular verstellen, ändert sich das Ergebnis nicht.
{% endhint %}

## Die KI-Anteile

InsightSearch nutzt mehrere KI-gestützte Signale. Sie steuern sie im Plugin-Dashboard unter **Produkte & Daten → KI**.

| Einstellung                       | Wirkung                                                                                                                                                                  |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| „Bedeutungs-Ähnlichkeit (KI)“     | Empfiehlt Produkte, die inhaltlich ähnlich sind, auch bei anderer Kategorie oder anderem Wortlaut. Aus: klassische Empfehlungen nach Marke, Kategorie und Preis.         |
| „Kaufverhalten einbeziehen“       | Berücksichtigt, welche Produkte Ihre Besucher zusammen kaufen oder ansehen. Berechnet wird nachts.                                                                       |
| „Gewichtung der KI“               | Verstärkt oder schwächt den KI-Anteil in allen Empfehlungen dieser Datenquelle. 1,0× entspricht den Einstellungen der Vorlagen.                                          |
| „Beschreibung für KI-Ähnlichkeit“ | Wie viel der Produktbeschreibung in die KI-Ähnlichkeit einfließt: „Gekürzt“, „Vollständig“ oder „Nicht nutzen“. Eine Änderung berechnet die KI-Daten im Hintergrund neu. |
| „Insight-Analyse“ (Beta)          | Wertet Bestellungen, Klicks und Suchen täglich aus und liefert Bestseller, Trends und Beliebtheit für Ihre Empfehlungen.                                                 |

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-ebad483066009c255ead9bf10e510c70bd7d15cb%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-ki-funktionen.png?alt=media" alt="Bereich KI im Plugin-Dashboard mit den KI-Funktionen"><figcaption></figcaption></figure>

### So entstehen die KI-Daten

* **Inhaltliche Ähnlichkeit:** Aus Titel, Marke, Kategorie, Merkmalen und je nach Einstellung der Beschreibung entsteht für jedes Produkt ein Muster. Nach einer erneuten Indexierung bleiben diese Daten erhalten. Nur geänderte Produkte werden neu aufbereitet.
* **Ähnliche Produkte und Kaufverhalten:** werden jede Nacht neu berechnet. Kaufverhalten entsteht erst, wenn mindestens drei Besuche dieselben zwei Produkte zusammen in den Warenkorb gelegt oder angesehen haben. Nach größeren Sortimentsänderungen können Sie die Berechnung mit „Jetzt neu berechnen“ sofort anstoßen, höchstens einmal pro Stunde.
* **Beliebtheit:** ein Wert je Produkt aus Klicks, Warenkorb und Bestellungen der letzten 30 Tage. Er entsteht nur mit eingeschalteter Insight-Analyse. Ohne sie bleibt der Anteil „Beliebtheit“ in der Gewichtung ohne Wirkung.

Der Bereich KI zeigt Ihnen, wie weit die Daten sind: „KI-Aufbereitung“, „Produkte mit KI-Nachbarn“ und „Produkte mit Kaufsignalen“.

{% hint style="info" %}
„Ähnliche Produkte (Alternativen)“ ist im Kern eine Ähnlichkeitsberechnung. Echtes Zubehör statt ähnlicher Produkte entsteht vor allem über Kaufverhalten, über Regeln (zum Beispiel eine andere Kategorie als das Ausgangsprodukt) oder über das Preset „Zubehör (Produktseite)“. Solange Ihr Shop noch wenig Kaufverhalten gesammelt hat, zeigt der Typ eher ähnliche Produkte.
{% endhint %}

## Ausweichweg bei Störungen

InsightSearch rechnet immer mit dem aktuellen Verfahren. Bei einer Störung springt automatisch ein älteres Verfahren ein, damit der Block nicht leer bleibt. Die Vorschau einer Vorlage zeigt das mit dem Hinweis, dass die Berechnung über das ältere Verfahren lief.

## Weiterlesen

{% content-ref url="/pages/YEzwBfwJdo4PQnilLZp7" %}
[Empfehlungs-Typen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/empfehlungs-typen.md)
{% endcontent-ref %}

{% content-ref url="/pages/kmAEtVd6SYzhWwzFcHfH" %}
[Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md)
{% endcontent-ref %}

{% content-ref url="/pages/feLEn8eidOb5LUUtR1fr" %}
[Vorschau und Sandbox](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorschau-und-sandbox.md)
{% endcontent-ref %}

{% content-ref url="/pages/6k1qZUWCUdvgoVMAXycx" %}
[Wann wirkt eine Änderung?](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/wann-wirkt-eine-aenderung.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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/so-entstehen-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.
