Handbuch KI Produktsuche.

Schaltet die KI-Suche für den gewählten Verkaufskanal ein oder aus.

Automatisch nutzt die KI nur bei Sätzen und bei Preis- oder Sortierwünschen. Immer KI übersetzt jede Suche, auch einzelne Wörter, Artikelnummern laufen weiter direkt. Das erzeugt mehr KI-Aufrufe.

Ab dieser Wortzahl gilt eine Anfrage im automatischen Modus als Satz und geht an die KI. Möglich sind 2 bis 8. Einzelne Wörter laufen im automatischen Modus immer über die klassische Suche. Sollen auch sie übersetzt werden, den Suchmodus auf Immer stellen.

So viele Produkttypen werden pro Anfrage höchstens getrennt gesucht.

Ein kleiner Aufruf pro Suche. Schnelle, günstige Modelle reichen völlig aus.

Wird nur für die Übersetzung der Suchanfrage verwendet.

Empfohlen sind die schnellen Modelle, größere Modelle bringen hier kaum Vorteile.

Antwortet das Modell nicht rechtzeitig, übernimmt der Rückfall.

Bei Ausfall oder Zeitüberschreitung werden Farbe, Größe, Preis und Sortierung ohne KI erkannt.

Übergibt die Namen von bis zu 80 Kategorien und 30 Eigenschaftsgruppen, damit die KI deine Begriffe nutzt. Keine Produkte, keine Preise. Erhöht die Tokens je Aufruf.

Gleiche Anfragen werden so lange ohne neuen KI-Aufruf beantwortet.

Die KI schlägt zu jeder gedeuteten Suche zwei bis vier weitere Suchbegriffe vor. Sie erscheinen im Modal über den Treffern, bei null Treffern stehen sie vor den Vorschlägen aus dem Wörterbuch. Kostet keinen zusätzlichen KI-Aufruf.

Ohne Anzeige oder mit KI-Badge bleibt die KI-Suche für alle Besucher an. Mit Schalter können Besucher sie selbst aus- und einschalten.

Gilt für Besucher, die den Schalter noch nicht benutzt haben.

Legt fest, ob die Eingabetaste die Suchergebnisseite öffnet oder im Modal sucht.

Abgeschaltet bleibt der Kunde im Modal, die Suchergebnisseite wird dann nicht mehr angeboten.

Zeigt im Suchfeld ein kleines Kreuz, sobald etwas eingetippt ist. Ein Klick leert die Eingabe, lässt den Fokus im Feld und zeigt wieder die Empfehlungen.

CSS-Auswahl der Elemente, die das Modal öffnen, etwa das Lupensymbol eines angepassten Themes. Mehrere durch Komma trennen. Leer lassen, wenn das normale Suchfeld im Kopfbereich genügt.

CSS-Auswahl des Suchformulars, falls das Theme nicht "form.header-search-form" nutzt. Ohne Treffer und mit gesetztem Auslöser legt das Plugin ein unsichtbares Ersatzformular an.

CSS-Auswahl der Elemente, die ausgeblendet werden, etwa das Suchfeld des Themes samt eigener Vorschlagsliste. Erst setzen, wenn der Auslöser funktioniert.

Blendet jedes Suchformular des Themes aus, auch solche, die erst später erscheinen, etwa in der mobilen Schublade. Das eigene Feld des Plugins bleibt sichtbar. Sinnvoll, wenn das Theme getrennte Suchfelder für Desktop und Mobil mitbringt.

Das Modal legt sich mit eigenem Suchfeld vollflächig über die Seite und blendet mit leichtem Weichzeichner ein und aus. Treffer erscheinen wie im Listing. Der Shopware-Standard bleibt das schmale Dropdown am Suchfeld.

Produktboxen wie im Listing oder eine kompakte Liste mit Bild, Name und Preis.

