Handbuch KI Produkt-Bundles.

Von der ersten Erzeugung bis zum Rabatt im Warenkorb: Sets bilden und freigeben, Quellen und Grenzen einstellen, Position wählen - und im Zweifel herausfinden, warum ein Rabatt nicht greift.

Systemvoraussetzungen

Shopware 6.7 mit Storefront, PHP 8.2 oder neuer. Für Läufe im Hintergrund und den geplanten Lauf muss die Nachrichtenwarteschlange arbeiten; der eingebaute Admin-Worker genügt.

Für die KI-Bewertung brauchst du einen eigenen API-Key beim gewünschten Anbieter. Abgerechnet wird direkt dort, es läuft nichts über unsere Server.

Installation

ZIP im Admin unter Erweiterungen hochladen, installieren, aktivieren. Danach den Lizenzschlüssel im Lizenzbildschirm eintragen.

In fünf Schritten einsatzbereit

  • Lizenzschlüssel eintragen und aktivieren
  • Unter Einstellungen die Position auf der Produktseite wählen
  • Größe der Sets und Anzahl je Produkt festlegen
  • Im Reiter Bundles auf „Bundles erzeugen" klicken
  • Ergebnisse prüfen und freigeben
Wichtig: Nur freigegebene Sets erscheinen im Shop. Ein frisch erzeugter Satz ist zunächst offen und für Kunden unsichtbar.

Aufbau der Sets

Produkte je Bundle legt fest, wie viele Produkte ein Set insgesamt enthält, das Ankerprodukt eingerechnet. Bei drei bekommt der Kunde das angesehene Produkt plus zwei Partner.Bundles je Produkt legt fest, wie viele verschiedene Sets für ein Produkt entstehen. Die Sets überschneiden sich nicht: ein Partner, der bereits in einem Set steckt, wird für das nächste nicht erneut verwendet.Kleinere Bundles zulassen erlaubt ein Set mit weniger Produkten, wenn nicht genügend passende Partner gefunden werden. Ausgeschaltet gilt: entweder das Set ist vollständig oder es entsteht gar nicht.

Datenquellen

Warenkorb-Analyse wertet aus, welche Produkte in echten Bestellungen gemeinsam gekauft wurden - die belastbarste Quelle. Mindestanzahl gemeinsamer Bestellungen und Betrachtungszeitraum steuern, wie streng gefiltert wird.Gemeinsam angesehen wertet aus, welche Produkte Besucher innerhalb desselben Besuchs ansehen. Je Besuch wird ein Merkfenster der zuletzt angesehenen Produkte geführt und das aktuelle Produkt mit allen darin gepaart.Gemeinsame Kategorien und Gemeinsame Eigenschaften helfen bei dünner Bestellhistorie. Gleicher Hersteller ist die schwächste Quelle und nur als Notnagel gedacht.

Werden mehrere Quellen aktiviert, addieren sich die Gewichte. Echte Co-Käufe zählen dabei dreifach, „Gemeinsam angesehen" wiegt stärker als die Katalogquellen und schwächer als echte Käufe.

Zum Datenschutz: Für „Gemeinsam angesehen" werden keine Cookies gesetzt und keine Besucherdaten gespeichert - nur Produktpaare mit einem Zähler. Bots werden verworfen. Ist das KI Cross-Selling installiert, übernimmt das Plugin dessen vorhandene Zähler einmalig beim Update.

Grenzen und Ausschlüsse

Der Höchstpreis des Partners begrenzt, wie teuer ein Partner im Verhältnis zum Ankerprodukt sein darf. Bei 60 passen zu einem Produkt für 100 Euro nur Partner bis 60 Euro. Das erzeugt Sets mit Zubehör-Charakter statt beliebiger Paarungen aus günstigen und teuren Artikeln. Null schaltet die Regel aus.

Nur lieferbare Produkte schließt Abverkaufsartikel ohne Bestand aus, damit keine Sets entstehen, die im Shop sofort wieder ausgeblendet werden.Hersteller ausschließen und Kategorien ausschließen halten Produkte vollständig heraus - sie werden weder Anker noch Partner. Sinnvoll für Gutscheine, Ersatzteile oder Versandartikel.
Zwei Wirkstellen: Der Ausschluss greift beim Erzeugen neuer Sets und bei der Anzeige im Shop. Ein bereits erzeugtes Set mit einem ausgeschlossenen Produkt verschwindet bei aktivem „Unvollständige Bundles ausblenden" ganz, andernfalls wird es ohne dieses Produkt gezeigt. Produkte ohne Hersteller sind nie betroffen; Varianten erben den Hersteller ihres Hauptprodukts.

