Onlineshop-Suche kuratieren

Nutzen Sie die Kuratierung der Onlineshop-Suche, wenn Besucher nach Begriffen suchen, die fachlich zu vorhandenen Produkten, Kategorien oder Seiten gehören, aber nicht direkt im öffentlichen Suchindex stehen. Workspace sammelt Suchanfragen aggregiert, zeigt auffällige Begriffe für die Redaktion und kann KI-Vorschläge vorbereiten. Dauerhafte Produktlenkung erfolgt über Produktsegmente, wenn ein Suchbegriff eine wiederverwendbare Produktmenge beschreibt. Die Live-Suche bleibt deterministisch: Sie ruft im Suchrequest kein KI-Modell auf.

Diese Seite richtet sich an Administratoren, Betreiber und Redakteure. Nach der Einrichtung können Teams Suchbegriffe prüfen, passende Regeln pflegen, KI-Vorschläge akzeptieren oder verwerfen und die Wirkung in der Public Storefront testen.

Wenn Sie die Produktreihenfolge fachlich steuern möchten, ohne Rechte, Policies oder technische Pflegepfade einzurichten, starten Sie mit Produktreihenfolge im Onlineshop steuern.

Voraussetzungen

Prüfen Sie vor der Pflege:

Die Site ist aktiv, an den richtigen Host gebunden und einem Sales Channel zugeordnet.
Der öffentliche Katalog enthält die erwarteten Produkte. Die Varianten sind veröffentlicht, suchbar und im aktuellen Storefront-Kontext sichtbar.
Die Public Storefront verwendet die öffentliche Katalogsuche. Entwickler ordnen den Vertrag unter Produkte suchen ein.
Die Redaktion hat Rechte für Suchanalyse, Synonyme, Korrekturen, Produktsegmente, kuratierte Ziele, KI-Vorschläge und KI-Läufe.
Produktsegmente verwenden nur PIM-Attribute, deren Attributverknüpfung Öffentlich filterbar aktiviert hat und deren Property nicht sensibel ist.
Für KI-Vorschläge ist ein AI-Provider für den Task-Key site_search.suggestions eingerichtet.

Wenn Sie einen lokalen Dienst wie Ollama verwenden, konfigurieren Sie ihn als normalen AI-Provider. Die Suchfunktion hängt nicht an Ollama als Sonderweg: Jeder passende Provider muss über die reguläre AI-Anbindung, Ownership und gegebenenfalls ein Task-Mapping für site_search.suggestions freigegeben sein.

Einrichtung Schritt für Schritt

Prüfen Sie Site, Domain, Sales Channel, Locale und öffentlichen Katalog mit Sites und CMS.
Veröffentlichen Sie die relevanten Produktvarianten und stellen Sie sicher, dass sie für die öffentliche Suche freigegeben sind.
Vergeben Sie die Rechte für Suchanalyse, Synonyme, Korrekturen, Produktsegmente, kuratierte Ziele und KI-Vorschläge an die zuständigen Rollen.
Legen Sie fest, welche Sites und Sprachen getrennt gepflegt werden. Beginnen Sie mit site- und locale-spezifischen Regeln.
Konfigurieren Sie bei Bedarf den AI-Task site_search.suggestions über den normalen AI-Providerpfad mit Ownership, Quotas und Task-Mapping.
Öffnen Sie die Pflegebereiche im Workspace unter CMS > Suche. Die Einstiegsroute bleibt /cms/suchkuratierung. Suchanfragen liegt unter CMS > Suche > Auswertung; Synonyme, Korrekturen, Produktsegmente und kuratierte Ziele liegen unter CMS > Suche > Konfiguration. KI-Vorschläge, KI-Läufe und KI-Laufpositionen bleiben direkt unter CMS > Suche. Die einzelnen Listen behalten ihre Slugs, zum Beispiel /cms/suche/suchanfragen, /cms/suche/synonyme, /cms/suche/korrekturen, /cms/suche/produktsegmente, /cms/suche/kuratierte-ziele und /cms/suche/ki-vorschlaege, /cms/suche/ki-laeufe und /cms/suche/ki-laufpositionen.
Starten Sie die Pflege mit aggregierten Suchanfragen aus der Suchanalyse.
Testen Sie jede aktive Regel über die öffentliche Suche mit q=<suchbegriff>.

Die Storefront muss dafür nicht auf einen KI-Suchpfad umgestellt werden. Der Shop sendet weiterhin normale Suchrequests; Workspace nutzt nur bereits gepflegte und freigegebene Regeln im Live-Pfad.

Bereiche und Rechte