Die eigene Kachel kommt ohne Bausteine des Themes aus und sieht in jedem Shop gleich aus, dafür ohne Merkzettel und Direktkauf. Die Theme-Kacheln übernehmen das Aussehen deines Themes, können dort aber eigene Eigenheiten mitbringen.

Zeigt unter dem Preis einen Knopf "Zum Artikel". Die ganze Kachel ist ohnehin verlinkt, der Knopf macht es nur deutlicher.

Zeigt unter dem Preis, ob der Artikel auf Lager ist.

Desktop ab 1200 px, Tablet ab 768 px, Smartphone darunter. Die Liste zeigt auf dem Smartphone immer eine Spalte.

So viele Treffer zeigt die Live-Suche beim ersten Laden. Standard 12.

Zeigt in der Filterspalte der Live-Suche die passenden Kategorien mit Trefferzahl. Steht in der Liste unten eine eigene Auswahl, gilt diese.

Zeigt die passenden Hersteller mit Trefferzahl. Steht in der Liste unten eine eigene Auswahl, gilt diese.

Zeigt die Eigenschaften der aktuellen Treffer als Filter, etwa Farbe, Größe oder Material. Ohne eigene Liste erscheinen die häufigsten Gruppen.

Lege fest, welche Filter im Modal erscheinen, in welcher Reihenfolge und wie sie dargestellt werden. "Standardfilter einsetzen" legt Kategorie, Hersteller, Preis und Rabatt an. Regler und Von/Bis-Felder stehen für Eigenschaften mit Zahlen zur Verfügung, etwa Größe oder Gewicht. Ohne Auswahl entscheidet das Plugin.

Zeigt einen Regler für die Preisspanne der aktuellen Treffer. Steht in der Liste unten eine eigene Auswahl, gilt diese.

Zeigt hinter jedem Filterwert, wie viele Treffer er liefert. Gezählt werden Kacheln wie in der Trefferzahl oben, also Artikel mit ihren Varianten als eine Kachel. Erscheinen Varianten einzeln, werden Varianten gezählt. Aus: Die Filterspalte zeigt nur die Werte, das Modal zeigt ohnehin nur Werte mit Treffern.

Zeigt in der Filterspalte die Gruppe "Rabatt" mit "Reduziert", "ab 20 %", "ab 30 %" und "ab 50 %", jeweils mit Anzahl. Es erscheinen nur Stufen mit Treffern. Gerechnet wird mit dem günstigsten Preis wie bei Shopware, also mit Preisregeln und Währung.

Legt fest, ob der Rabattfilter Staffelpreise einrechnet. Nicht berücksichtigen: gefiltert wird nach dem Rabatt des Standardpreises ab einem Stück, so wie die Kachel ihn mit Streichpreis zeigt. Berücksichtigen mit Hinweis: gefiltert wird nach dem günstigsten Preis einschließlich Staffeln, hinter dem Preis erscheint dann ein "i", das beim Überfahren die Staffelpreise zeigt.

Zeigt oben rechts im Modal die Sortierungen des Shops, etwa Relevanz oder Preis.

Zeigt unter dem Preis den Grundpreis, etwa "(2,08 € / 1 Stück)", sowie den Streichpreis, wenn gepflegt. Betrifft die Karten in der Live-Suche.

Reduzierte Artikel zeigen den Sonderpreis zusammen mit dem durchgestrichenen Vorherpreis und der Ersparnis. Bei Ab-Preisen entfällt der Streichpreis, wie im Shopware-Listing. Die Kacheln des Themes zeigen Streichpreise ohnehin.

Reduzierte Artikel zeigen oben rechts im Bild den Nachlass in Prozent, etwa 13%. Bei Ab-Preisen entfällt er, wie im Shopware-Listing. Gilt für die eigene Kachel, die Kacheln des Themes bringen ihr eigenes Badge mit.

Hintergrundfarbe des Badges als Hexwert, etwa #1f2328. Zusammen mit der Schriftfarbe so wählen, dass die Prozentzahl gut lesbar bleibt.

