Topdata Enhanced Search SW6 Benutzerhandbuch
Ăberblick
Topdata Enhanced Search SW6 ersetzt die einfache Suchergebnisliste im Storefront durch ein Such-Overlay, das schon wĂ€hrend der Eingabe antwortet. Das Overlay gruppiert die Treffer in Produkte, Kategorien, Hersteller, Verbrauchsmaterial-GerĂ€te und kuratierte SuchvorschlĂ€ge und zeigt zu jedem Vorschlag, wie viele Produkte er finden wĂŒrde.
DarĂŒber hinaus liefert das Plugin die Werkzeuge, die fĂŒr eine hohe SuchqualitĂ€t nötig sind: Es protokolliert, wonach Ihre Kunden tatsĂ€chlich suchen, gewinnt wiederkehrende Phrasen aus Ihren Produkttiteln, schlĂ€gt Synonyme fĂŒr Begriffe ohne Treffer vor und lĂ€sst Sie diese VorschlĂ€ge im Administration genehmigen oder verwerfen.
Hauptmerkmale
- Such-Overlay mit konfigurierbaren Bereichen: Produkte, Kategorien, Hersteller, Verbrauchsmaterial-GerÀte, SuchvorschlÀge und letzte Suchanfragen
- SuchvorschlĂ€ge aus Produkttiteln â Phrasen, die mehrere Produkte teilen, werden zu VorschlĂ€gen und erhalten eine zwischengespeicherte Produktanzahl
- Synonyme mit Boost-Stufe je Regel, pflegbar im Administration oder per Text-/CSV-Import und -Export
- Synonym-VorschlÀge aus Ihrer eigenen Suchanalyse: titel-geminte Phrasen,
PrÀfix-Familien von Hersteller-Artikelnummern (z. B.
TN 247âTN-247), eine LLM-Strategie und eine Thesaurus-Strategie - Optionale KI-Bewertung (Jev), die VorschlĂ€ge vorab als genehmigt, ungewiss oder verworfen einstuft â zuerst im Kalibrierungsmodus, aktiv erst nach dem Umschalten
- Suchanalysen je Storefront-Sprache, mit Suchprotokoll, stĂŒndlicher Statistik, Erkennung von Störbegriffen und CSV-Export
- Suchausschluss nach Kategorie sowie eine Filter-Map, die bestimmte Produkte aus den Ergebnissen zu einem Suchbegriff entfernt
- Theme-fĂ€hig: Alle Farben sind CSS-Custom-Properties, ein Theme kann das Overlay daher ohne Plugin-Ănderung umgestalten
Einstieg
- Richten Sie das Plugin nach dem Installationshandbuch ein und bauen Sie den Suchindex neu auf.
- Passen Sie das Overlay ĂŒber den Einstellungsleitfaden an.
- Erfahren Sie in der Bedienungsanleitung, wie Kunden die Suche nutzen und wie Sie Synonyme pflegen.
- Wenn etwas nicht wie erwartet funktioniert, sehen Sie in der FAQ & Fehlerbehebung nach.
Support
FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.
Topdata Enhanced Search SW6 Installationshandbuch
Systemanforderungen
- Shopware 6.7 (mit Elasticsearch/OpenSearch, wie von Shopware selbst vorausgesetzt)
- PHP-Version gemÀà den Anforderungen von Shopware 6.7 sowie die Erweiterung
ext-pdo - Die Plugins
topdata/topdata-foundation-sw6(>= 1.6.0) undtopdata/topdata-top-finder-pro(>= 8.4.0)
Installationsschritte
1. Installation ĂŒber Composer
composer require topdata/enhanced-search-sw6
Die benötigten Topdata-Plugins werden automatisch mit installiert.
2. Aktivieren des Plugins
Option A: Ăber das Shopware-Admin-Panel
- Melden Sie sich in Ihrem Shopware-Admin-Panel an.
- Wechseln Sie zu Erweiterungen > Meine Erweiterungen.
- Suchen Sie âTopdata Enhanced Search SW6â in der Liste.
- Klicken Sie auf Aktivieren.
Option B: Ăber die Befehlszeile
bin/console plugin:install --activate TopdataEnhancedSearchSW6
3. Suchindex neu aufbauen
Das Plugin erweitert die Index-Definition von Shopware, daher ist nach der Installation ein vollstÀndiger Neuaufbau des Suchindex erforderlich:
bin/console es:index
Bei einem groĂen Katalog kann dies mehrere Minuten dauern. Der Schritt darf nicht ĂŒbersprungen werden â ohne Neuaufbau sind die Suchregeln des Plugins nicht aktiv.
4. Cache leeren
bin/console cache:clear
ĂberprĂŒfung
- Ăffnen Sie den Storefront und geben Sie mindestens zwei Zeichen in das Suchfeld ein: Das Such-Overlay öffnet sich unterhalb des Suchfeldes mit mindestens einem Bereich.
- Ăffnen Sie im Administration Topdata Enhanced Search: Die Seiten Synonyme, SuchvorschlĂ€ge, Suchprotokoll und Suchstatistik stehen zur VerfĂŒgung.
Optional: KI-Funktionen
Die Strategien mit einem Sprachmodell und die KI-Bewertung der Synonym-VorschlÀge benötigen
zusÀtzlich das Plugin topdata/llm-connect-sw6 mit einem dort hinterlegten API-Zugang. Der
Status wird in den Plugin-Einstellungen angezeigt (Synonym-VorschlÀge >
LLM-Provider-Status). Ohne dieses Plugin werden die LLM-Strategien ĂŒbersprungen, alles
Weitere funktioniert weiterhin.
Fehlerbehebung
Das Such-Overlay erscheint nicht
- PrĂŒfen Sie, ob das Plugin aktiv ist:
bin/console plugin:list. - Bauen Sie den Index neu auf:
bin/console es:index. - PrĂŒfen Sie, ob Ihr Theme nicht das originale Suchformular entfernt â das Overlay bindet sich an das Suchfeld im Storefront.
Viele Suchbegriffe liefern direkt nach der Installation kein Ergebnis
KĂŒrzlich aktivierte Produkte fehlen im Index, bis er neu aufgebaut wurde. FĂŒhren Sie
bin/console es:index aus.
Die Installation schlÀgt wegen einer fehlenden Tabelle fehl
Die Migrationen legen die eigenen Tabellen des Plugins an (tdes_*). Entfernen Sie diese
niemals manuell. Wurde eine Installation unterbrochen, deaktivieren Sie das Plugin, aktivieren
Sie es erneut und leeren Sie anschlieĂend den Cache.
Topdata Enhanced Search SW6 Einstellungsleitfaden
Dieser Leitfaden listet alle Konfigurationsoptionen des Plugins, gruppiert nach den Karten der
Plugin-Einstellungen (Topdata Enhanced Search > Einstellungen). In der ersten Spalte steht
der rohe KonfigurationsschlĂŒssel, sodass Sie den Wert alternativ auch in der config.php setzen können.
Topdata
Die erste Karte zeigt nur das Topdata-Banner mit einem Link auf dieses Handbuch. Sie enthÀlt keine eigenen Einstellungen.
Layout
Legt fest, wie viele EintrÀge jeder Bereich des Overlays anzeigt und wie die Bereiche angeordnet sind.
| Setting | Default | Description |
|---|---|---|
searchLayout | vertical-accordion | Suchlayout |
maxProducts | 5 | Max. Produkte |
maxCategories | 5 | Max. Kategorien |
maxManufacturers | 3 | Max. Hersteller |
emptyBrandHandling | show_all | Marken ohne Produkte â Leere Marken (0 aktive, nach Kategorie-Ausschluss zĂ€hlbare Produkte) im Marken-Vorschlag der Suche ausblenden oder ausgrauen. |
maxConsumables | 3 | Max. Verbrauchsmaterial-GerÀte |
maxSuggestions | 5 | Max. SuchvorschlÀge |
Visibility
Schaltet einzelne Bereiche des Overlays ein oder aus und konfiguriert die Produktkarten.
| Setting | Default | Description |
|---|---|---|
showProductsSection | true | Produkte anzeigen |
skuDisplayMode | hide | SKU-Anzeige |
enableTermHighlighting | true | Suchbegriff-Hervorhebung aktivieren |
showCategoriesSection | true | Kategorien anzeigen |
showManufacturersSection | true | Hersteller anzeigen |
showConsumablesSection | true | Verbrauchsmaterial anzeigen |
showSearchHistorySection | true | Letzte Suchanfragen anzeigen |
showSuggestionsSection | true | SuchvorschlÀge anzeigen |
Hinweise
skuDisplayMode â Steuert, ob und wie die Artikelnummer (SKU) in den Produktkarten des Such-Overlays angezeigt wird. âEigene Zeileâ zeigt die SKU unter Name/Untertitel, âVor/Nach der Untertitel-Zeileâ fĂŒgt sie in die vorhandene Untertitel-Zeile ein. Die Farbe ist ĂŒber die CSS-Klasse âtdes-product-list__skuâ anpassbar.
enableTermHighlighting â Hebt den eingegebenen Suchbegriff in den Treffern des Such-Overlays hervor (Produktnamen, Untertitel, SKUs, Vorschlags-/Kategorie-/Herstellernamen und Kategorie-Breadcrumbs). Die Farbe ist ĂŒber die CSS-Variablen ââtdes-color-highlight-*â bzw. die Klasse âtdes-highlightâ theme-bar.
Suchausschluss
Blendet Produkte aus der Storefront-Suche aus.
| Setting | Default | Description |
|---|---|---|
excludedCategories | â | Von der Suche ausgeschlossene Kategorien â Produkte, die diesen Kategorien zugeordnet sind, werden nicht ĂŒber die Storefront-Suche gefunden. |
excludeOnlyMainCategory | false | Nur Produkte ausschlieĂen, deren Hauptkategorie ausgeschlossen ist |
Hinweise
excludeOnlyMainCategory â Wenn aktiviert, wird ein Produkt nur dann aus der Suche ausgeblendet, wenn eine ausgeschlossene Kategorie seine Hauptkategorie ist. Produkte, die einer ausgeschlossenen Kategorie nur als Nebenkategorie zugeordnet sind, bleiben auffindbar.
Suchverhalten
Stellt ein, wie tolerant die Produktsuche gegenĂŒber Schreibweisen ist.
| Setting | Default | Description |
|---|---|---|
disableFuzzySearch | false | Fuzzy-Suche deaktivieren |
Hinweise
disableFuzzySearch â Deaktiviert den Fuzziness-Parameter (AUTO:3,8) in Produkt-Suchanfragen. Verhindert Fast-Treffer (z. B. âToilettenâ matcht âTablettenâ), entfernt aber auch die Fuzzy-Tippfehlertoleranz. Exakte, PrĂ€fix- und Edge-Ngram-Treffer bleiben aktiv.
Kategorie-VorschlÀge
Konfiguriert die Darstellung der passenden Kategorien im Overlay.
| Setting | Default | Description |
|---|---|---|
categorySuggestLayout | above | Anzeige-Layout der Kategorien in der Suchvorschau â WĂ€hlen Sie, ob passende Kategorien ĂŒber den Produkten oder links daneben angezeigt werden. |
categorySuggestLimit | 8 | Maximale Anzahl Kategorie-VorschlĂ€ge â Wie viele passende Kategorien in der Suchvorschau angezeigt werden. |
categoryBreadcrumbHideRoot | true | Root-Kategorie im Breadcrumb ausblenden â Entfernt das erste (Root-)Element aus den Kategorie-Breadcrumbs im Such-Overlay, z. B. âHygiene âș PapierhandtĂŒcher & Spenderâ statt âFocus Shop âș Hygiene âș PapierhandtĂŒcher & Spenderâ. |
categoryBreadcrumbMaxParts | 3 | Maximale Breadcrumb-Teile vor mittiger KĂŒrzung â Hat ein Kategorie-Breadcrumb mehr als diese Anzahl durch â âș â getrennter Teile, zeigt das Such-Overlay nur den ersten und letzten Teil, verbunden mit â ⊠â. |
Suchanalysen
Steuert, ob Suchbegriffe protokolliert und konsolidiert werden.
| Setting | Default | Description |
|---|---|---|
enabled | true | Suchbegriff-Logging aktivieren |
autoConsolidate | true | Automatische Konsolidierung ĂŒber geplante Aufgabe aktivieren â Konsolidiert die rohen Suchprotokoll-EintrĂ€ge stĂŒndlich in die Suchstatistik-Tabelle. Wenn deaktiviert, können Sie weiterhin âtopdata:enhanced-search:consolidate-search-logsâ manuell ausfĂŒhren. |
Synonym-VorschlÀge
Kosten und Verhalten der automatischen Synonym-Vorschlagsstrategien.
| Setting | Default | Description |
|---|---|---|
maxSuggestionsPerRun | 50 | Max VorschlĂ€ge pro Durchlauf â Sicherheitslimit fĂŒr gespeicherte VorschlĂ€ge pro Durchlauf. Kandidatenbegriffe ohne Vorschlag verbrauchen kein Kontingent. |
maxTermsPerRun | 10 | Begriffe pro Strategie und Durchlauf (FenstergröĂe) |
fuzzyMaxEditsShort | 2 | Max Levenshtein-Ănderungen (kurze Begriffe <=6 Zeichen) |
fuzzyMaxEditsLong | 3 | Max Levenshtein-Ănderungen (lange Begriffe >6 Zeichen) |
highZeroCountThreshold | 3 | Schwellenwert fĂŒr hohe Null-Ergebnisse |
enabledStrategies | TITLE_MINED,MPN_PREFIX_FAMILY,LLM,THESAURUS_THEN_LLM_FILTER | Aktivierte Vorschlags-Strategien (in AusfĂŒhrungsreihenfolge) |
mpnPrefixFamilyMinMembers | 2 | Min. Varianten fĂŒr eine MPN-PrĂ€fix-Familie |
llmProviderNotice | â | LLM-Provider-Status |
llmModelIdentifier | â | LLM-Modell |
llmBatchSize | 5 | LLM Batch-GröĂe (Begriffe pro Aufruf) â Wie viele Null-Ergebnis-Begriffe pro Chat-Request an das LLM gesendet werden. |
llmPoolSize | 50 | LLM Ziel-Pool-GröĂe â Wie viele erfolgreiche Begriffe derselben Sprache dem LLM als gĂŒltige Ziel-Kandidaten angeboten werden. |
Hinweise
maxTermsPerRun â Jeder Durchlauf verarbeitet die Vereinigung der N meistgesuchten offenen Begriffe, die jede aktivierte Strategie beisteuert (pro Lauf ĂŒberschreibbar mit âmax-terms). Dies ist der wichtigste Kostenfaktor: Die Laufzeit wird von der teuersten aktivierten Strategie bestimmt.
enabledStrategies â Kommagetrennte Liste der Strategie-Keys in AUSFĂHRUNGSREIHENFOLGE, gĂŒnstigste zuerst: TITLE_MINED, MPN_PREFIX_FAMILY, HEURISTIC, LLM, THESAURUS_THEN_LLM_FILTER. Die Reihenfolge bestimmt, welche Strategie zuerst lĂ€uft â es gibt keine versteckte PrioritĂ€t. TITLE_MINED bildet Null-Ergebnis-Begriffe auf titel-geminte Katalog-Phrasen ab und ist gĂŒnstig; zuerst search-suggestion:generate-from-titles ausfĂŒhren. MPN_PREFIX_FAMILY erkennt PrĂ€fix-Familien von Kartuschen/Tonern in den Hersteller-Artikelnummern und schlĂ€gt kanonische Basis-Synonyme vor (z. B. âTN 247â -> âTN-247â). Die HEURISTIC-Strategie nutzt Levenshtein-AbstĂ€nde und produziert oft semantisch falsche VorschlĂ€ge â nur aktivieren, wenn die Markierung von Begriffen mit vielen Null-Ergebnissen benötigt wird. LLM bildet Null-Ergebnis-Begriffe auf erfolgreiche Begriffe ab; THESAURUS_THEN_LLM_FILTER ist die teuerste (LLM-kuratierte Thesaurus-)Strategie und sollte zuletzt laufen.
mpnPrefixFamilyMinMembers â Mindestanzahl an Hersteller-Artikelnummern mit gemeinsamer PrĂ€fix-Basis, bevor die MPN_PREFIX_FAMILY-Strategie sie als Familie behandelt, z. B. TN-247, TN-247M, TN-247BK = 3. Familien verwandeln Null-Ergebnis-Suchen mit Formatierungsvarianten (âTN 247â) in Synonym-VorschlĂ€ge fĂŒr die kanonische Basis (âTN-247â).
llmModelIdentifier â Chat-Modell fĂŒr die Strategien âLLMâ und externe API. AuswĂ€hlbar sind nur Chat-Modelle. Leer lassen, um ĂŒber die LLM-Router-Purpose-Kette aufzulösen. Gespeichert wird ein Verweis auf das LLM-Connect-Modell; der Provider wird daraus abgeleitet und kann daher nicht verwechselt werden.
SuchvorschlÀge aus Produkttiteln
Regeln fĂŒr das Gewinnen wiederkehrender Phrasen aus Ihren Produkttiteln.
| Setting | Default | Description |
|---|---|---|
suggestionMiningMinProducts | 3 | Mindestanzahl Produkte pro Phrase â Eine Titel-Phrase wird nur dann zum Suchvorschlag, wenn sie von mindestens so vielen verschiedenen aktiven Produkten geteilt wird. Pro Lauf ĂŒberschreibbar mit âmin-products. |
suggestionMiningMaxWords | 4 | Maximale Wörter pro Phrase â Es werden nur Titel-Phrasen bis zu dieser Anzahl kanonischer Tokens berĂŒcksichtigt (MaĂe zĂ€hlen als ein Token, z. B. â120x60x60â). Pro Lauf ĂŒberschreibbar mit âmax-words. |
suggestionMiningIncludeMidTitle | true | Phrasen aus dem gesamten Titel einbeziehen |
suggestionMiningLimit | 0 | Sicherheitslimit pro Sprachgruppe (0 = kein Limit) â Optionales Sicherheitslimit, sortiert nach der Anzahl der Produkte, die sich die Phrase teilen. Bei 0 entscheidet allein die Regel âMindestanzahl Produkte pro Phraseâ. Pro Lauf ĂŒberschreibbar mit âlimit (0 = kein Limit). |
suggestionMiningLanguage | â | Sprachfilter (leer = alle) â BeschrĂ€nkt die Generierung auf eine Storefront-Sprachgruppe. de und gsw sind dieselbe Gruppe. Pro Lauf ĂŒberschreibbar mit âlanguage. |
suggestionMiningTargetQuery | order=topseller | Query-String fĂŒr generierte Such-URLs â Wird beim Klick auf einen generierten Vorschlag an /search?search= |
Hinweise
suggestionMiningIncludeMidTitle â Es werden auch mehrwortige Phrasen ĂŒberall im Produkttitel erfasst, z. B. âWC-Papierâ aus âHAKLE WC-Papier âŠâ. Einzelne Wörter werden nur am Titelanfang erfasst. Ausschalten stellt das reine PrĂ€fix-Mining wieder her. Pro Lauf ĂŒberschreibbar mit âprefix-only.
Synonym-VorschlÀge banding (Jev)
Optionale KI-Vorklassifizierung offener Synonym-VorschlÀge. Benötigt topdata/llm-connect-sw6.
| Setting | Default | Description |
|---|---|---|
bandingMode | off | Banding-Modus |
bandingModelIdentifier | â | Jev-Modell |
bandingBatchSize | 20 | VorschlĂ€ge pro Jev-Request â Wie viele VorschlĂ€ge in einen Decisions-Request gepackt werden (ein State-Array, ein noul- + Score-Fragenpaar pro Vorschlag). |
bandingAutoNoulMin | 0.9 | Automatisch genehmigen: min. noul-Wahrscheinlichkeit |
bandingAutoScoreMin | 2.6 | Automatisch genehmigen: min. Relevanz-Score |
bandingDiscardNoulMax | 0.2 | Verwerfen: max. noul-Wahrscheinlichkeit |
bandingDiscardScoreMax | 1.5 | Verwerfen: max. Relevanz-Score |
bandingMinProducts | 1 | Min. Produkte fĂŒr automatische Genehmigung |
Hinweise
bandingMode â off: keine Wirkung. shadow: Jev bewertet jeden offenen Vorschlag und speichert das KI-Votum (AI_APPROVED / AI_UNCERTAIN / AI_DISCARDED) zur Kalibrierung, ohne zu handeln. active: genehmigt AI_APPROVED-Voten zusĂ€tzlich automatisch in tdes_synonym und verwirft AI_DISCARDED-Voten. shadow ist der einmalige Kalibrierungsmodus: eine kleine Stichprobe bewerten, die Voten im Admin prĂŒfen, Schwellwerte anpassen, dann mit âreband erneut laufen lassen und auf active umstellen. Erfordert topdata/llm-connect-sw6 mit dem Jev-Client und einen OpenRouter-API-Key beim Provider âjevâ. Nach der Generierung topdata:enhanced-search:synonym-suggestions:band ausfĂŒhren.
bandingModelIdentifier â Entscheidungsmodell, mit dem Synonym-VorschlĂ€ge bewertet werden. AuswĂ€hlbar sind nur Entscheidungsmodelle (gemÀà Modellkatalog des Providers). Gespeichert wird ein Verweis auf das LLM-Connect-Modell; der Provider wird daraus abgeleitet und kann daher nicht verwechselt werden.
bandingAutoScoreMin â Der Relevanz-Score ist eine 0-3-Skala (irrelevant / schwach / gut / exakt). 2.6 akzeptiert zusĂ€tzlich starke Wortvarianten (z. B. Singular/Plural) und regionale Varianten â nur weiter senken, wenn diese als Synonyme akzeptiert werden sollen.
bandingMinProducts â Ist das Ziel eine titel-geminte Phrase mit bekannter gecachter Produktanzahl, erfordert die automatische Genehmigung mindestens so viele Produkte; eine bekannte Anzahl von 0 verwirft immer. Ziele ohne bekannte Anzahl entscheidet Jev allein.
Debug
Diagnoseausgaben zur Fehlerbehebung.
| Setting | Default | Description |
|---|---|---|
showSearchDuration | false | Suchdauer anzeigen (ms) |
Support
FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unseren Support-Portal.
Topdata Enhanced Search SW6 Bedienungsanleitung
Was Kunden sehen
Sobald ein Kunde im Suchfeld des Storefronts tippt, öffnet sich das Such-Overlay und gruppiert die Treffer in Bereiche. Welche Bereiche erscheinen und wie viele EintrÀge sie enthalten, steuern Sie in den Plugin-Einstellungen (siehe Einstellungsleitfaden).
| Bereich | Inhalt |
|---|---|
| SuchvorschlÀge | Kuratierte Phrasen aus Ihrem Katalog mit Produktanzahl, z. B. WC-Papier (12 Artikel) |
| Produkte | Passende Produkte mit Name, Untertitel und â falls aktiviert â der Artikelnummer |
| Kategorien | Passende Kategorien, wahlweise ĂŒber den Produkten oder daneben |
| Hersteller | Marken, jeweils mit der Anzahl ihrer aktiven Produkte |
| Verbrauchsmaterial-GerÀte | GerÀte, zu denen die passenden Verbrauchsmaterialien gehören |
| Letzte Suchanfragen | Wonach dieser Kunde zuvor gesucht hat |
Der Suchbegriff wird in Namen, Untertiteln, Artikelnummern und Breadcrumbs hervorgehoben. Die
Farben sind CSS-Custom-Properties, ein Theme kann das Overlay daher in der eigenen
base.scss umgestalten:
.tdes-overlay {
--tdes-color-accent: #e96354;
--tdes-color-highlight-bg: #f2d0c8;
}
Der Link âAlle N Ergebnisse anzeigenâ bei einem Vorschlag öffnet die Vorschlags-Seite
(/suggestion-search?search=<Begriff>) mit allen passenden VorschlÀgen, je mit Ziel-URL und
Produktanzahl.
SuchqualitÀt pflegen
Das Plugin erfasst, wonach Ihre Kunden suchen, und leitet daraus VorschlĂ€ge und Synonyme ab. Der Ablauf besteht aus vier Schritten und ist fĂŒr den planmĂ€Ăigen Betrieb gedacht.
Schritt 1 â Suchanalysen sammeln lassen
Es ist nichts zu tun: Solange enabled (Suchanalysen) aktiv ist, wird jede Storefront-Suche
sprachbezogen protokolliert. Eine geplante Aufgabe konsolidiert das Rohprotokoll stĂŒndlich in
die Statistik. Falls Sie autoConsolidate deaktiviert haben, fĂŒhren Sie die Konsolidierung
manuell aus:
bin/console topdata:enhanced-search:consolidate-search-logs
Werten Sie die Daten im Administration unter Topdata Enhanced Search > Suchstatistik aus. Die Seite Suchprotokoll zeigt die Rohdaten. Begriffe, aus denen nie ein sinnvolles Synonym entstehen kann â reine Zahlen wie SKU oder EAN, vollstĂ€ndige Markennamen, FĂŒllwörter, sehr kurze Begriffe â werden als Störbegriffe markiert und gelangen nie in den Vorschlags-Workflow.
Schritt 2 â SuchvorschlĂ€ge aus Produkttiteln gewinnen
Wiederkehrende Phrasen in Ihren Produkttiteln werden zu VorschlÀgen:
bin/console topdata:enhanced-search:search-suggestion:generate-from-titles
Wichtige Optionen:
| Option | Wirkung |
|---|---|
--language | Lauf auf eine Storefront-Sprache beschrÀnken (de und gsw sind dieselbe Gruppe) |
--min-products | Mindestanzahl der Produkte, die eine Phrase teilen mĂŒssen, ĂŒberschreiben |
--max-words | Maximale PhrasenlĂ€nge ĂŒberschreiben |
--limit | Obergrenze der VorschlÀge pro Sprachgruppe (0 = kein Limit) |
--prefix-only | Nur TitelprĂ€fixe berĂŒcksichtigen (ĂŒberschreibt suggestionMiningIncludeMidTitle) |
--skip-counts | Die zwischengespeicherten Produktanzahlen nicht aktualisieren |
Phrasen, die von weniger Produkten geteilt werden als suggestionMiningMinProducts vorgeben,
werden ignoriert. Eine Phrase mit bekannter Produktanzahl 0 wird ĂŒbersprungen. FĂŒhren Sie
diesen Schritt vor der Synonym-Generierung in Schritt 3 aus â der titel-geminte Vorrat ist
eine deren Eingangsquellen.
Die Ergebnisse pflegen Sie unter Topdata Enhanced Search > SuchvorschlÀge.
Schritt 3 â Synonym-VorschlĂ€ge generieren
Begriffe ohne Treffer sind die interessanten. Das Plugin bildet sie auf Begriffe ab, die Treffer hatten:
bin/console topdata:enhanced-search:synonym-suggestion:generate
Die Strategien laufen in der in enabledStrategies konfigurierten Reihenfolge, gĂŒnstigste
zuerst:
| Strategie | Wirkung |
|---|---|
TITLE_MINED | Bildet einen Null-Ergebnis-Begriff auf eine aus Produkttiteln gewonnene Phrase ab |
MPN_PREFIX_FAMILY | Erkennt Kartuschen-/Toner-Familien mit gemeinsamer PrĂ€fix-Basis der Hersteller-Artikelnummer und schlĂ€gt die kanonische Basis vor (TN 247 â TN-247) |
HEURISTIC | Levenshtein-Abgleich; gĂŒnstig, aber hĂ€ufig semantisch falsch â nur aktivieren, wenn Sie Begriffe mit vielen Null-Ergebnissen markieren möchten |
LLM | LĂ€sst ein Sprachmodell Null-Ergebnis-Begriffe auf erfolgreiche abbilden |
THESAURUS_THEN_LLM_FILTER | Thesaurus-Kandidaten, von einem LLM auf den produktrelevanten Teil eingegrenzt; die teuerste Strategie, zuletzt ausfĂŒhren |
Optionen: --strategy (nur eine Strategie), --language, --max-terms (FenstergröĂe),
--limit (Obergrenze gespeicherter VorschlÀge), --reset-processed (bereits verarbeitete
Begriffe erneut prĂŒfen), --debug, --allow-disabled-strategy.
maxTermsPerRun und maxSuggestionsPerRun sind die wichtigsten Kostenregler: Die Laufzeit
wird von der teuersten aktivierten Strategie bestimmt. Jeder Lauf meldet, wie viele Begriffe er
als verarbeitet markiert hat â spĂ€tere LĂ€ufe ĂŒberspringen diese, statt sie erneut zu bezahlen.
Die VorschlÀge warten auf Ihre Freigabe im Administration unter Topdata Enhanced Search >
Synonym-VorschlÀge. Mit der Freigabe wird das Synonym geschrieben; es wird nach
bin/console es:index durchsuchbar.
Schritt 4 â Optional: VorschlĂ€ge von KI vorklassifizieren lassen
Ist topdata/llm-connect-sw6 vorhanden, kann das Entscheidungsmodell Jev jeden offenen
Vorschlag bewerten, bevor Sie ihn sehen. Beginnen Sie im Kalibrierungsmodus:
-
Setzen Sie
bandingModeaufshadow. -
Bewertung ausfĂŒhren:
bin/console topdata:enhanced-search:synonym-suggestions:band --limit 50Der Lauf endet mit drei Tabellen â genehmigt / verworfen / unentschieden â je Zeile mit
noul-Wahrscheinlichkeit, Relevanz-Score, Produktanzahl und einer Notiz. Im Modusshadowlauten die Ăberschriften âWould be âŠâ: Die Voten werden gespeichert, aber es wird nichts in die Synonyme geschrieben. -
Passen Sie
bandingAutoScoreMin/bandingAutoNoulMin(und die Verwerfungs-Schwellen) an das an, was Sie als gutes Synonym betrachten. Der Bericht nennt, wie viele Zeilen ein niedrigerer Score-Schwellenwert genehmigen wĂŒrde. -
Wenn die Kalibrierung stimmt, erneut mit
--rebandausfĂŒhren â das bewertet alles neu, was die KI entschieden hat, und legt ungewisse Zeilen zurĂŒck in Ihre Warteschlange â undbandingModeanschlieĂend aufactivestellen.
Im Modus active werden AI_APPROVED-Zeilen automatisch in die Synonyme geschrieben und
AI_DISCARDED-Zeilen geschlossen. Zwei harte Regeln gelten immer: Ein Ziel mit bekannter
Produktanzahl 0 wird verworfen, und ein Ziel unterhalb von bandingMinProducts kann nie
genehmigt werden. Jeder Fehler im KI-Aufruf fĂŒhrt zum offenen Ausgang â die Zeilen bleiben
einfach offen. Optionen: --dry-run, --limit, --language, --type, --reband.
Beachten Sie, dass der Relevanz-Score eine Bewertung und keine Messung ist: Erneutes Bewerten derselben Zeile kann den Score leicht verschieben. Beurteilen Sie einen Schwellenwert daher an einem vollstÀndigen Lauf, nicht an einer einzelnen Zeile.
Synonyme im Alltag pflegen
Unter Topdata Enhanced Search > Synonyme pflegen Sie die aktiven Synonymregeln. Jede
Regel hat einen Suchbegriff, einen oder mehrere Zielbegriffe, einen Geltungsbereich (alle
Sprachen oder eine einzelne) und eine Boost-Stufe (NONE, LOW, MEDIUM, HIGH), die
die Zielbegriffe in der Trefferbewertung hochwertet.
- Das Bearbeiten oder HinzufĂŒgen einer Regel erfordert anschlieĂend
bin/console es:index. - Eine Ănderung der Boost-Stufe wirkt sofort, ohne Neuaufbau des Index.
- Export und Import sind asymmetrisch und quellenerhaltend (
term => term, targets), damit ein Produkt, das den Quellbegriff wörtlich enthÀlt, seine normalen Treffer behÀlt:
# aktuelle Regeln sichern
bin/console topdata:enhanced-search:synonym:export --output synonyms-backup.txt
# Datei vor dem Import auf Syntaxfehler prĂŒfen
bin/console topdata:enhanced-search:synonym:import synonyms.txt --dry-run
# Regeln aus einer Textdatei importieren, danach Index neu aufbauen
bin/console topdata:enhanced-search:synonym:import synonyms.txt
bin/console es:index
Verwandte Seiten: Synonym-Quellen (konfigurierte CSV-Importe), Synonym-APIs (externe Quellen), Filter-Map (bestimmte Produkte aus den Ergebnissen eines Suchbegriffs entfernen) und Such-Stoppwörter (Wörter, mit denen das Titel-Mining nie einen Vorschlag beenden soll).
NĂŒtzliche Befehle
# Synonyme
bin/console topdata:enhanced-search:synonym:list
bin/console topdata:enhanced-search:synonym:validate synonyms.txt
bin/console topdata:enhanced-search:synonym:delete "papier"
bin/console topdata:enhanced-search:synonym:clear
# VorschlÀge
bin/console topdata:enhanced-search:synonym-suggestion:list
bin/console topdata:enhanced-search:search-suggestion:clear
bin/console topdata:enhanced-search:synonym-suggestion:clear
# Diagnose: zeigt, wie die Produkte zu einem Begriff bewertet werden
bin/console topdata:enhanced-search:debug-search "papier"
Support
FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.
Topdata Enhanced Search SW6 FAQ & Fehlerbehebung
HĂ€ufige Probleme
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Das Such-Overlay öffnet sich nicht | Das Plugin ist nicht aktiv oder der Suchindex wurde nie neu aufgebaut | bin/console plugin:list, danach bin/console es:index |
| Ein neu angelegtes Synonym zeigt keine Wirkung | Der Index enthÀlt noch den alten Synonym-Stand | bin/console es:index |
| Ein Synonym wirkt, aber ein Produkt, das den Begriff enthÀlt, fehlt in den Treffern | Die Regel leitet den Begriff um; Export/Import ist quellenerhaltend (term => term, targets) | ErgÀnzen Sie den Quellbegriff in der ZielListe der Regel und bauen Sie den Index neu auf |
| Die Treffer enthalten offensichtlich falsche Produkte (z. B. âToilettenâ findet âTablettenâ) | Die Fuzzy-Suche ist aktiv | disableFuzzySearch aktivieren und Index neu aufbauen â oder das Produkt ĂŒber die Filter-Map fĂŒr diesen Begriff ausschlieĂen |
| Korrekte Produkte fehlen in den Treffern | Sie sind einer ausgeschlossenen Kategorie zugeordnet | excludedCategories prĂŒfen; sind die Produkte der Kategorie nur als Nebenkategorie zugeordnet, excludeOnlyMainCategory aktivieren |
| Marken ohne Produkte verwirren die Herstellerliste | Leere Marken werden standardmĂ€Ăig angezeigt | emptyBrandHandling auf hide_empty oder grey_empty setzen |
| Kategorienamen im Overlay sind zu lang | Lange Breadcrumbs | categoryBreadcrumbMaxParts erhöhen oder categoryBreadcrumbHideRoot deaktivieren |
| Die Synonym-Generierung findet nichts | Es wurden noch keine Begriffe ohne Treffer erfasst, oder alle sind als verarbeitet markiert | Die Analyse einige Zeit laufen lassen, Suchstatistik prĂŒfen und --reset-processed verwenden |
| Ein Generierungslauf dauert sehr lange | Eine teure Strategie ist aktiviert | THESAURUS_THEN_LLM_FILTER aus enabledStrategies entfernen oder maxTermsPerRun senken |
| Es werden keine Synonym-VorschlÀge erzeugt, obwohl das LLM konfiguriert ist | Die LLM-Strategie wurde entfernt, weil topdata/llm-connect-sw6 fehlt | Plugin installieren und einen Zugang unter Topdata Llm Connect > AI Credentials hinterlegen |
| Die KI-Bewertung (Banding) tut nichts | bandingMode steht noch auf off oder beim Provider jev fehlt der API-Key | bandingMode zur Kalibrierung auf shadow setzen; Zugang fĂŒr den Provider jev prĂŒfen |
| Produktanzahlen neben VorschlĂ€gen sind veraltet | Der Katalog wurde nach dem letzten Mining-Lauf geĂ€ndert | topdata:enhanced-search:search-suggestion:generate-from-titles ohne --skip-counts erneut ausfĂŒhren; Ă€ltere ZĂ€hler als der aktive Index werden automatisch neu berechnet |
| Die Overlay-Farben passen nicht zum Theme | Das Theme ĂŒberschreibt die CSS-Custom-Properties nicht | Die Variablen --tdes-color-* in der base.scss des Themes auf .tdes-overlay setzen |
Fehlerbehebungsanleitung
1. Die Suche liefert nach einem Update keine Ergebnisse
Shopware 6.7 verwendet fĂŒr das Indexfeld des Plugins einen echten Edge-Ngram-Tokenizer. Nach einem Update muss der Index neu aufgebaut werden, sonst sind die neuen Suchregeln nicht aktiv:
bin/console cache:clear
bin/console es:index
2. PrĂŒfen, wie ein Begriff bewertet wird
Mit dem Debug-Befehl sehen Sie, welche Produkte ein Begriff trifft und wie sie bewertet werden:
bin/console topdata:enhanced-search:debug-search "papier"
Mit --sales-channel-id und --language-id prĂŒfen Sie einen bestimmten Vertriebskanal und
eine Sprache, --limit kĂŒrzt die Ausgabe.
3. Eine Synonymdatei lÀsst sich nicht importieren
Validieren Sie die Datei zuerst â der Befehl nennt die fehlerhafte Zeile, statt mitten im Lauf abzubrechen:
bin/console topdata:enhanced-search:synonym:validate synonyms.txt
bin/console topdata:enhanced-search:synonym:import synonyms.txt --dry-run
Eine Regel hat die Form [language,product,boost=LEVEL] term => syn1, syn2. FĂŒr die
LLM-Strategien sind nur Chat-Modelle wĂ€hlbar, fĂŒr das Jev-Banding nur Entscheidungsmodelle.
4. Eine falsche KI-Entscheidung zurĂŒcknehmen
FĂŒhren Sie das Banding erneut mit --reband aus: Es bewertet jede Zeile neu, die die KI
entschieden hat â auch die verworfenen â und legt Zeilen, die unentschieden zurĂŒckkommen, in
die menschliche Warteschlange. Von Menschen entschiedene Zeilen werden nie berĂŒhrt. Nachdem neue
Synonyme geschrieben wurden, bauen Sie den Index neu auf.
5. Die KI-Funktionen vorĂŒbergehend abschalten
Setzen Sie bandingMode auf off und entfernen Sie LLM und
THESAURUS_THEN_LLM_FILTER aus enabledStrategies. Alles Weitere â Suchanalysen,
Titel-Mining, MPN_PREFIX_FAMILY, die bestehenden Synonyme â funktioniert ohne KI-Zugang
weiter.
Support
FĂŒr zusĂ€tzlichen Support wenden Sie sich bitte an unser technisches Support-Team oder besuchen Sie unser Support-Portal.