Synonyme und Rechtschreibkorrektur in der Magento-Suche

1. Warum Synonyme und Tippfehlertoleranz die Erfolgsquote erhöhen

Suchsynonyme lösen ein grundlegendes sprachliches Problem: Kunden verwenden für dasselbe Produkt oft andere Begriffe als die Produktbeschreibung im Katalog. Eine Suche nach "Laptop" soll auch Treffer liefern, wenn der Katalog konsequent "Notebook" schreibt. Ohne Suchsynonyme und Rechtschreibkorrektur landet ein erheblicher Teil dieser Suchanfragen auf einer Null-Treffer-Seite, obwohl das gesuchte Produkt im Sortiment vorhanden ist.

Die zweite große Fehlerquelle sind Tippfehler, besonders auf mobilen Geräten mit kleiner Tastatur. Ohne Rechtschreibkorrektur führt bereits ein einziger vertauschter Buchstabe zu einem Null-Treffer-Ergebnis. Beide Probleme, fehlende Synonyme und fehlende Tippfehlertoleranz, sind technisch unterschiedlich zu lösen, tragen aber zum selben Symptom bei: Kunden verlassen die Seite, weil die Suche scheinbar nichts findet, obwohl das Produkt existiert.

Der wirtschaftliche Effekt von guten Suchsynonymen ist häufig unterschätzt. Eine Analyse der No-Result-Searches zeigt in den meisten Katalogen, dass ein zweistelliger Prozentsatz aller Null-Treffer-Suchen durch eine Handvoll gezielter Synonyme behoben werden könnte. Das ist einer der Fälle, in denen wenig Aufwand einen überproportional großen Effekt auf die Conversion-Rate der internen Suche hat.

2. Search Synonym Groups im Admin richtig pflegen

Magento bringt mit den Search Synonym Groups (Store > Search Synonyms im Backend) ein eingebautes Werkzeug für die Pflege von Synonymgruppen mit, das ohne zusätzliche Entwicklung nutzbar ist. Eine Synonymgruppe fasst mehrere Begriffe zusammen, die bei der Suche wechselseitig als gleichwertig behandelt werden sollen, etwa laptop, notebook, ultrabook. Die Pflege erfolgt scope-abhängig, also potenziell unterschiedlich je Website oder Store View, was für mehrsprachige Shops wichtig ist.

Ein häufiger Fehler bei der Pflege von Suchsynonymen ist, zu viele, zu allgemeine Begriffe in eine einzige Gruppe zu packen. Eine Gruppe wie schuh, stiefel, sneaker, sandale behandelt technisch unterschiedliche Produktkategorien als austauschbar, was die Suchergebnisse verwässert, statt sie zu verbessern. Sauberes Synonym-Management bedeutet, nur echte Bezeichnungsvarianten für dasselbe Konzept zu gruppieren, nicht verwandte, aber unterschiedliche Produktarten.

3. Synonyme technisch: OpenSearch-Token-Filter vs. Magento-Sync

Technisch gibt es zwei Ebenen für Suchsynonyme in Magento: die Magento-eigene Synonymverwaltung, die bei jedem Reindex einen synonym-Token-Filter in die OpenSearch-Analyzer-Konfiguration schreibt, und die direkte Bearbeitung dieses Token-Filters auf Index-Ebene. Der Magento-Weg ist der bevorzugte für alle Standardfälle, weil er scope-abhängige Pflege im Admin ermöglicht, ohne dass ein Entwickler eingebunden werden muss.

{
  "settings": {
    "analysis": {
      "filter": {
        "synonym_filter": {
          "type": "synonym",
          "synonyms": [
            "laptop, notebook, ultrabook",
            "kopfhoerer => kopfhörer",
            "handy, smartphone, mobiltelefon"
          ]
        }
      },
      "analyzer": {
        "search_synonym_analyzer": {
          "type": "custom",
          "tokenizer": "standard",
          "filter": ["lowercase", "synonym_filter"]
        }
      }
    }
  }
}

Wichtig für Suchsynonyme auf OpenSearch-Ebene: Der Synonym-Filter sollte nur beim Suchzeitpunkt (search_analyzer) angewendet werden, nicht beim Indexierungszeitpunkt, es sei denn, es ist bewusst gewünscht, dass alle Synonyme dauerhaft im Index landen. Wird der Filter auf beiden Seiten angewendet, potenziert sich die Zahl der gespeicherten Tokens unnötig und die Indexgröße wächst ohne zusätzlichen Nutzen.

4. Mehrdeutige und einseitige Synonyme unterscheiden

