> 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 Empfehlungs-Vorlagen steuern, welche Art von Produkten an welcher Stelle deines Shops empfohlen werden. Du kannst beliebig viele Vorlagen anlegen und diese dann verschiedenen Bereichen deines Shops zuweisen. *** ## Was ist ein Empfehlungs-Vorlage? Eine Vorlage ist eine gespeicherte Konfiguration, die festlegt: * **Welcher Empfehlungstyp** angezeigt wird (z. B. „Dazu passt auch" oder „Personalisiert") * **Wie viele Produkte** der Slider zeigt * **Welche Aktion** der Button unter jedem Produkt auslöst (Produktseite oder direkt in den Warenkorb) * **Was passiert**, wenn InsightSearch nicht genug Empfehlungen liefert (Fallback) Vorlagen werden anschließend in den CMS-Elementen und im Setup-Wizard ausgewählt. *** ## Vorlage anlegen 1. Öffne im Shopware-Admin unter **Inhalte -> KI gestütztes - Cross-Selling → Empfehlungs-Vorlagen**. 2. Klicke auf **Vorlage anlegen**. 3. Fülle die Felder aus (Details siehe unten). 4. Klicke auf **Speichern**. *** ## Abschnitt „Allgemein" | Feld | Beschreibung | | ------------------ | ----------------------------------------------------------------------------------------------- | | **Name** | Interner Name der Vorlage, der nur im Admin sichtbar ist (z. B. `Dazu passt auch – Startseite`) | | **Empfehlungstyp** | Legt die Art der Empfehlungen fest – siehe Tabelle unten | | **Beschreibung** | Optionale interne Notiz | ### Empfehlungstypen im Überblick | Typ | Wann verwenden | | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Dazu passt auch** | Für Produktseiten: Zeigt Produkte, die besonders gut zu dem aktuell betrachteten Artikel passen – zum Beispiel ergänzende oder kombinierbare Produkte. | | **Besteller** | Zeigt Produkte, die in letzter Zeit besonders häufig gekauft wurden. So sehen deine Kunden auf einen Blick, welche Artikel aktuell am beliebtesten sind. | | **Trends** | Zeigt Produkte, die aktuell stark im Fokus stehen – also häufig gekauft, gesucht oder angeklickt werden. Ideal, um angesagte Artikel und neue Lieblinge sichtbar zu machen. | | **Zuletzt angesehen** | Zeigt Produkte, die der Kunde sich vor kurzem bereits angeschaut hat. So kann er schnell zu interessanten Artikeln zurückkehren, ohne sie erneut suchen zu müssen. | | **Personalisiert** | Zeigt Produktempfehlungen, die auf dem Verhalten des Kunden basieren – also auf seinen Suchen, Klicks und Käufen. Ziel ist, möglichst genau die Artikel anzuzeigen, die zu seinen Interessen passen. | {% hint style="info" %} **Empfehlung für den Start:** Beginne mit **Dazu passt auch** auf der Produktdetailseite und **Besteller** auf der Startseite. {% endhint %} *** ## Abschnitt „Verhalten" | Feld | Beschreibung | | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Limit** | Wie viele Produkte der Slider maximal anzeigt (1–50, Standard: 6) | | **Datenquelle** | `InsightSearch API` (Standard) oder `Dynamische Produktgruppe` – Letzteres zeigt statt KI-Empfehlungen Produkte aus einer festen Shopware-Produktgruppe | | **Modus** | Nur bei Nicht-Komplementär-Typen: `Gemischt`, `Nur gleiche Marke` oder `Nur gleiche Kategorie` | | **Produktquelle** | Bei „Dazu passt auch": `Automatisch (PDP)` ermittelt das Referenzprodukt aus dem Seitenkontext; `Festes Produkt` erlaubt die Auswahl eines bestimmten Referenzprodukts | | **Button-Aktion** | Was passiert, wenn ein Kunde auf ein Empfehlungsprodukt klickt: `Zum Produkt`, `In den Warenkorb` oder beides | | **Feste Produkte** | Produkte, die immer zuerst im Slider erscheinen (zählen auf das Limit) | *** ## Abschnitt „Fallback" Der Fallback greift, wenn InsightSearch zu wenig Empfehlungen für ein Produkt berechnen kann – z. B. bei neuen oder sehr seltenen Produkten. | Feld | Beschreibung | | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | **Fallback-Schwelle** | Ab wie vielen Produkten (≤ dieser Zahl) der Fallback aktiviert wird. `0` bedeutet: Fallback greift nur, wenn gar keine Empfehlungen vorhanden sind | | **Fallback-Typ** | Was im Fallback-Fall angezeigt wird: kein Fallback, ein anderes Template, feste Produkte oder eine dynamische Produktgruppe | *** ## Abschnitt „Boosts & Gewichtungen" Dieser Abschnitt ermöglicht eine Feinabstimmung des Empfehlungsalgorithmus. Die Standardwerte funktionieren für die meisten Shops gut – eine Anpassung ist optional. | Option | Beschreibung | | ------------------------------ | ---------------------------------------------------------------- | | **Kategorie bevorzugen** | Gewichtet Produkte aus derselben Kategorie höher | | **Artikelgruppe ausschließen** | Blendet Varianten desselben Produkts aus | | **Gleichen Titel verbieten** | Verhindert, dass Produkte mit identischem Namen empfohlen werden | Die numerischen Felder (Marken-Penalty, Kategorie-Bonus, etc.) erlauben eine präzise Gewichtung des Algorithmus. Für den Einstieg empfehlen wir, diese auf den Standardwerten zu belassen. *** ## Beispiel: Einfaches „Dazu passt auch"-Template Empfohlene Einstellungen für einen schnellen Start auf der Produktseite: | Einstellung | Wert | | ----------------- | ----------------------- | | Name | `Dazu passt auch – PDP` | | Empfehlungstyp | Dazu passt auch | | Limit | 6 | | Button-Aktion | Details + Warenkorb | | Fallback-Schwelle | 0 | | Fallback-Typ | Kein Fallback | *** ## Nächster Schritt Lege als nächstes ein [Bundle/Set-Template](broken://pages/c0f4e07e801458291768c9e9e54caa3bfa6948b3) an (falls du den Bundle-Konfigurator nutzen möchtest), oder gehe direkt zum [Slider in Erlebniswelten einbinden](broken://pages/086d854b18f730fdb61490107cfd4146bf5c17ad). --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.