Farbe der Prozentzahl im Badge als Hexwert, etwa #ffffff für Weiß.

Zeigt passende Kategorien als anklickbare Vorschläge über der Trefferliste, etwa die Zubehör-Kategorie einer Marke, wenn der Markenname eingegeben wird. Ein Klick grenzt die Treffer auf diese Kategorie ein.

Bestimmt, wie die Filterspalte auf schmalen Bildschirmen erscheint. Auf dem Desktop bleibt sie immer links neben den Treffern.

Lädt beim Scrollen im Modal automatisch die nächsten Treffer nach, bis zu 120 Produkte.

So viele Produkte kommen beim Scrollen jeweils dazu. 1 bis 48, Standard 12. Unabhängig von "Anzahl Produkte" für die erste Ladung.

Danach endet das Nachladen und der Kunde wechselt über "Alle Suchergebnisse anzeigen" auf die Suchseite. 12 bis 600, Standard 120.

Zeigt nach etwas Scrollen unten rechts einen Button, der zurück an den Anfang der Treffer springt.

Lädt die nächste Seite und die naheliegenden Filter schon vor dem Klick, das Modal reagiert dadurch sofort. Auf stark besuchten Shops erzeugt das zusätzliche Anfragen, dann lohnt sich das Abschalten.

Sparsam lädt nur die naheliegenden Filter vor. Alle sichtbaren Werte macht jeden Klick auf Farbe, Kategorie oder Hersteller sofort, erzeugt aber mehr Anfragen. Die Aufrufe laufen gestaffelt, damit der Shop nicht alles auf einmal abbekommt.

So lange wartet die Live-Suche nach dem letzten Tastendruck, bevor sie fragt. 0 bis 1000, Standard 150. Höhere Werte sparen spürbar Anfragen, 250 bis 300 fühlt sich noch flüssig an.

Die Live-Suche ruft nie die KI auf, sondern nutzt die Stichwort-Erkennung oder gemerkte Ergebnisse.

Nach einer kurzen Tipp-Pause übersetzt die KI ganze Sätze bereits im Modal, die Suchseite danach kommt ohne Wartezeit. Erzeugt zusätzliche KI-Aufrufe, je Besucher auf 40 in zehn Minuten begrenzt.

So lange muss die Eingabe ruhen, bevor die KI gefragt wird. 300 bis 3000, Standard 700.

Öffnet das Modal schon beim Klick ins Suchfeld, auf Wunsch gleich mit Empfehlungen und beliebten Suchen. Leer spart eine Anfrage, Inhalte erscheinen dann erst beim Tippen.

Woher die Produkte kommen, die beim Öffnen und bei einer Suche ohne Treffer erscheinen.

Ein Vorschlag pro Zeile, erscheint als klickbarer Begriff. Gerne auch ganze Sätze, die zeigen, was die KI-Suche kann.

Ergänzt bis zu acht Anfragen aus dem Suchprotokoll, die mindestens zweimal gesucht wurden, Treffer hatten und bei denen mindestens einmal ein Ergebnis angeklickt wurde. Sie sind für alle Besucher sichtbar.

Anfragen, die einen dieser Begriffe enthalten, erscheinen nie als beliebte Suche. Ein Begriff pro Zeile.

Legt fest, was ein Klick auf einen Begriff unter "Beliebte Suchen" auslöst.

Zeigt Produkte in der gewählten Sortierung, Ansicht und Produkte je Reihe wie oben.

So viele Produkte zeigt das Modal, solange noch nichts eingegeben ist. 1 bis 30, Standard 10.

Jede Kachel zeigt den Stammartikel statt einer Variante. Einzelartikel ohne Varianten bleiben unberührt. Solange das an ist, greifen die Variantenzuordnung und das Auftrennen beim Filtern nicht.

Bleibt eine Variante als Kachel stehen, weil der Stammartikel im Verkaufskanal nicht sichtbar ist, erscheint trotzdem der Name des Stammartikels.