Ein oft übersehener Unterschied bei Suchsynonymen ist die Richtung der Zuordnung. Die Kommaschreibweise (a, b, c) erzeugt äquivalente, wechselseitige Synonyme: Eine Suche nach a findet auch b und c, und umgekehrt. Die Pfeilschreibweise (a => b) erzeugt eine einseitige Ersetzung: Eine Suche nach a wird durch b ersetzt, aber nicht umgekehrt.

Diese Unterscheidung ist bei mehrdeutigen Begriffen entscheidend. Ein Beispiel: maus kann sowohl das Tier als auch das Computerzubehör bezeichnen. Eine wechselseitige Synonymgruppe mit maus, computermaus würde bei jeder Suche nach maus auch computermaus-Treffer einblenden, was in einem Elektronikshop meist erwünscht ist. Eine einseitige Ersetzung wäre hier die falsche Wahl, weil sie die ursprüngliche Suchintention verwischt, statt sie zu erweitern. Für echte Tippfehler oder veraltete Schreibweisen, etwa kopfhoerer => kopfhörer, ist die einseitige Ersetzung dagegen die richtige Form, weil die kanonische Schreibweise klar feststeht.

5. Rechtschreibkorrektur: Did-you-mean mit Fuzzy Query

Während Suchsynonyme bekannte Begriffsvarianten abdecken, braucht es für unbekannte Tippfehler eine andere Technik: Fuzzy-Matching und Suggester. OpenSearch bietet dafür die fuzziness-Option in der multi_match-Query sowie einen eigenen phrase-Suggester, der auf Basis der im Index vorhandenen Begriffe Korrekturvorschläge generiert. Für ein klassisches "Meinten Sie...?"-Feature kombiniert man beide: Fuzzy-Matching liefert direkt Ergebnisse trotz Tippfehler, der Suggester liefert den anzuzeigenden Korrekturvorschlag.

{
  "suggest": {
    "did_you_mean": {
      "text": "notebok",
      "phrase": {
        "field": "name.trigram",
        "size": 1,
        "gram_size": 3,
        "direct_generator": [
          {
            "field": "name.trigram",
            "suggest_mode": "always",
            "min_word_length": 4
          }
        ],
        "highlight": {
          "pre_tag": "<em>",
          "post_tag": "</em>"
        }
      }
    }
  }
}

Der phrase-Suggester benötigt ein eigenes Trigram-Feld (name.trigram im Beispiel), das mit einem shingle-Filter aufgebaut wird, um auch mehrwortige Korrekturvorschläge sinnvoll zu bewerten. Für Rechtschreibkorrektur in Magento ist dieses Setup eine Erweiterung, die über die Standard-Suchfunktion hinausgeht, aber gerade bei mobilen Nutzern einen spürbaren Unterschied in der Trefferquote macht.

6. Eigene Synonym-Quellen anbinden (CSV-Import)

Für Kataloge mit vielen Sprachen oder häufig wechselnden Suchsynonymen ist die manuelle Pflege im Admin zeitaufwendig. Eine gängige Erweiterung ist ein CLI-Befehl oder Cronjob, der Synonymgruppen aus einer zentral gepflegten CSV-Datei importiert und über die Magento-API (Magento\Search\Api\SynonymGroupRepositoryInterface) anlegt oder aktualisiert. So können Fachabteilungen, die kein Magento-Backend-Zugriff haben, Synonyme in einer einfachen Tabellenkalkulation pflegen.

<?php

declare(strict_types=1);

namespace Mironsoft\SearchSynonyms\Console\Command;

use Magento\Search\Api\Data\SynonymGroupInterfaceFactory;
use Magento\Search\Api\SynonymGroupRepositoryInterface;
use Symfony\Component\Console\Command\Command;
use Symfony\Component\Console\Input\InputArgument;
use Symfony\Component\Console\Input\InputInterface;
use Symfony\Component\Console\Output\OutputInterface;

/**
 * Imports search synonym groups from a CSV file maintained outside of the admin panel.
 */
final class ImportSynonymsCommand extends Command
{
    /**
     * @param SynonymGroupRepositoryInterface $synonymGroupRepository Repository for saving synonym groups
     * @param SynonymGroupInterfaceFactory $synonymGroupFactory Factory for new synonym group instances
     */
    public function __construct(
        private readonly SynonymGroupRepositoryInterface $synonymGroupRepository,
        private readonly SynonymGroupInterfaceFactory $synonymGroupFactory,
    ) {
        parent::__construct('mironsoft:synonyms:import');
    }

    /**
     * Configures the console command signature.
     *
     * @return void
     */
    protected function configure(): void
    {
        $this->setDescription('Imports synonym groups from a CSV file');
        $this->addArgument('file', InputArgument::REQUIRED, 'Path to the synonyms CSV file');
    }