Einzelprodukte

Der normale Lauf betrachtet die stärksten Produkte aus der Bestellhistorie und ist über „Maximale Ankerprodukte je Lauf" begrenzt.

Im Reiter Einzelprodukte wählst du Produkte gezielt aus. Für diese entstehen Sets ohne die Begrenzung, auch wenn sie in der Bestellhistorie kaum vorkommen. Nach dem Lauf erscheinen die Ergebnisse direkt unter der Auswahl und lassen sich dort freigeben, ablehnen, deaktivieren oder bearbeiten.

Ein ausgewähltes Hauptprodukt schließt seine Varianten mit ein; die Datengrundlage stammt immer von den kaufbaren Produkten.

Findet der Lauf für ein Produkt nichts, hilft Regeln lockern: Für diesen einen Lauf werden alle Datenquellen genutzt, die Mindestwerte auf eins gesetzt, Preisverhältnis und KI-Mindestpunktzahl ausgesetzt und der Zeitraum auf zwei Jahre erweitert.

Was bestehen bleibt: Ausschlüsse für Hersteller und Kategorien, Lagerbestand und aktive Produkte gelten weiter - sonst entstünden Sets, die im Shop gar nicht gezeigt werden dürfen. Die gespeicherten Einstellungen ändern sich nicht, die Lockerung gilt nur für diesen Lauf.

Die KI verwirft im gelockerten Lauf keine Sets mehr, sondern bewertet und benennt sie nur; ihre Einschätzung steht weiterhin an jedem Set. Ergebnisse eines gelockerten Laufs gehen immer in den Prüf-Pool, auch bei aktiver automatischer Freigabe.

Ein weiterer Lauf für dasselbe Produkt ersetzt die vorhandenen Sets nicht, sondern legt zusätzliche an - gleiche Kombinationen werden lediglich aktualisiert. Wie viele Sets ein Produkt im Shop zeigt, steuert „Maximal angezeigte Bundles"; der Standard ist eines. Ein Kennzeichen weist auf mehrfach belegte Ankerprodukte hin, und der Filter „Nur mehrfach belegte Produkte" im Prüf-Pool zeigt genau diese.

Status eines Sets

Ein Set ist entweder offen, freigegeben oder abgelehnt. Die verfügbaren Schaltflächen richten sich danach:

  • Offen - Bearbeiten, Freigeben, Ablehnen
  • Freigegeben - Bearbeiten und Deaktivieren. Deaktivieren nimmt das Set aus dem Shop und stellt es zurück auf offen; Name, Beschreibungstext und Rabatt bleiben erhalten
  • Abgelehnt - Bearbeiten und Freigeben

Die farbigen Kennzahlen neben einem Set erklären sich beim Überfahren mit der Maus.

Position auf der Produktseite

Vier Positionen stehen zur Wahl: oben in der Kaufbox, direkt über dem Preis; unter der kompletten Kaufbox; über der Tab-Leiste, also oberhalb von Beschreibung und Bewertungen; oder unter dem gesamten Tab-Bereich.

„Nicht anzeigen" blendet die Box aus, ohne die erzeugten Sets zu löschen.

Überschrift anzeigen und Beschreibungstext anzeigen blenden die beiden Textzeilen der Box ein oder aus. Die Texte selbst pflegst du je Set über „Bearbeiten".
Zur Mehrsprachigkeit: Die Standardtexte sind über Textbausteine übersetzt. Ein je Set gesetzter eigener Text erscheint dagegen in allen Sprachen gleich. Bleibt die Überschrift leer, greift der Standardtext; beim Beschreibungstext greift zuerst die Begründung der KI, dann der Standardtext. Beide Werte überstehen einen erneuten Erzeugungslauf.

Darstellung im Shop

Mit Einzelne Produkte abwählbar steuerst du, ob Kunden Produkte aus dem Set nehmen dürfen. Eingeschaltet steht vor jedem Produkt ein Kästchen, Gesamtpreis und Ersparnis rechnen sich beim Abwählen live neu. Ausgeschaltet entfallen die Kästchen und das Set wandert nur vollständig in den Warenkorb - sinnvoll, wenn der Rabatt nur für das komplette Set gelten soll.

Artikelnummer anzeigen blendet die Artikelnummer unter jedem Produkt der Box ein und zeigt sie zusätzlich im Prüf-Pool hinter den Produktnamen. Die Suche im Prüf-Pool findet Sets damit auch über die Artikelnummer.