Vergeben Sie nur die Rechte, die ein Team fachlich benötigt.

Aufgabe	Benötigte Rechte
Suchanfragen auswerten	`site_search_analytics:list`, `site_search_analytics:read`
Synonyme pflegen	`site_search_synonyms:list`, `site_search_synonyms:read`, `site_search_synonyms:create`, `site_search_synonyms:update`, `site_search_synonyms:delete`
Korrekturen pflegen	`site_search_corrections:list`, `site_search_corrections:read`, `site_search_corrections:create`, `site_search_corrections:update`, `site_search_corrections:delete`
Produktsegmente pflegen	`site_search_product_segments:list`, `site_search_product_segments:read`, `site_search_product_segments:create`, `site_search_product_segments:update`, `site_search_product_segments:delete`
Kuratierte Ziele pflegen	`site_search_targets:list`, `site_search_targets:read`, `site_search_targets:create`, `site_search_targets:update`, `site_search_targets:delete`
KI-Vorschläge erzeugen und prüfen	`site_search_suggestions:list`, `site_search_suggestions:read`, `site_search_suggestions:create`, `site_search_suggestions:update`
KI-Läufe und Laufpositionen prüfen	`site_search_suggestion_runs:list`, `site_search_suggestion_runs:read`, `site_search_suggestion_run_items:list`, `site_search_suggestion_run_items:read`
Trefferreihenfolge steuern	`storefront_catalog_ranking_policies:list`, `storefront_catalog_ranking_policies:read`, `storefront_catalog_ranking_policies:create`, `storefront_catalog_ranking_policies:update`, `storefront_catalog_ranking_bindings:list`, `storefront_catalog_ranking_bindings:read`, `storefront_catalog_ranking_bindings:create`, `storefront_catalog_ranking_bindings:update`, `storefront_catalog_ranking_overrides:list`, `storefront_catalog_ranking_overrides:read`, `storefront_catalog_ranking_overrides:create`, `storefront_catalog_ranking_overrides:update`, `storefront_catalog_ranking_preview:read`
Sales- und Stock-Signale aktualisieren	`storefront_catalog_ranking_signals:rebuild`

Aktive Regeln können tenantweit gelten oder auf Site und Locale eingegrenzt werden. Pflegen Sie Regeln möglichst eng: Ein Suchbegriff für den deutschen Shop muss nicht automatisch für alle Sites und Sprachen gelten.

Welche Regel passt?

Wählen Sie die kleinste Regel, die die Suchabsicht sauber beschreibt.

Situation	Verwenden Sie
Besucher nutzen einen gleichwertigen Fachbegriff, eine andere Sprache oder eine gängige Abkürzung.	Synonym
Besucher vertippen sich oder verwenden eine Schreibweise, die immer auf einen anderen Begriff normalisiert werden soll.	Korrektur
Ein Begriff soll gezielt ein Produktsegment, eine Kategorie, eine Produktvariante oder eine Seite hervorheben, obwohl der Begriff nicht im Inhalt steht.	Kuratiertes Ziel
Sichtbare Produkte sind fachlich richtig, aber Bestseller, Kampagnenartikel oder verfügbare Artikel sollen weiter oben stehen.	Storefront-Catalog-Ranking
Die Suche findet nichts, weil Produktname, Inhalt, Kategorie oder Veröffentlichung fehlen.	Produkt- oder Content-Pflege, keine Suchregel
Ein Begriff ist zu allgemein oder mehrdeutig.	Keine automatische Zuordnung; zuerst Daten, Landingpage oder Navigation klären

Produktdaten bleiben die beste Suchgrundlage. Nutzen Sie Suchregeln nicht, um fehlende Produktnamen, falsche Kategorien, nicht veröffentlichte Varianten oder schwache Produktinhalte dauerhaft zu überdecken.

Redaktioneller Ablauf

Arbeiten Sie regelmäßig mit den aggregierten Suchanfragen:

Öffnen Sie CMS > Suche > Auswertung > Suchanfragen und filtern Sie die Liste auf eine konkrete Site und Locale.
Priorisieren Sie Begriffe mit Trefferklasse zero, one oder few und wiederholten Suchzahlen.
Prüfen Sie im öffentlichen Shop, was Besucher wahrscheinlich erwartet haben.
Entscheiden Sie, ob Produktdaten, Synonym, Korrektur oder kuratiertes Ziel die richtige Maßnahme ist.
Pflegen Sie die Regel zunächst eng für Site und Locale.
Testen Sie die Suche mit dem Originalbegriff und mit naheliegenden Varianten.
Lassen Sie die Regel aktiv, wenn sie den erwarteten öffentlichen Treffer erzeugt, ohne andere Begriffe zu verfälschen.

