> 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/vorlagen/empfehlungs-vorlagen.md).

# Empfehlungs Vorlagen

Alle Felder einer Empfehlungs-Vorlage in Cross Selling Pro, von Schnellstart bis Darstellung, mit Wirkung und Standardwerten.

Diese Seite ist das Nachschlagewerk zum Formular einer Empfehlungs-Vorlage. Sie finden hier jede Karte und jedes Feld mit seiner Wirkung, dem Standardwert und dem Paket, ab dem es nutzbar ist. Für den ersten Überblick lesen Sie zuerst [Vorlagen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen.md). Wie Filter, Gewichtung und Booster im Detail rechnen, steht auf eigenen Unterseiten.

## Vorlage anlegen oder bearbeiten

1. Öffnen Sie im Shopware-Admin **Inhalte → KI-gestütztes Cross-Selling**.
2. Wählen Sie in der Seitenleiste **Ausspielung → Empfehlungs-Vorlagen**.
3. Klicken Sie oben rechts auf „Vorlage anlegen“ oder auf den Namen einer vorhandenen Vorlage.
4. Füllen Sie die Karten von oben nach unten aus.
5. Klicken Sie auf „Speichern“.

Oben rechts stehen außerdem „Support“, „Abbrechen“ und der Schalter „Expertenmodus anzeigen“. Der Expertenmodus blendet zusätzliche Felder ein, er wird nicht gespeichert und ist beim nächsten Öffnen wieder aus. Enthält eine Vorlage bereits Filterregeln, schaltet sich der Expertenmodus beim Öffnen von selbst ein, damit Sie die Regeln sehen.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-22692866fc9f0a6fa351906c73e515c5122e131f%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-vorlage-bearbeiten.png?alt=media" alt="Formular einer Empfehlungs-Vorlage mit den Karten Schnellstart, Allgemein, Quelle und Filter"><figcaption></figcaption></figure>

{% hint style="info" %}
Die Karte „Vorschau“ erscheint erst, wenn die Vorlage einmal gespeichert ist. Speichern Sie eine neue Vorlage also früh, um das Ergebnis direkt prüfen zu können. Mehr dazu unter [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).
{% endhint %}

### Was eine neue Vorlage mitbringt

| Einstellung      | Startwert                                                  |
| ---------------- | ---------------------------------------------------------- |
| „Empfehlungstyp“ | „Ähnliche Produkte (Alternativen)“                         |
| „Quelle“         | „InsightSearch API“                                        |
| „Produkttyp“     | „Gleicher Typ“ (wirkt nur nach Freischaltung, siehe unten) |
| Filterregeln     | keine                                                      |
| „Limit“          | 6                                                          |
| „Button-Aktion“  | „In den Warenkorb“                                         |
| „Fallback-Typ“   | „Kein Fallback“                                            |

Leere Zahlenfelder bedeuten „Standard von InsightSearch“. Eine neue Vorlage speichert keine eigenen Gewichte, sie übernimmt immer die aktuellen Standardwerte.

## Karte „Schnellstart“

Ein „Preset“ setzt Empfehlungstyp und Konfiguration auf bewährte Startwerte für einen Einsatzzweck. Danach können Sie jeden Wert frei ändern. Unter dem Feld steht, worauf das Preset beruht, und über „Alle Presets erklärt“ klappen Sie eine Beschreibung aller Presets auf.

Bei einer bereits gespeicherten Vorlage fragt das Formular vorher nach („Preset anwenden?“). Das Preset ersetzt Typ, Quelle, Filter, Gewichtung und Booster. Anzahl, Button, Ersatz und vorhandene Filterregeln bleiben erhalten.