Der Text der Set-Schaltfläche lässt sich anpassen: entweder ein Text für alle Sprachen oder je Sprache ein eigener. Leere Felder fallen erst auf den allgemeinen Text zurück, dann auf den übersetzten Standardtext.

Mit Bundles gegenseitig zuweisen erscheint ein Set nicht nur beim Ankerprodukt, sondern auch auf den Produktseiten der enthaltenen Partner. Das Ankerprodukt wird dort als gleichwertiges Set-Mitglied angezeigt.

Zwei Wege, unabhängig voneinander: Die Einstellung gilt allgemein; zusätzlich lässt sich die gegenseitige Zuweisung im Prüf-Pool über „Bearbeiten" für einzelne Sets setzen. Ein Set mit eigenem Haken erscheint also auch dann beidseitig, wenn die allgemeine Einstellung aus ist.

Produkte verlinken steuert, ob der Produktname in der Box zur Produktseite führt. Ausgeschaltet bleibt der Name reiner Text und der Kunde bleibt auf der Seite. Kurzinfo in Modal anzeigen öffnet beim Klick auf ein Produkt ein kleines Fenster mit Bild, Artikelnummer, Preis und Kurzbeschreibung. Sind die Verlinkungen aus, entfällt darin die Schaltfläche zum Produkt. Beide Optionen lassen sich unabhängig voneinander verwenden.

Die Darstellung der Produkte bestimmt die Anordnung in der Box. Umbruch in Reihen zeigt vier Produkte je Reihe, auf Tablets zwei, auf Handys eines. Slider hält alle Produkte in einer wischbaren Reihe; am Rechner erscheinen zusätzlich Pfeile, die sich an den Enden deaktivieren. Liste stellt jedes Produkt in eine eigene Zeile über die volle Breite.

Faustregel: Bei mehr als vier Produkten im Set sind Slider oder Liste meist die bessere Wahl - der Umbruch wird dann schnell hoch.

KI-Bewertung

Ist die KI-Bewertung aktiv, wird jedes Set an den gewählten Anbieter geschickt. Die KI entscheidet, ob die Produkte zusammenpassen, vergibt einen Score und schreibt auf Wunsch eine kurze Verkaufsüberschrift. Sets unterhalb des Mindest-Scores werden verworfen und landen gar nicht erst im Prüf-Pool.

Namen, Beschreibungstexte und Rabattbegründungen erzeugt die KI in der Standardsprache des Shops.

Zum Schlüssel: Der API-Key wird serverseitig gespeichert und nie an den Browser ausgeliefert. Über „Verbindung testen" lässt sich der Zugang direkt prüfen.

Bundle-Rabatt

Standardmäßig ausgeschaltet. Ist der Rabatt aktiv, wird er gewährt, sobald alle Produkte eines freigegebenen Sets im Warenkorb liegen. Im Warenkorb erscheint er als eigene Position und wird bei jeder Neuberechnung frisch ermittelt: fällt ein Produkt des Sets heraus, verschwindet der Rabatt automatisch.

Der Prozentsatz aus den Einstellungen gilt für alle Sets. Über „Bearbeiten" lässt sich je Set ein abweichender Wert setzen, der dann Vorrang hat.

Die Null ist entscheidend: Ein Set mit Wert null folgt immer dem globalen Rabattsatz - eine spätere Änderung dort wirkt sofort auf alle diese Sets. Nur ein KI-Vorschlag oder ein von Hand gesetzter Wert bindet einen eigenen Satz fest an das Set.
Jedes Produkt zählt nur für ein Set. Überschneiden sich zwei Sets, wird der Rabatt nicht doppelt gewährt.

Der Mindest-Setwert verhindert Rabatte auf Kleinstbestellungen. Mit Rabatt nach Set-Größe staffeln erhalten größere Sets mehr Rabatt, etwa fünf Prozent für zwei, acht für drei und zwölf ab vier Produkten. Die Staffel gilt nur für Sets ohne eigenen Prozentwert.

Mit Bundle-Name als Rabattname trägt die Rabattposition den Namen des Sets, etwa „Gartenset (-25 %)". So sieht der Kunde im Warenkorb, welches Set den Rabatt ausgelöst hat.

KI schlägt Rabatt vor

Mit dieser Einstellung vergibt die KI beim Erzeugen für jedes Set einen Rabattvorschlag. Grundlage sind die Passung der Produkte - sehr stimmige Sets brauchen nur einen kleinen Anreiz, lose passende einen größeren - und das Preisniveau des Sets, denn bei teuren Sets wirken schon wenige Prozent.