    /**
     * Reads the CSV file and persists each row as a synonym group.
     *
     * @param InputInterface $input Console input containing the file argument
     * @param OutputInterface $output Console output for progress messages
     * @return int
     */
    protected function execute(InputInterface $input, OutputInterface $output): int
    {
        $handle = fopen((string) $input->getArgument('file'), 'r');

        while (($row = fgetcsv($handle)) !== false) {
            $group = $this->synonymGroupFactory->create();
            $group->setSynonymGroup(implode(',', $row));
            $group->setStoreId(0);
            $this->synonymGroupRepository->save($group);
        }

        fclose($handle);
        $output->writeln('Synonym import completed');

        return Command::SUCCESS;
    }
}

7. Sprachspezifische Herausforderungen: Komposita und Umlaute

Im Deutschen bringen Suchsynonyme eine zusätzliche Schwierigkeit mit sich: zusammengesetzte Wörter (Komposita). Ein Kunde sucht möglicherweise nach "Laufschuh", während der Katalog "Laufschuhe" oder "Running Schuh" schreibt. Ein reiner Synonym-Ansatz auf Wortebene erfasst nicht automatisch alle Kompositavarianten, weshalb ein zusätzlicher decompound-Filter, der zusammengesetzte Wörter in ihre Bestandteile zerlegt, in vielen deutschsprachigen Shops sinnvoll ist.

Umlaute sind eine zweite, oft unterschätzte Fehlerquelle: Kunden auf englischsprachigen Tastaturlayouts tippen häufig kopfhoerer statt kopfhörer. Ein asciifolding-Filter oder gezielte einseitige Suchsynonyme lösen dieses Problem zuverlässig, sofern beide Schreibweisen konsequent in der Synonymliste hinterlegt sind. Ohne diese Behandlung bleiben Umlaut-bedingte Null-Treffer-Suchen eine der häufigsten, aber am einfachsten zu behebenden Fehlerquellen im deutschsprachigen E-Commerce.

8. No-Result-Searches auswerten und Synonyme datengetrieben ergänzen

Die effektivste Methode, Suchsynonyme und Rechtschreibkorrektur laufend zu verbessern, ist eine regelmäßige Auswertung der No-Result-Searches, also aller Suchanfragen, die zu null Treffern geführt haben. Magento speichert diese Anfragen in der Tabelle search_query zusammen mit der Anzahl der Ergebnisse, was eine einfache SQL-Abfrage für eine wöchentliche Review ermöglicht.

-- Top no-result search terms from the last 30 days, ranked by frequency
SELECT
    query_text,
    num_results,
    popularity
FROM search_query
WHERE num_results = 0
  AND updated_at >= DATE_SUB(NOW(), INTERVAL 30 DAY)
ORDER BY popularity DESC
LIMIT 50;

Diese Liste ist die Grundlage für datengetriebenes Synonym-Management: Jeder häufig vorkommende Null-Treffer-Begriff wird manuell geprüft, ob es sich um einen Tippfehler, eine fehlende Bezeichnungsvariante oder tatsächlich ein nicht vorhandenes Produkt handelt. Nur die ersten beiden Fälle erfordern eine Anpassung der Suchsynonyme, der dritte Fall ist ein Sortiments- oder SEO-Thema und keine Suchkonfiguration.

9. Ansätze im direkten Vergleich

Die folgende Tabelle vergleicht Techniken zur Reduzierung von Null-Treffer-Suchen durch Suchsynonyme und Rechtschreibkorrektur.

Kein einzelner Ansatz löst alle Null-Treffer-Fälle. Erst die Kombination aus gepflegten Suchsynonymen, automatischem Fuzzy-Matching und regelmäßiger No-Result-Analyse reduziert die Fehlerquote nachhaltig.

10. Zusammenfassung

Gute Suchsynonyme und zuverlässige Rechtschreibkorrektur lösen zwei unterschiedliche, aber verwandte Probleme: unterschiedliche Begriffe für dasselbe Konzept und unbeabsichtigte Tippfehler. Magentos Search Synonym Groups decken den ersten Fall im Admin ab, Fuzzy-Matching und Phrase-Suggester den zweiten auf OpenSearch-Ebene. Beide Techniken benötigen bewusste Pflege, wechselseitige und einseitige Synonyme sind keine austauschbaren Konzepte.

Der nachhaltigste Weg, Suchsynonyme zu verbessern, ist die regelmäßige Auswertung von No-Result-Searches statt einmaliger, vollständiger Synonymlisten. Wer die häufigsten Null-Treffer-Begriffe monatlich prüft und gezielt Synonyme oder Korrekturregeln ergänzt, senkt die Fehlerquote der Suche kontinuierlich, mit vergleichsweise geringem Pflegeaufwand gegenüber dem Effekt auf die Conversion-Rate.

11. FAQ: Synonyme und Rechtschreibkorrektur in der Magento-Suche