| Preset                                 | Empfehlungstyp    | Was es einstellt                                                                                                                         |
| -------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| „Automatisch (empfohlen)“              | Ähnliche Produkte | Modus „Gemischt“, Mindest-Ähnlichkeit 0,05, lieferbare Produkte bevorzugt. Guter Standard für die meisten Shops.                         |
| „Gleiche Kategorie & Preisklasse“      | Ähnliche Produkte | Modus „Nur gleiche Kategorie“, Preisabweichung 0,4, Mindest-Ähnlichkeit 0,05, lieferbare bevorzugt                                       |
| „Gleiche Marke“                        | Ähnliche Produkte | Modus „Nur gleiche Marke“, lieferbare bevorzugt                                                                                          |
| „Zubehör (Produktseite)“               | Ähnliche Produkte | Kundenverhalten stärker gewichtet, Produkttyp „Passende Typen“, lieferbare bevorzugt                                                     |
| „Warenkorb: passendes Zubehör“         | Ähnliche Produkte | Kundenverhalten stärker gewichtet, „Passende Typen“, Referenzprodukt „Mischung“, Warenkorb-Produkte ausgeschlossen, lieferbare bevorzugt |
| „Oft zusammen gekauft (nur Kaufdaten)“ | Passt gut dazu    | reine Bestelldaten ab 2 gemeinsamen Käufen                                                                                               |
| „Bestseller“                           | Bestseller        | meistverkaufte Produkte, z. B. für die Startseite                                                                                        |
| „Trends“                               | Trends            | angesagte Produkte, z. B. für die Startseite                                                                                             |
| „Persönlich“                           | Personalisiert    | braucht Tracking-Daten                                                                                                                   |
| „Zuletzt angesehen“                    | Zuletzt Angesehen | braucht Tracking-Daten                                                                                                                   |
| „Weitermachen, wo du aufgehört hast“   | Weitermachen      | Produkte aus nicht bestellten Warenkörben                                                                                                |
| „Erneut kaufen“                        | Erneut kaufen     | früher bestellte Produkte des Kunden                                                                                                     |
| „Inspiration aus der Wunschliste“      | Wunschliste       | ähnliche Produkte zu Artikeln auf der Wunschliste                                                                                        |

Bei den Verhaltens-Presets (ab „Oft zusammen gekauft“) ist der Produkttyp ausgeschaltet. Ist der Typ eines Presets nicht in Ihrem Paket enthalten, steht hinter dem Namen ein Schloss mit dem nötigen Paket. Ein Klick darauf öffnet die Paketübersicht, statt das Preset anzuwenden.

## Karte „Allgemein“

| Feld             | Wirkung                                                                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| „Name“           | Pflichtfeld. Interner Name zur Wiedererkennung im Admin, Kunden sehen ihn nicht.                                                     |
| „Empfehlungstyp“ | Bestimmt, welche Art von Empfehlungen die Vorlage ausgibt. Über „Was bedeuten die Empfehlungstypen?“ klappen Sie eine Erklärung auf. |
| „Beschreibung“   | Optionale interne Notiz, zum Beispiel auf welchen Seiten die Vorlage läuft. Auch längere Texte sind möglich.                         |

### Die Empfehlungstypen

| Typ (Admin-Bezeichnung)                                                        | Kurz erklärt                                                                                                           | Paket      |
| ------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- | ---------- |
| „Ähnliche Produkte (Alternativen)“                                             | Produkte passend zum Referenzprodukt. Nutzt Produktinhalte und funktioniert ab dem ersten Tag, auch ohne Bestellungen. | ab Basic   |
| „Zuletzt Angesehen“                                                            | Produkte, die sich der Besucher zuletzt angesehen hat                                                                  | ab Basic   |
| „Bestseller (Meistverkaufte Produkte)“                                         | meistverkaufte Produkte des Shops                                                                                      | ab Starter |
| „Erneut kaufen (Produkte aus deiner Bestellhistorie)“                          | früher bestellte Produkte des angemeldeten Kunden                                                                      | ab Starter |
| „Passt gut dazu (wird zusammen gekauft)“                                       | nutzt echte Bestelldaten, braucht Bestellhistorie                                                                      | ab Experte |
| „Trends (Was wurde in letzter Zeit oft gesucht, geklickt und gekauft)“         | gerade gefragte Produkte                                                                                               | ab Experte |
| „Personalisiert (Auf Basis der Klicks, Suchen und Käufe)“                      | Empfehlungen aus dem Verhalten des Besuchers                                                                           | ab Experte |
| „Weitermachen wo du aufgehört hast (Produkte im Warenkorb, aber nie bestellt)“ | Produkte aus früheren, nicht bestellten Warenkörben                                                                    | ab Experte |
| „Inspiriert durch deine Wünsche (basierend auf deiner Wunschliste)“            | ähnliche Produkte zu Artikeln auf der Wunschliste                                                                      | ab Experte |