Suchanalyse speichert aggregierte Werte. Sie ist für redaktionelle Auswertung gedacht, nicht für die Analyse einzelner Besucher. Dev-Mode und Vorschau sind von produktiven Suchmetriken getrennt.

Kuratierte Ziele pflegen

Kuratierte Ziele verbinden eine konkrete Suchanfrage mit einem Ziel:

product_segment für eine wiederverwendbare Produktmenge aus public-safe PIM-Attributen.
product_variant für eine kaufbare Produktvariante.
category für eine Kategorie, Navigation oder fachliche Landingpage.
page für eine öffentliche Site-Seite oder Landingpage.

Für Produktsegment-, Produktvarianten- und Kategorieziele verwenden Sie die Ziel-ID aus dem aktuellen Tenant. Für Page-Ziele verwenden Sie den öffentlichen Zielwert, zum Beispiel einen stabilen Page-Slug oder Pfad nach Site-Konzept. Die Public Storefront zeigt ein Ziel nur, wenn es im aktuellen Tenant-, Site-, Locale- und Storefront-Kontext sichtbar ist.

Bevorzugen Sie für dauerhafte Produktabsichten ein Produktsegment. Ein Begriff wie 19 Zoll, Rack-USV oder Rackgerät sollte auf ein Segment zeigen, das öffentliche PIM-Attribute wie mounting_type, rack_width_standard oder rack_units auswertet. Neue Produkte greifen dann automatisch, sobald die Variante korrekt gepflegt, veröffentlicht und suchbar ist. Variantenattribute überschreiben dabei gemeinsame Familienattribute.

Nutzen Sie Kategorien für Navigation, Sortimente und Landingpage-Konzepte, nicht als primäres Modell für Bauform, Formfaktor oder technische Gehäusemerkmale. Nutzen Sie direkte Produktvarianten-Ziele nur als präzisen Sofortfix oder für bewusst einzelne Produkte.

Nutzen Sie das Gewicht, um mehrere Ziele für denselben Begriff zu sortieren. Starten Sie mit dem Standardgewicht und erhöhen Sie es nur, wenn mehrere passende Ziele bewusst priorisiert werden müssen.

Trefferreihenfolge steuern

Nutzen Sie Storefront-Catalog-Ranking, wenn die Suche bereits die richtigen Produkte findet, die Reihenfolge aber geschäftlich gesteuert werden soll. Die Ranking-Policy ändert keine Sichtbarkeit: Sie sortiert nur Produkte, die im aktuellen Tenant-, Site-, Sales-Channel-, Locale- und Suchkontext öffentlich sichtbar und suchbar sind.

Die fachliche Anleitung für Shop-Betreiber steht unter Produktreihenfolge im Onlineshop steuern. Dieser Abschnitt beschreibt die administrative Pflege.

Gehen Sie so vor:

Legen Sie eine Ranking-Policy mit der Strategie weighted_v1 an.
Setzen Sie die Gewichte für Suchscore, manuelle Priorität, Sales-Signal und Stock-Signal.
Binden Sie die Policy an eine Site oder an einen Sales Channel. Eine Site-Bindung gewinnt vor einer Sales-Channel-Bindung.
Pflegen Sie manuelle Overrides für einzelne Produktvarianten, wenn bestimmte Produkte bewusst höher oder niedriger erscheinen sollen.
Aktualisieren Sie Sales- und Stock-Signale über den Rebuild, wenn Verkaufs- oder Bestandsdaten in das Ranking einfließen sollen.
Prüfen Sie die Wirkung mit der Preview für Site, Sales Channel, Locale und Suchbegriff.

Verwenden Sie Ranking nicht, um fehlende Produktdaten, falsche Kategorien oder nicht veröffentlichte Varianten zu kaschieren. Solche Probleme beheben Sie in PIM, Publication, Kategoriepflege oder Content. Verwenden Sie Synonyme, Korrekturen und kuratierte Ziele weiterhin für die Begriffspflege; Ranking ist für die Reihenfolge innerhalb der sichtbaren Treffer zuständig.

KI-Vorschläge nutzen

KI-Vorschläge helfen beim Vorbereiten, ersetzen aber keine redaktionelle Freigabe.