Statt einer Kachel je Produkt erscheint jede Variante als eigener Treffer. Getrennt wählbar für die Live-Suche und die Suchseite. Achtung: Die Trefferzahl steigt dadurch deutlich.

Werden Varianten einzeln gezeigt, steht der Stammartikel als eigene Kachel vor seinen Varianten. Gilt auch, wenn beim Filtern aufgefächert wird. Die Trefferzahl zählt ihn mit.

Trifft die Suche einen Artikel mit Varianten, erscheinen auch seine übrigen Varianten als eigene Kacheln direkt hinter dem Treffer, etwa weitere Farben oder Größen. Nicht sichtbare Varianten und ausverkaufte Abverkaufsartikel bleiben außen vor. Die Trefferzahl zählt sie mit.

Begrenzt die zusätzlichen Varianten je Artikel, damit Artikel mit sehr vielen Farbtönen die Liste nicht füllen. Möglich sind 1 bis 50.

Was erscheint, wenn nach Farbe, Größe oder einer anderen Eigenschaft gefiltert wird oder das Merkmal im Suchbegriff steht. Bei allen passenden Varianten taucht ein Artikel in Rot und Gelb bei beiden gewählten Farben zweimal auf.

Jede Variante, die als eigene Kachel erscheint, zeigt ihr eigenes Bild, sofern eines hinterlegt ist. Das gilt, egal ob sie über Varianten einzeln zeigen, beim Filtern oder als weitere Variante eines gefundenen Artikels dazukommt. Ohne eigenes Bild bleibt das Hauptbild stehen.

Die Kachel zeigt einen festen Preis statt eines Ab-Preises: bei Nur Stammartikel den Preis aus den Stammdaten, sonst den Preis der Variante. Staffelpreise und die Preisspanne der Varianten bleiben außen vor.

Zeigt die Übersetzung auf der Suchseite und macht jeden Baustein per Klick entfernbar.

Zeigt in den Suchergebnissen einen Kategorie-Filter mit Trefferzahlen und Suchfeld. Shopware bietet dort sonst nur Hersteller, Preis, Bewertung und Eigenschaften.

So viele Kategorien zeigt der Filter, sortiert nach Trefferzahl. 3 bis 100, Standard 20.

Welche Kategorien der Filter zeigt. Übergeordnete zuerst: nach Trefferzahl, Hauptkategorien stehen oben. Nur unterste: nur die tiefsten Kategorien der Treffer, etwa "Mädchen" statt "Tapeten". Gilt für die Filterspalte, die Schnellfilter und die Suchseite. Gewählte Kategorien bleiben immer sichtbar.

Zeigt die häufigsten Kategorien der aktuellen Suche als anklickbare Schaltflächen über der Trefferliste.

Gilt für die Schnellfilter über den Treffern und für die Werte je Gruppe in der Filterspalte des Modals. 1 bis 12, Standard 6.

Wie viele Merkmalsgruppen die Filterspalte ohne eigene Reihenfolge zeigt, die häufigsten zuerst. Gruppen, bei denen in Shopware "In Produktfiltern anzeigen" aus ist, erscheinen nicht. Für feste Gruppen wie Farbe die Reihenfolge unter "Filter und Reihenfolge" pflegen.

Nennt der Kunde eine Kategorie, werden die Treffer darauf eingeschränkt.

Gilt für alle Eigenschaften, solange in der Filterliste nichts anderes steht. Bei ODER genügt einer der gewählten Werte, bei UND muss ein Produkt alle haben. Je Gruppe lässt sich das in der Filterliste überschreiben.

Enthält der Suchbegriff neben dem eigentlichen Suchwort den Namen eines Merkmalswerts, etwa eine Farbe oder eine Größe, wird daraus ein Filter. Dann erscheinen nur Artikel mit diesem Merkmal, die Zählwerte stimmen dazu und die Kachel zeigt die passende Variante. Besteht die Suche nur aus dem Merkmal, wird nicht gefiltert, damit auch Artikel erscheinen, die das Wort nur im Namen tragen. Ein vom Kunden gesetzter Filter hat Vorrang.

