Admin Power Tools — Such-Merchandising

1. Erste Schritte

Das Plugin aktiviert sich mit sinnvollen Standardwerten. Es muss nichts konfiguriert werden, damit es direkt genutzt werden kann.

Beim ersten Aufruf von Kataloge → Such-Merchandising startet automatisch ein Onboarding-Assistent. Dieser führt durch die Engine-Erkennung, die erste Rettungsregel und den optionalen Wochen-Digest. Der Assistent kann jederzeit über den Header des Dashboards erneut geöffnet werden.

2. Admin-Seiten

Alle Plugin-Seiten befinden sich unter Kataloge → Such-Merchandising.

Die Sub-Navigation am oberen Rand jeder Seite enthält:

• Dashboard — KPIs, Such-zu-Umsatz-Funnel, Top-Suchanfragen und Such-Health

• Suchaktivität — vollständige Suchbegriffsliste mit Klickdaten und Detailansicht je Suchbegriff

• Merchandising-Regeln — Liste, Editor, Drag-and-Drop-Visual-Merchandiser und Regelvorlagen

• Synonyme — Synonym-Sets, Auto-Vorschläge und Elasticsearch-Export

• Null-Ergebnis-Suchen — Rettungsregeln für Suchanfragen ohne Treffer

• Kampagnen — zeitlich begrenzte Regelgruppen mit Countdown

• Mehr — A/B-Tests, Glass Box, Engine Status, Scoring, Empfehlungen, Learning-to-Rank und Audit-Log

3. Plugin-Konfiguration

Öffnen Sie Einstellungen → Erweiterungen → Meine Erweiterungen → Such-Merchandising → Konfigurieren.

Jede Einstellung kann pro Sales Channel angepasst werden. Lassen Sie die Sales-Channel-Auswahl auf Alle Sales Channels, wenn die Einstellung global gelten soll.

Tracking

Suchtracking aktivieren
Standard: aktiv

Erfasst Suchanfragen, Klicks und Warenkorb-Ereignisse. Diese Funktion ist erforderlich, damit das Dashboard Daten anzeigen kann. Deaktivieren Sie sie nur, wenn es dafür einen Sales-Channel-spezifischen Grund gibt.

Sitzungszuordnungsfenster in Minuten
Standard: 30

Legt fest, wie lange nach einem Suchklick eine Bestellung noch als suchzugeordneter Umsatz gewertet wird. Für typische Shops reichen 30 Minuten aus. Bei längeren Kaufentscheidungen, zum Beispiel im B2B-Bereich, bei Möbeln oder Elektronik, kann der Wert auf 60 bis 120 Minuten erhöht werden.

Datenverwaltung

Rohdaten-Aufbewahrung in Tagen
Standard: 7

Legt fest, wie lange Rohereignisse in der Datenbank gespeichert bleiben. Aggregierte Tagesdaten werden unbegrenzt aufbewahrt. Bei sehr hohem Traffic kann der Wert reduziert werden, um die Datenbanktabellen klein zu halten.

Automatische Aggregation aktivieren
Standard: aktiv

Aktiviert einen nächtlichen Task, der Rohereignisse zu Tagesübersichten verdichtet. Diese Funktion ist erforderlich, damit historische Dashboard-Trends korrekt angezeigt werden.

Personalisierung

Sitzungsbasierte Personalisierung aktivieren
Standard: deaktiviert

Boostet Produkte, die voraussichtlich der nächste Klick eines Käufers sind, basierend auf der Klick-Historie der aktuellen Sitzung. Diese Funktion wird nur für Shops mit regelmäßigem Wiederkehrtraffic und mindestens ca. 10.000 erfassten Klick-Ereignissen empfohlen. Kleinere Shops sollten diese Option deaktiviert lassen.

Storefront-Empfehlungen

„Ähnliche Produkte“ auf Produktseiten anzeigen
Standard: deaktiviert

Fügt eine Empfehlungszeile unterhalb der Produktbeschreibung auf Produktdetailseiten hinzu.

„Oft zusammen gekauft“ auf der Warenkorbseite anzeigen
Standard: deaktiviert

Zeigt Cross-Selling-Vorschläge basierend auf dem Hauptprodukt im Warenkorb an.

„Aktuell beliebt“ auf Null-Ergebnis-Seiten anzeigen
Standard: aktiv

Zeigt beliebte Produkte an, wenn eine Suche keine Treffer liefert. Dadurch bleiben Kunden besser im Kaufprozess.

Wöchentlicher Digest

Wöchentlichen Digest senden
Standard: deaktiviert

Versendet jeden Montagmorgen eine einseitige Zusammenfassung der Suchaktivität der vergangenen Woche.

Empfänger-E-Mail

Legt fest, an welche E-Mail-Adresse der Digest gesendet wird. Wenn das Feld leer bleibt, wird kein Digest versendet, auch wenn die Option aktiviert ist.

Sofortsuche

Sofortsuche aktivieren
Standard: aktiv

Zeigt Suchergebnisse bereits während der Eingabe in der Suchleiste an.

Layout

Wählen Sie zwischen einem Dropdown unter der Suchleiste oder einem Vollbild-Overlay.