Richten Sie den AI-Task site_search.suggestions mit Provider, Ownership und Quotas ein.
Starten Sie die Vorschlagserzeugung für eine konkrete Site und Locale.
Workspace plant einen Taskstream-Job ein und verarbeitet höchstens die aktuellen aggregierten Suchanfragen mit wenigen oder keinen Treffern.
Öffnen Sie CMS > Suche > KI-Läufe, um Status, Provider, Modell und Zähler des Laufes zu prüfen.
Öffnen Sie bei Bedarf CMS > Suche > KI-Laufpositionen, um pro Suchbegriff Kandidaten, Modellentscheidung, Ergebnis und Reason-Code zu sehen.
Prüfen Sie jeden Vorschlag mit Suchbegriff, Vorschlagsart, Confidence, Begründung und Ziel.
Akzeptieren Sie nur Vorschläge, die fachlich stimmen und public-safe sind.
Verwerfen Sie unklare, zu breite oder geschäftlich falsche Vorschläge.

Ein akzeptierter Vorschlag schreibt erst dann eine produktive Regel: Synonym-Vorschläge erzeugen Synonyme, Korrektur-Vorschläge erzeugen Korrekturen, Target-Vorschläge erzeugen kuratierte Ziele. Ein verworfener Vorschlag ändert keine Suchregel. KI-Vorschläge dürfen vorhandene aktive Produktsegmente als Ziel vorschlagen, erzeugen aber keine Produktsegmente und ändern keine Segmentregeln.

Der KI-Lauf speichert keine vollständigen Prompts und keine rohe Modellantwort. Workspace gibt dem Modell nur public-safe Kandidaten aus öffentlichen Produktdaten, Kategorien und aktiven Produktsegmenten. Target-Vorschläge werden nur übernommen, wenn sie eine bereitgestellte Kandidatenreferenz verwenden. Wenn das Modell keinen belastbaren Kandidaten nennt, bleibt der Suchbegriff als Laufposition mit Ergebnis Ohne Evidenz, Kein Vorschlag oder Verworfen nachvollziehbar, ohne eine neue Regel anzulegen.

Strategie für gute Suchqualität

Führen Sie die Suchpflege als wiederkehrenden Redaktionsprozess:

Prüfen Sie Suchbegriffe nach Kampagnen, Sortimentswechseln, neuen Kategorien und größeren Produktdatenänderungen.
Beheben Sie Datenprobleme zuerst in PIM, Veröffentlichung, Kategorie oder Site-Inhalt.
Nutzen Sie Synonyme für echte Gleichwertigkeit, nicht für Kampagnenranking.
Nutzen Sie Korrekturen nur für klare Schreibfehler oder stabile Normalisierung.
Nutzen Sie Produktsegmente für technische Suchabsichten wie Bauform, Formfaktor oder Rack-Standard.
Nutzen Sie kuratierte Ziele für absichtliche Lenkung auf Produktsegment, Kategorie, Produktvariante oder Landingpage.
Halten Sie Regeln sprach- und site-spezifisch, wenn die Bedeutung nicht überall identisch ist.
Entfernen oder deaktivieren Sie Regeln, wenn Produkte ausgelistet, Kategorien umgebaut oder Landingpages entfernt wurden.
Verarbeiten Sie keine personenbezogenen Suchbegriffe als redaktionelle Regeln.

Eine gute Regel verbessert den konkreten Suchbegriff, ohne andere Suchbegriffe unbeabsichtigt umzudeuten. Breite Begriffe wie ersatzteil, service oder angebot brauchen meistens bessere Navigation, Landingpages oder Produktdaten, nicht eine harte Zielzuordnung auf ein einzelnes Produkt.

Erfolg erkennen

Die Pflege funktioniert, wenn:

wichtige zero-, one- und few-Begriffe weniger häufig auftreten,
der Originalbegriff im öffentlichen Shop erwartete Produkte, Kategorien oder Seiten zeigt,
die Treffer weiterhin aus public-safe Produkt- und Site-Daten stammen,
akzeptierte KI-Vorschläge erst nach Review wirksam werden,
die Live-Suche auch ohne erreichbaren AI-Provider schnell und stabil bleibt.

Wenn ein Begriff trotz Regel nicht greift, prüfen Sie zuerst Site, Locale, Sales Channel, Produktveröffentlichung, Suchbarkeit, Zieltyp und Sichtbarkeit im Storefront-Kontext. Wechseln Sie nicht auf interne PIM- oder Admin-Endpunkte aus, um fehlende öffentliche Sichtbarkeit zu umgehen.

Nächste Schritte

Site und Veröffentlichung prüfen: Sites und CMS
Katalog- und Suchvertrag für Storefront-Entwicklung einordnen: Katalog, Preise und Produktdarstellung
Website- und Search-Auswertungen lesen: Website-Analytics und Marketing-Attribution