Erkennt auch Farben und Größen, die nur als Varianten-Merkmale genutzt werden und deren Gruppe nicht als filterbar markiert ist. Shopware zeigt dann die passende Variante statt des Hauptprodukts.

Produkte dieser Hersteller stehen bei gleicher Passung weiter oben. Gefiltert wird nichts, andere Hersteller bleiben in der Liste. Wirkt bei der Sortierung nach Relevanz, auf der Suchseite wie in der Live-Suche.

1 schiebt leicht nach oben, 10 stellt die Hersteller fast immer voran. Standard 3.

Links der Begriff aus deinem Shop, rechts die Wörter deiner Kunden, durch Kommas getrennt. Mit dem Testfeld prüfst du, welches Wort ersetzt wird.

Findet die Suche keinen Treffer, wird zusätzlich direkt im Artikelnamen gesucht. Das hilft bei langen Namen, deren einzelne Wörter der Suchindex von Shopware nicht kennt. Jedes eingegebene Wort muss im Namen vorkommen.

So viele Begriffe erscheinen als anklickbare Vorschläge, wenn eine Suche nichts findet. 1 bis 12, Standard 6.

Findet die Suche nichts, gleicht das Plugin jedes Wort mit dem Suchwortschatz des Shops ab und wiederholt die Suche mit der richtigen Schreibweise. Ein Hinweis über den Treffern sagt das dem Kunden.

Danach arbeitet die Suche bis Mitternacht mit der Stichwort-Erkennung. 0 bedeutet kein Limit.

Höchstzahl an KI-Aufrufen je Besucher in zehn Minuten, Suchseite und Live-Suche zusammen. 0 bedeutet kein Limit.

Suchmaschinen, Crawler und Skripte bekommen die Stichwort-Erkennung, damit sie keine KI-Kosten verursachen.

Antwortet die KI nicht so schnell, zeigt die Suchseite das Ergebnis der Stichwort-Erkennung und die KI rechnet im Hintergrund zu Ende. 500 bis 10000, Standard 1500.

Optional, für die Kostenschätzung in der Übersicht. Den Preis findest du beim KI-Anbieter.

Optional, für die Kostenschätzung in der Übersicht.

Gibt die Antworten der Live-Suche für den HTTP-Cache frei. Shopware lässt diese Route sonst immer durch, jede Eingabe kostet dann eine volle Abfrage. Gleiche Suchen kommen damit ohne Datenbank aus.

Obergrenze für eine gespeicherte Antwort. 30 bis 604800 Sekunden, Standard 86400, also ein Tag. Ändern sich Produkte, Preise oder Bestände, verwirft Shopware die betroffenen Antworten ohnehin sofort, ebenso beim Leeren des Zwischenspeichers. Ein langer Wert ist deshalb unbedenklich und spart am meisten Last.

So lange behält der Browser des Besuchers eine Antwort. Damit entfällt die Anfrage beim nächsten Seitenaufruf, etwa wenn derselbe Filter erneut überfahren wird. 0 bis 300, Standard 60. Der Wert gilt nur für diesen einen Besucher, 0 schaltet es ab.

Bestimmt, was vorgewärmt wird: die häufigsten Suchbegriffe der Kunden aus dem Protokoll, für die häufigsten davon auch die Zwischenstufen beim Tippen ("fas", "fass" usw.), dazu Kategorien und Hersteller des Kanals und Kombinationen mit Merkmalen. "Alles" kann bei großen Sortimenten einige Zeit laufen.

Ruft die häufigsten Suchbegriffe, die Kategorienamen und dieselben Suchen mit allen angelegten Merkmalsgruppen als Filter auf, etwa Farbe, Größe oder Material. Danach liegen die gängigen Antworten im Zwischenspeicher.