Welche Daten jeder Typ braucht und was er ohne Daten zeigt, 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). Ist der gewählte Typ in Ihrem Paket nicht enthalten, zeigt das Formular einen Sperrhinweis mit dem nötigen Paket.

## Karte „Expertenmodus“

Diese Karte erscheint nur bei eingeschaltetem Expertenmodus. Sie zählt, wie viele Experten-Einstellungen vom Standard abweichen, zum Beispiel „1 Experten-Einstellung weicht vom Standard ab.“

* „Alle Experten-Einstellungen zurücksetzen“ setzt alle Schalter und Zahlen des Expertenmodus auf den Standard. Quelle, Modus, Produkttyp, Gewichtung, Filterregeln, Booster und Darstellung bleiben unverändert. Wirksam wird das erst mit „Speichern“.
* An jedem abweichenden Feld steht der Link „Auf Standard zurücksetzen“.

## 1. Quelle

Hier legen Sie fest, woher die Produkte kommen.

| Feld                         | Wirkung                                                                                                                                                                                                                                                                                                                                                      | Standard                                 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- |
| „Quelle“                     | „InsightSearch API“: InsightSearch berechnet die Empfehlungen passend zu Typ, Filtern und Gewichtung. „Dynamische Produktgruppe“: zeigt die Produkte einer Shopware-Produktgruppe. „Bundle/Set-Vorlage“: zeigt die Produkte einer Bundle-/Set-Vorlage. „Cross-Selling (vom Referenzprodukt)“: zeigt das am Referenzprodukt gepflegte Shopware-Cross-Selling. | „InsightSearch API“                      |
| „Fallback Produktgruppe“     | Nur bei Quelle „Dynamische Produktgruppe“: die Produktgruppe, deren Produkte erscheinen. Das Feld trägt hier diese Beschriftung, ist aber die eigentliche Quelle.                                                                                                                                                                                            | leer                                     |
| „Bundle/Set-Vorlage“         | Nur bei Quelle „Bundle/Set-Vorlage“: die Vorlage, deren Produkte erscheinen                                                                                                                                                                                                                                                                                  | leer                                     |
| „Cross-Selling Name“         | Nur bei Quelle „Cross-Selling“: optional der Name des Cross-Selling am Produkt                                                                                                                                                                                                                                                                               | leer                                     |
| „Cross-Selling Position“     | Nur bei Quelle „Cross-Selling“: welches Cross-Selling genommen wird, wenn kein Name gesetzt ist (1 = das erste)                                                                                                                                                                                                                                              | 1                                        |
| „Produktquelle“              | Nur bei „InsightSearch API“ und Typ „Ähnliche Produkte“: „Automatisch (PDP)“ nimmt das Produkt der aktuellen Seite als Referenz.                                                                                                                                                                                                                             | „Automatisch (PDP)“                      |
| „Warenkorb: Referenzprodukt“ | Nur bei „InsightSearch API“ und Typ „Ähnliche Produkte“. Gilt nur im Offcanvas-Warenkorb und auf der Warenkorbseite, siehe unten.                                                                                                                                                                                                                            | „Höchster Positionswert (Preis × Menge)“ |
| „Feste Produkte“             | Diese Produkte werden zuerst angezeigt und zählen auf das Limit. Ab Paket Starter.                                                                                                                                                                                                                                                                           | keine                                    |
| „Mindest-Kaufhäufigkeit“     | Nur im Expertenmodus. Für Kauf-Empfehlungen: Produktpaare müssen mindestens so oft gemeinsam gekauft worden sein (1 bis 50).                                                                                                                                                                                                                                 | Standard von InsightSearch               |

{% hint style="warning" %}
Ist „Dynamische Produktgruppe“ oder „Bundle/Set-Vorlage“ gewählt, aber noch nichts ausgewählt, speichert das Formular nicht. Es meldet „Nicht gespeichert: Im Abschnitt „1. Quelle“ fehlt noch eine Auswahl.“
{% endhint %}

### Referenzprodukt im Warenkorb

Im Warenkorb gibt es mehrere Produkte. Das Feld „Warenkorb: Referenzprodukt“ entscheidet, zu welchem Produkt die Empfehlungen gesucht werden:

| Option                                   | Bedeutung                                                                                                                                                                                                                                |
| ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Höchster Positionswert (Preis × Menge)“ | die Position mit dem höchsten Gesamtwert                                                                                                                                                                                                 |
| „Höchster Einzelpreis“                   | das teuerste einzelne Produkt                                                                                                                                                                                                            |
| „Zuletzt hinzugefügt“                    | das Produkt, das zuletzt in den Warenkorb kam                                                                                                                                                                                            |
| „Mischung aus mehreren Positionen“       | sucht zu bis zu fünf Positionen (teuerste zuerst) und mischt die Ergebnisse abwechselnd. Bei vielen Positionen nimmt InsightSearch nach gut einer Sekunde keine weiteren Positionen mehr dazu, damit der Warenkorb nicht langsamer lädt. |

### Feste Produkte

{% hint style="info" %}
Verfügbar ab Paket Starter.
{% endhint %}

Feste Produkte stehen immer vorne. Sie zählen auf das Limit: Bei „Limit“ 6 und zwei festen Produkten kommen vier berechnete Empfehlungen dazu. Ein festes Produkt, das gerade angesehen wird oder schon im Warenkorb liegt, fällt weg. Feste Produkte gelten überall, wo die Vorlage läuft. Für eine Aktion auf wenigen Seiten legen Sie besser eine eigene Vorlage an.

### Shop-Quellen: Was wirkt noch?

Bei „Dynamische Produktgruppe“, „Bundle/Set-Vorlage“ und „Cross-Selling“ liefert der Shop die Produkte selbst. Das Formular zeigt dann den Kasten „Was wirkt bei dieser Quelle?“:

| Wirkt                                                                                              | Wirkt nicht                                                                                           |
| -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Anzahl, Button, feste Produkte (werden vorangestellt), Fallback, „Warenkorb-Produkte ausschließen“ | Empfehlungstyp (steuert nur Paket und Ausspielort), Schnellstart-Presets, Filter, Gewichtung, Booster |

Die Karten „Schnellstart“, „2. Filter“, „3. Gewichtung“ und „4. Booster“ bleiben sichtbar, sind aber ausgegraut. Ihre Werte bleiben gespeichert und gelten wieder, sobald Sie auf „InsightSearch API“ zurückwechseln.

{% hint style="warning" %}
Die Quelle „Cross-Selling“ braucht ein Referenzprodukt. Auf Produktseiten und im Warenkorb ist eines vorhanden, im Kundenkonto und im Offcanvas-Warenkorb nicht. Dort bleibt der Block leer.
{% endhint %}

## 2. Filter

Filter entscheiden hart, welche Produkte überhaupt in Frage kommen. Was ein Filter ausschließt, holt keine Gewichtung zurück. Ganz oben fasst der Kasten „Kurz gesagt: Was diese Vorlage filtert“ alle aktiven Filter in Klartext zusammen.

| Feld                              | Wirkung                                                                                                                                                                                                   | Standard                                   |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| „Modus“                           | „Gemischt“: keine Bindung, die Ähnlichkeit entscheidet. „Nur gleiche Marke“ bzw. „Nur gleiche Kategorie“: nur Produkte derselben Marke oder Hauptkategorie wie das Referenzprodukt.                       | „Gemischt“                                 |
| „Produkttyp“                      | „Aus (wie bisher)“, „Gleicher Typ“, „Bevorzugt (gleiche Gruppe)“, „Passende Typen“. Wirkt nur, wenn die Produkttyp-Erkennung für Ihren Index freigeschaltet ist.                                          | neue Vorlagen „Gleicher Typ“, ältere „Aus“ |
| „Lieferbare Produkte bevorzugen“  | Lieferbare Produkte rücken nach vorne, nicht lieferbare bleiben möglich                                                                                                                                   | aus (bei vielen Presets an)                |
| „Artikelgruppe ausschließen“      | Expertenmodus. Varianten des Referenzprodukts schließt InsightSearch ohnehin immer aus, der Schalter wirkt nur noch beim älteren Ausweichverfahren.                                                       | aus                                        |
| „Gleichen Titel verbieten“        | Expertenmodus. Entfernt Produkte mit exakt demselben Titel wie das Referenzprodukt.                                                                                                                       | an                                         |
| „Warenkorb-Produkte ausschließen“ | Expertenmodus. Schließt Produkte im Warenkorb (samt Varianten) auch auf Produktseiten und in Erlebniswelten aus. Warenkorb und Offcanvas schließen sie immer aus. Bleibt auch bei Shop-Quellen bedienbar. | aus                                        |
| „Mindest-Ähnlichkeitsscore“       | Expertenmodus. Qualitätsschwelle von 0 bis 1, 0 = aus. Es können weniger Produkte erscheinen, als das Limit erlaubt.                                                                                      | 0 (aus)                                    |
| Regel-Baukasten („Filter“)        | Expertenmodus, ab Paket Experte. Eigene Regeln auf Produktfelder.                                                                                                                                         | keine Regeln                               |