Personalisierung

Verfügbare Optionen:

• Aus

• Leicht, sitzungsbasiert

• Voll, basierend auf Kundenprofil und Kategorieaffinität

Produkte, Kategorien und CMS-Seiten anzeigen

Legt fest, wie viele Ergebnisse je Bereich im Dropdown angezeigt werden. Standardwerte: 6 Produkte, 3 Kategorien und 2 CMS-Seiten.

Mindestzeichen
Standard: 2

Legt fest, ab wie vielen eingegebenen Zeichen die Sofortsuche ausgelöst wird.

Produktbewertungen anzeigen
Standard: aktiv

Zeigt Sternebewertungen bei Produkten an.

Variantenanzahl anzeigen
Standard: aktiv

Zeigt die Anzahl verfügbarer Varianten je Produkt an.

4. Rollen und Rechte

Das Plugin definiert drei Privilegien:

sc_apt_sm.viewer
Lesezugriff auf Dashboards, Regeln und Reports

sc_apt_sm.editor
Regeln und Synonyme erstellen, bearbeiten und speichern, jedoch nur als Entwurf

sc_apt_sm.approver
Entwürfe veröffentlichen und in den Status „Veröffentlicht“ überführen

Die Zuweisung erfolgt über Einstellungen → System → Benutzer & Rechte → Rollen.

Administratoren haben ohne zusätzliche Zuweisung vollen Zugriff.

5. Geplante Tasks

Das Plugin registriert vier Hintergrund-Tasks. Diese laufen automatisch über den Shopware Scheduled Task Runner. Es ist kein zusätzliches Setup im Plugin notwendig. Der Scheduled Task Runner muss im Shop jedoch aktiv sein, zum Beispiel über Cron oder Messenger Worker.

SearchAggregation
Läuft täglich und verdichtet Rohereignisse zu Tagesübersichten.

SearchRetention
Läuft täglich und löscht Rohereignisse, die älter als das konfigurierte Aufbewahrungsfenster sind.

RuleAutoRevert
Läuft stündlich und deaktiviert Kampagnenregeln nach Ablauf des Enddatums.

AnomalyDetection
Läuft täglich und vergleicht die aktuellen Metriken mit der 14-Tage-Baseline.

6. Optional: Elasticsearch / OpenSearch

Das Plugin funktioniert vollständig mit der Standard-MySQL-Suche von Shopware.

Wenn im Shop bereits Elasticsearch oder OpenSearch aktiv ist, werden zusätzliche Funktionen automatisch freigeschaltet:

• Synonym-Set-Export in die Elasticsearch-Analyzer-Konfiguration

• Rank-Feature-Zeitabklingen für frischere Produkte

• Learning-to-Rank-Modelle trainieren und ausliefern

• Percolator-basiertes Query-Tagging

Öffnen Sie Such-Merchandising → Mehr → Engine Status, um zu sehen, welche Engine erkannt wurde und welche Funktionen aktiv sind.

7. Erste Schritte nach der Installation

1. Öffnen Sie Kataloge → Such-Merchandising.
   Der Onboarding-Assistent startet beim ersten Besuch automatisch.

2. Lassen Sie den Storefront ein bis zwei Tage laufen, damit das Dashboard Suchdaten anzeigen kann.

3. Öffnen Sie auf dem Dashboard die volumenstärkste Null-Ergebnis-Suchanfrage und legen Sie eine Rettungsregel an. Möglich sind zum Beispiel ähnliche Produkte, eine Weiterleitung oder das Ausblenden der Suchanfrage.

4. Aktivieren Sie optional den Wochen-Digest in der Plugin-Konfiguration und tragen Sie eine Empfänger-E-Mail-Adresse ein.

5. Aktivieren Sie optional PDP- und Warenkorb-Empfehlungen in der Plugin-Konfiguration.

8. Fehlerbehebung

Das Dashboard zeigt keine Daten

Prüfen Sie, ob Suchtracking aktivieren eingeschaltet ist und ob bereits mindestens eine Suche im Storefront durchgeführt wurde. Der erste historische Datenpunkt erscheint nach der nächsten nächtlichen Aggregation.

Synonyme zeigen in Elasticsearch-Shops keine Wirkung

Öffnen Sie Synonyme → Export für Elasticsearch, kopieren Sie die YAML-Konfiguration in die Elasticsearch-Analyzer-Konfiguration und indizieren Sie die Produkte anschließend neu.

Regeln greifen nicht

Prüfen Sie, ob der Regelstatus Veröffentlicht ist. Regeln im Status Entwurf oder Freigabe ausstehend werden nicht angewendet. Prüfen Sie außerdem, ob das Sales-Channel-Scoping zum durchsuchten Sales Channel passt.

Anomalie-Alerts werden nicht ausgelöst

Die Anomalie-Erkennung benötigt mindestens 14 Tage Suchhistorie, um eine zuverlässige Baseline aufzubauen.

Geplante Tasks bleiben dauerhaft auf „in Warteschlange“

Prüfen Sie, ob der Messenger Worker oder der System-Cron aktiv läuft. Die Tasks des Plugins nutzen das Standard-Scheduling von Shopware.