Wärmt den Zwischenspeicher im gewählten Takt selbstständig vor, ohne Klick im Modul. Nach dem Leeren des Zwischenspeichers startet der nächste Lauf sofort, statt auf den Takt zu warten. Läuft über die geplanten Aufgaben von Shopware, dafür muss der Worker aktiv sein.

Wird der Cache geleert, etwa über "Caches leeren", nach einem Update oder beim Neubau des Themes, sind alle vorgewärmten Antworten weg. Mit dieser Option erkennt das Plugin das innerhalb von fünf Minuten und wärmt von selbst neu vor. Braucht einen laufenden Hintergrund-Worker für geplante Aufgaben.

Die Suche nutzt einen eigenen Index statt der Volltextsuche von Shopware. Er findet Wortanfänge und Wortteile, also auch Begriffe innerhalb zusammengesetzter Wörter, dazu Nummern, Hersteller und Variantenmerkmale. Synonyme gelten in beide Richtungen, Tippfehler werden verziehen. Wird ein Artikel gespeichert oder importiert, werden nur seine Einträge erneuert. Nach einem Update baut die Pflegeaufgabe den Index im Hintergrund auf, bis dahin sucht Shopware wie bisher. Mit dem Knopf geht es sofort.

Nimmt die Eigenschaften der Artikel in den Suchindex auf, eigene oder vom Stammartikel geerbte, etwa Farbe, Material oder Art. Sie finden den Artikel, ranken aber hinter Name, Nummer und Hersteller. Nach dem Ein- oder Ausschalten einmal "Index aufbauen" drücken.

Nimmt die Wörter der Produktbeschreibung in den Suchindex auf, höchstens 200 je Artikel und ab vier Buchstaben. Treffer über die Beschreibung stehen hinter Treffern über Name, Nummer und Hersteller. Der Index wird dadurch größer. Nach dem Ein- oder Ausschalten einmal "Index aufbauen" drücken.

So viele Artikel liefert eine Suche höchstens, die am besten passenden zuerst. Über diese Artikel rechnen auch Trefferzahl und Filter. Mehr Treffer machen breite Suchen vollständiger, aber etwas langsamer. Standard 3.000, möglich 500 bis 10.000.

Fertige Antworten der Live-Suche werden in einer eigenen Tabelle gespeichert, unabhängig vom Cache von Shopware. "Cache leeren", Updates und der Neubau des Themes lassen sie stehen. Ändert sich ein Artikel, fallen nur die Antworten weg, in denen er vorkommt, und werden neu vorgewärmt. Bestellungen verwerfen nichts. Gilt bei eingeschaltetem Zwischenspeichern der Live-Suche.

Die Merkmalsfilter der Kategorieseiten kommen aus einer eigenen, vorbereiteten Tabelle statt aus der Zählung von Shopware über alle Varianten. Das beschleunigt vor allem Filterklicks in großen Kategorien. Nach dem Einschalten einmal "Index aufbauen" drücken, danach wird die Tabelle mit dem Suchindex je Artikel aktuell gehalten. Kategorien mit dynamischen Produktgruppen sowie gesetzte Preis-, Bewertungs- oder Versandfilter rechnet weiter Shopware.

Schreibt den Suchindex im eingestellten Takt komplett neu, als Absicherung zusätzlich zur laufenden Aktualisierung einzelner Artikel. Die Suche läuft währenddessen weiter.

So oft läuft die Pflege. 1 bis 168, Standard 24. Die Aufgabe selbst meldet sich stündlich und prüft nur, ob der Takt erreicht ist.

Speichert übersetzte Anfragen für Übersicht und Auswertung.

Erfasst, welches Produkt nach einer Suche angeklickt wird und an welcher Position. Gespeichert werden nur Suchbegriff, Produkt und Position, keine personenbezogenen Daten.

Ältere Einträge werden automatisch gelöscht.