{% hint style="info" %}
Die Produkttyp-Erkennung ist eine Beta-Funktion. InsightSearch schaltet sie für Ihren Index frei. Solange sie nicht freigeschaltet ist, verhält sich jede Einstellung wie „Aus“.
{% endhint %}

Ausführlich mit Beispielen: [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).

## 3. Gewichtung

Die Gewichtung ist immer sichtbar. Sie bestimmt die Reihenfolge der Produkte, die nach den Filtern übrig bleiben. Jedes Gewicht wirkt als Anteil an der Summe aller Gewichte, der Balken „Anteil an der Ähnlichkeit“ zeigt die Verteilung.

### Profile

Hinter „Profil:“ wählen Sie eine fertige Gewichtung. Ein Profil setzt alle neun Gewichte neu, eigene Werte gehen dabei verloren (Rückfrage „Eigene Gewichtung ersetzen?“).

| Profil                    | Wofür                                                                         |
| ------------------------- | ----------------------------------------------------------------------------- |
| „Ausgewogen (Standard)“   | Standardwerte von InsightSearch, für die meisten Shops der beste Start        |
| „Gleiche Marke bevorzugt“ | gleiche Marke zählt deutlich mehr, andere Marken bleiben möglich              |
| „Gleiche Eigenschaften“   | Farbe, Material, Größe und Attribute zählen am meisten                        |
| „Inhaltlich ähnlich (KI)“ | inhaltliche Ähnlichkeit zählt am meisten, braucht die fertige KI-Aufbereitung |
| „Kaufverhalten zuerst“    | gemeinsames Ansehen und Kaufen zählt am meisten, braucht genug Daten          |
| „Gleiche Preislage“       | ähnlicher Preis zählt am meisten                                              |

Passt kein Profil, steht dort „Eigene Gewichtung (kein Profil passt genau).“ Fehlen für ein Profil noch Daten, trägt es ein Warnzeichen.

### Die neun Regler

Alle Regler reichen von 0 bis 1 in Schritten von 0,05.

| Regler            | Was zählt                                                | Standard (Anteil) |
| ----------------- | -------------------------------------------------------- | ----------------- |
| „Kategorie“       | gleiche oder nahe Kategorie                              | 0,35 (≈ 21 %)     |
| „Marke“           | gleiche Marke                                            | 0,35 (≈ 21 %)     |
| „Inhalt (KI)“     | inhaltliche Ähnlichkeit aus Titel und Beschreibung       | 0,3 (≈ 18 %)      |
| „Preis“           | ähnliche Preislage                                       | 0,2 (≈ 12 %)      |
| „Kundenverhalten“ | zusammen angesehen, in den Warenkorb gelegt oder gekauft | 0,2 (≈ 12 %)      |
| „Beliebtheit“     | allgemein beliebte Produkte                              | 0,1 (≈ 6 %)       |
| „Kontext“         | Farbe, Material, Geschlecht, Größe und Hauptkategorie    | 0,1 (≈ 6 %)       |
| „Attribute“       | übereinstimmende Produktattribute                        | 0,05 (≈ 3 %)      |
| „Tags“            | gleiche Tags                                             | 0,05 (≈ 3 %)      |

### Feineinstellungen (Expertenmodus)