Der maximale KI-Rabatt deckelt den Vorschlag hart; mehr kann die KI nie vergeben. Der Wert landet als Prozentsatz am Set, ist im Prüf-Pool sichtbar und lässt sich über Bearbeiten jederzeit ändern. Bereits vorhandene Sets behalten ihren Wert.

Gewährt wird der Rabatt weiterhin nur, wenn der Bundle-Rabatt insgesamt eingeschaltet ist.

Rabatt-Diagnose

Über die Rabatt-Diagnose in den Einstellungen lässt sich prüfen, ob eine Kombination von Artikelnummern einen Rabatt auslösen würde. Die Prüfung läuft serverseitig durch exakt dieselbe Logik wie die Warenkorb-Berechnung.

Greift kein Rabatt, nennt sie den konkreten Grund: Schalter aus, Artikelnummer unbekannt, kein freigegebenes Set, fehlendes Set-Produkt oder Prozentwert null.

Automatisierung

Automatisch freigeben gibt Sets ab dem eingestellten Gesamtscore ohne manuelle Prüfung frei. Geplanter Lauf erzeugt über den geplanten Vorgang regelmäßig neue Sets.

Beim Erzeugen über die Administration zeigt ein Fenster den Fortschritt: verarbeitete Ankerprodukte, erzeugte Sets und per KI verworfene. Über Im Hintergrund weiterlaufen lassen geht der Lauf an die Nachrichtenwarteschlange - der Admin ist sofort wieder frei, eine schmale Leiste zeigt den Stand, und der Lauf läuft auch bei geschlossenem Browser weiter.

Der Lauf ist gegen Abbrüche abgesichert: schlägt ein Abschnitt fehl, versucht der Admin es mit wachsenden Pausen erneut, und nach einem Neuladen der Seite wird eine laufende Erzeugung selbständig wieder aufgenommen. Er arbeitet in Abschnitten und lässt sich jederzeit abbrechen - bereits erzeugte Sets bleiben erhalten.

Auf der Konsole: bin/console staw:product-bundles:generate --size=3 --per-product=2

Anzeige prüfen

Erscheint auf einer Produktseite kein Set, obwohl eines vorliegen müsste, beantwortet die Prüfung „Anzeige prüfen" das in einem Durchgang: Artikelnummer eingeben, und sie nennt die Sets, die auf dieser Seite erscheinen - und bei den übrigen den Grund, warum nicht.

Die Prüfung verwendet dieselbe Zuordnung wie die Storefront, einschließlich Varianten und gegenseitiger Zuweisung. Was sie anzeigt, ist also genau das, was der Kunde sieht.

Problemlösung

Es entstehen keine Sets: Meist fehlt Bestellhistorie. Senke die Mindestanzahl gemeinsamer Bestellungen oder aktiviere zusätzlich die Quelle Gemeinsame Kategorien.
Die Box erscheint nicht im Shop: Prüfe, ob die Sets freigegeben sind, ob die Anzeige im Storefront aktiv ist und ob die Position nicht auf „Nicht anzeigen" steht. Danach den Shop-Cache leeren.
Ein Set fehlt plötzlich: Ist „Unvollständige Bundles ausblenden" aktiv, verschwindet ein Set, sobald eines seiner Produkte nicht mehr verfügbar oder im Verkaufskanal nicht mehr sichtbar ist.
Der Rabatt greift nicht: Die Rabatt-Diagnose nennt den Grund in einem Durchgang - das erspart das Durchprobieren.

Support

Fragen und Wünsche gern direkt an uns - der Support kommt vom Entwickler, nicht aus einer Warteschleife. Über die Plugin Suite im Admin lässt sich zusätzlich ein Feature anfragen.

Verfügbarkeit

Direkt über Stone & Water

Ab sofort möglich

Monatlich12,99 €
Halbjährlich64,99 €16 % günstiger
Bester PreisJährlich115,99 €25 % günstiger

Alle Preise netto zzgl. USt.

Du kaufst die Lizenz direkt bei uns und bekommst eine Rechnung von uns. Installation per Upload im Admin ohne SSH, Updates über unsere Lizenzplattform, Support direkt vom Entwickler.

Direkt anfragen +49 2555 9997342

Shopware Store

In Vorbereitung

Das Plugin wird im offiziellen Shopware Community Store gelistet. Installation und automatische Updates laufen dann über den Plugin Manager im Backend, die Abrechnung über deinen Shopware-Account. Sobald verfügbar, verlinken wir es hier.