| Feld                          | Wirkung                                                                | Bereich              |
| ----------------------------- | ---------------------------------------------------------------------- | -------------------- |
| „Kategorie bevorzugen“        | Schalter, gewichtet Treffer aus derselben Kategorie höher              | an/aus, Standard aus |
| „Max. Preisabweichung“        | Preisband: 0,35 = bis ±35 % gilt als preisähnlich                      | 0,05 bis 3           |
| „Kategoriebonus“              | Bevorzugung derselben Kategorie (nur mit „Kategorie bevorzugen“)       | 0 bis 1              |
| „Marken-Abwertung“            | mehr Markenvielfalt                                                    | 0 bis 1              |
| „Interne Kategorie-Abwertung“ | mehr Abwechslung innerhalb einer Kategorie                             | 0 bis 1              |
| „Vielfalt“                    | nur im Modus „Gemischt“: 1 = nur Ähnlichkeit, 0 = maximale Abwechslung | 0 bis 1              |

Der Knopf „Für Sandbox kopieren“ kopiert die rechenrelevanten Werte in die Zwischenablage. Ausführlich: [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).

## 4. Booster

Diese Karte erscheint nur im Expertenmodus. Booster geben einem Produkt Zusatzpunkte, wenn eine Bedingung zutrifft, unabhängig davon, wie ähnlich es ist.

| Feld                        | Wirkung                                        | Bereich                     |
| --------------------------- | ---------------------------------------------- | --------------------------- |
| „Marken-Verstärkung“        | verstärkt Produkte derselben Marke             | 0,1 bis 10, 1 = kein Effekt |
| „Kategorie-Verstärkung“     | verstärkt Produkte derselben Kategorie         | 0,1 bis 10, 1 = kein Effekt |
| „Kategoriepfad-Verstärkung“ | verstärkt Produkte aus demselben Kategoriepfad | 0,1 bis 10, 1 = kein Effekt |

Eigene Booster-Regeln, etwa für Marge, lassen sich nicht anlegen. Die einzige weitere Bevorzugung ist der Schalter „Lieferbare Produkte bevorzugen“ unter „2. Filter“.

## 5. Darstellung

| Feld                     | Wirkung                                                                                                                                 | Standard           |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| „Limit“                  | Pflichtfeld. Höchstzahl der angezeigten Empfehlungen, 1 bis 50.                                                                         | 6                  |
| „Button-Aktion“          | „Zum Produkt“ öffnet die Produktseite, „In den Warenkorb“ legt das Produkt direkt in den Warenkorb, „Details + Warenkorb“ zeigt beides. | „In den Warenkorb“ |
| „Fallback-Schwelle (≤)“  | Der Ersatz greift, sobald die Zahl der geladenen Produkte kleiner oder gleich diesem Wert ist (0 bis 50).                               | 0                  |
| „Fallback-Typ“           | „Kein Fallback“ (der Block kann leer bleiben), „Andere Vorlage“, „Feste Produkte“, „Dynamische Produktgruppe“                           | „Kein Fallback“    |
| „Fallback-Vorlage“       | bei „Andere Vorlage“: die Vorlage, die einspringt                                                                                       | leer               |
| „Fallback-Produkte“      | bei „Feste Produkte“: diese Produkte erscheinen, wenn der Ersatz greift                                                                 | leer               |
| „Fallback Produktgruppe“ | bei „Dynamische Produktgruppe“: die Produktgruppe, die einspringt                                                                       | leer               |

**Beispiel:** „Limit“ 6, „Fallback-Schwelle (≤)“ 3, „Fallback-Typ“ „Andere Vorlage“ mit einer Bestseller-Vorlage. Findet die Vorlage nur 2 Produkte, zeigt der Block stattdessen die Bestseller.

{% hint style="warning" %}
Eine Ersatz-Vorlage, deren Typ in Ihrem Paket nicht enthalten ist, wird nicht verwendet. Wählen Sie als Ersatz einen Typ aus Ihrem Paket.
{% endhint %}

Ein Block ohne Produkte wird im Shop nicht angezeigt. Ohne Ersatz kann ein Block daher auf manchen Seiten fehlen.

## Speichern und Wirkung

Gespeicherte Änderungen gelten ab der nächsten Empfehlung, die der Shop abruft. Zwischengespeicherte Erlebniswelt-Seiten, die diese Vorlage nutzen, verwirft Shopware beim Speichern automatisch. Mehr unter [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)

## Weiterlesen

{% content-ref url="/pages/QgU30LU0ZaCBRpIydy5p" %}
[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)
{% 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/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 %}


---

# 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/vorlagen/empfehlungs-vorlagen.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.
