> For the complete documentation index, see [llms.txt](https://docs.codegiganten.de/plugin-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md).

# Suchbegriff-Regeln

Für einzelne Suchbegriffe festlegen, was Kunden sehen, mit Anpinnen, Ausblenden, Hoch- und Herabstufen, Weiterleitung und Banner.

Mit Suchbegriff-Regeln legen Sie für einzelne Suchbegriffe fest, was Ihre Kunden sehen. Eine Regel liest sich wie ein Satz: Wenn ein Kunde nach „grill“ sucht, dann stehen drei Aktionsgrills ganz oben. Sie brauchen Regeln, wenn die automatische Reihenfolge für einen Begriff nicht zu Ihrem Ziel passt, etwa bei Aktionen, bei Begriffen mit Info-Seiten oder bei Produkten, die zu einem Begriff nicht gezeigt werden sollen.

Sie finden die Regeln im Plugin-Dashboard unter **Produkte** im Reiter **Regeln**. Drei Knöpfe wechseln den Unterbereich: „Verlorene Chancen“ (hier starten Sie), „Regeln“ und „Editor“.

{% hint style="info" %}
Suchbegriff-Regeln sind eine Zusatzfunktion, die Sie über Shopware freischalten. Ist sie für Ihren Shop gesperrt, steht oben der Hinweis, dass gespeicherte Regeln erhalten bleiben und nach der Freischaltung wirken. Mit dem Knopf „Jetzt freischalten“ öffnen Sie den Kauf in Shopware. Bis dahin wirken die Regeln nicht in der Suche.
{% endhint %}

## Was eine Regel kann

| Aktion              | Wirkung                                                                  |
| ------------------- | ------------------------------------------------------------------------ |
| „Anpinnen“          | Ausgewählte Produkte stehen ganz oben.                                   |
| „Ausblenden“        | Ausgewählte Produkte erscheinen bei diesem Begriff nicht.                |
| „Hoch-/Herabstufen“ | Hersteller, Kategorien oder Eigenschaften rutschen nach oben oder unten. |
| „Weiterleitung“     | Wer den Begriff abschickt, landet direkt auf einer Zielseite.            |
| „Banner“            | Eine Erlebniswelt erscheint als Banner über den Treffern.                |

Sie können mehrere Aktionen in einer Regel kombinieren. Mindestens eine Aktion muss gesetzt sein.

## Regel anlegen, Schritt für Schritt

1. Öffnen Sie **Produkte** → Reiter **Regeln** → **Regeln** und klicken Sie auf „Neue Regel“. Alternativ starten Sie im „Editor“ oder in „Verlorene Chancen“ mit „Produkte anpinnen“. Dann ist der Begriff schon eingetragen.
2. Im Block „Wenn ein Kunde sucht nach …“ tragen Sie die Suchbegriffe ein, je Zeile oder durch Komma getrennt, zum Beispiel „grill, gasgrill“. Wählen Sie bei „Begriff muss“: „genau so gesucht werden (exakt)“ oder „in der Suche vorkommen (enthält)“.
3. Optional legen Sie unter „Zeitraum festlegen (optional)“ ein „Gültig ab“ und „Gültig bis“ fest, mit Datum und Uhrzeit in Shop-Zeit. Bleibt ein Feld leer, hat der Zeitraum keinen Anfang oder kein Ende. Das Ende muss nach dem Beginn liegen.
4. Im Block „Dann passiert in der Suche …“ wählen Sie über „+ Aktion hinzufügen …“ die Aktionen.
5. Im Block „Allgemein“ vergeben Sie optional einen „Namen“ (nur zur Wiedererkennung, leer = erster Suchbegriff) und die „Priorität“. Der Schalter „Regel aktiv“ nimmt die Regel ein oder aus.
6. Klicken Sie auf „Speichern“. Erst dann wirkt die Regel im Shop.

Die Meldung nach dem Speichern lautet: „Regel gespeichert. Sie wirkt in der Suche nach wenigen Sekunden, auf der Suchergebnisseite spätestens nach zwei Minuten.“ Mit „Zur Liste“ verlassen Sie den Editor. Bei ungespeicherten Änderungen fragt die Oberfläche vorher nach.

### Begriffe und wann sie greifen

* Je Regel sind höchstens 20 Begriffe möglich, je Begriff höchstens 100 Zeichen.
* Groß- und Kleinschreibung, Umlaute („ä“ gleich „ae“), Satzzeichen, Bindestriche und „&“ (gleich „und“) spielen keine Rolle.
* **„exakt“:** Nur genau dieser Begriff löst die Regel aus.
* **„enthält“:** Der Begriff muss als ganzes Wort (oder ganze Wortfolge) in einer längeren Suche vorkommen. „grill“ greift bei „grill zubehör“, aber nicht bei „gasgrill“.
* Die Regel gilt für den Begriff, den der Kunde eingegeben hat. Das gilt auch dann, wenn die Suche bei null Treffern den Begriff lockert oder korrigiert und so doch noch Ergebnisse zeigt.

## Treffer anpinnen

1. Suchen Sie im Feld „Produkt suchen: Name oder Produktnummer“ das Produkt (Lupe oder Enter).
2. Klicken Sie auf „Anpinnen“. Im Editor genügt auch ein Klick auf das Pin-Symbol in der Vorschau oder das Hochziehen des Treffers.
3. Die Reihenfolge unter „Reihenfolge im Shop“ ändern Sie mit „Eins nach oben“. Mit „×“ entfernen Sie ein Produkt.

Angepinnte Produkte stehen ganz oben, egal wie die Suche sonst sortieren würde. Bis zu 24 Produkte sind möglich. Varianten zählen als ein Produkt.

Anpinnen gilt nur bei der Sortierung nach Relevanz. Sortiert der Kunde selbst, zum Beispiel nach Preis, oder filtert er das Produkt weg, gilt das Anpinnen nicht. Beim Blättern stehen die angepinnten Produkte nur auf den ersten Seiten.

## Treffer ausblenden

Suchen Sie das Produkt wie beim Anpinnen und klicken Sie auf „Ausblenden“ (im Editor auch auf das Auge-Symbol). Das Produkt erscheint dann bei diesem Suchbegriff nicht. Im Shop bleibt es unverändert, also in Kategorien, auf der Produktseite und bei anderen Suchbegriffen.

Bis zu 100 Produkte sind je Regel möglich. Ist ein Produkt angepinnt und ausgeblendet, gewinnt das Ausblenden. Die Oberfläche weist darauf hin.

## Hoch- oder herabstufen

Hier verschieben Sie ganze Gruppen von Produkten, zum Beispiel alle Produkte eines Herstellers.

1. Wählen Sie die Aktion „Hoch-/Herabstufen“.
2. Wählen Sie bei „Stufe, wenn alle Bedingungen zutreffen“ eine Stufe:

| Stufe | Wirkung             |
| ----- | ------------------- |
| +3    | stark nach oben     |
| +2    | deutlich nach oben  |
| +1    | leicht nach oben    |
| −1    | leicht nach unten   |
| −2    | deutlich nach unten |
| −3    | stark nach unten    |

3. Legen Sie die Bedingung fest: Wählen Sie das Merkmal unter „Merkmal wählen“ (zum Beispiel „Hersteller“ oder eine Filtergruppe wie Kategorie oder Farbe), den Operator „ist“ oder „ist eines von“ (Werte durch Komma) und den Wert. Die Vorschlagsliste kommt aus Ihren Filterwerten.
4. Mit „+ Bedingung (UND)“ fügen Sie weitere Bedingungen hinzu. Alle müssen zutreffen.
5. Mit „Weitere Stufe“ legen Sie einen weiteren Eintrag an, mit eigener Stufe und eigenen Bedingungen.

Beispiel: Bei „akkuschrauber“ wird die Marke Bosch mit +2 nach oben gestuft und die Kategorie Zubehör mit −2 nach unten.

Die Stufe verschiebt Produkte innerhalb der passenden Treffer. Sie holt keine Produkte in die Liste, die ohnehin nicht zum Suchbegriff passen. Bedingungen, die die Suche nicht auflösen kann (zum Beispiel ein unbekanntes Merkmal), machen den ganzen Eintrag wirkungslos. Es wird nicht stillschweigend breiter gestuft.

## Weiterleitung

Tragen Sie bei der Aktion „Weiterleitung“ ein Ziel ein, zum Beispiel `/versand` oder eine vollständige Adresse. Wer „versand“ eingibt und die Suche absendet (Enter oder Such-Knopf), landet direkt auf Ihrer Versandseite. Beim Tippen zeigt das Such-Overlay weiter normale Treffer. Die Weiterleitung wirkt im Such-Overlay und auf der Suchergebnisseite.

Erlaubte Ziele:

* Pfade in Ihrem eigenen Shop (sie beginnen mit „/“).
* Adressen der Domains Ihrer Verkaufskanäle.
* Fremde Domains nur, wenn sie in der Plugin-Konfiguration unter „Freigegebene externe Domains für Suchbegriff-Weiterleitungen“ stehen, eine Domain pro Zeile.

Andere Ziele werden ignoriert, die Suche läuft dann normal. Beim Speichern prüft das Plugin die Form (http oder https, keine Zugangsdaten, keine Leerzeichen). Sonst meldet es: „Das Weiterleitungsziel ist ungültig. Erlaubt sind Pfade wie /aktion oder http(s)-Adressen.“

Leiten zwei Regeln mit gleicher Priorität denselben Begriff an verschiedene Ziele, warnt die Regelliste vor dem Konflikt.

## Banner

Ein Banner ist eine Erlebniswelt, die über den Suchtreffern erscheint, sobald jemand nach einem Begriff der Regel sucht. Auf der Suchergebnisseite steht sie über der Trefferliste, im Such-Overlay über den Produkttreffern. Das gilt auch, wenn die Suche keine Produkte findet.

So legen Sie ein Banner an:

1. Legen Sie im Shopware-Admin unter **Inhalte → Erlebniswelten** eine Erlebniswelt vom Typ „Landingpage“ oder „Shopseite“ an.
2. Setzen Sie nur einen schmalen Block ein, zum Beispiel ein Bild-Banner oder „Bild mit Text“, gern mit Link. Keine Produkt-Listings und keine hohen Sektionen.
3. Speichern Sie die Erlebniswelt. Eine Zuordnung zu einer Kategorie oder einem Verkaufskanal ist nicht nötig.
4. Wählen Sie in der Regel bei der Aktion „Banner“ die Erlebniswelt aus. „Kein Banner“ nimmt das Banner wieder weg.
5. Speichern Sie die Regel.

Gibt es noch keine passende Erlebniswelt, weist die Oberfläche darauf hin. Wird eine Erlebniswelt später gelöscht, bleibt der Platz leer. Die Regelliste zeigt dann „Die Banner-Seite existiert nicht mehr.“ Mit „Gültig ab“ und „Gültig bis“ steuern Sie Banner zeitlich.

## Der Editor mit Vorher und Nachher

Im „Editor“ steht links das Formular und rechts die Vorschau. Geben Sie einen „Suchbegriff für die Vorschau“ ein und klicken Sie auf „Vorschau“. Die Spalte „Mit Regel“ zeigt, was Ihre Kunden mit der Regel sehen, die Spalte „Ohne Regeln“ zum Vergleich das normale Ergebnis. Passt der Vorschau-Begriff nicht zu den Begriffen der Regel, steht ein Hinweis dort.

* Treffer in „Mit Regel“ ziehen Sie per Drag and Drop nach oben, um sie anzupinnen („Nach oben ziehen zum Anpinnen“).
* Das Pin-Symbol pinnt an oder löst die Anheftung („Nicht mehr anpinnen“), das Auge-Symbol blendet aus.
* Kleine Schilder erklären jeden Treffer, zum Beispiel „angepinnt #1“, „+2 Hersteller: Bosch“, „Text“ (Suchbegriff im Produkt gefunden) oder „KI-Ähnlichkeit“ (inhaltlich ähnlich).
* Hinweise über der Vorschau zeigen eine Weiterleitung, ein Banner (nur mit Namen, nicht als Bild) oder die automatische Rettung bei null Treffern.

## Mehrere Regeln, Priorität und Status

Die Liste „Regeln“ zeigt alle Regeln mit Name, Begriffen, Trefferart, Aktionen, Zeitraum und Status. Mit dem Suchfeld „Regeln durchsuchen“ finden Sie eine Regel schnell. Je Regel gibt es „Bearbeiten“, „Duplizieren“ (die Kopie ist zunächst inaktiv und heißt „… (Kopie)“) und „Löschen“.

| Status     | Bedeutung                                      |
| ---------- | ---------------------------------------------- |
| aktiv      | Die Regel wirkt jetzt.                         |
| geplant    | Der Zeitraum beginnt später.                   |
| abgelaufen | Der Zeitraum ist vorbei.                       |
| inaktiv    | Die Regel ist per Schalter „An“ ausgeschaltet. |

Mit dem Schalter „An“ nehmen Sie eine Regel vorübergehend aus der Suche, ohne sie zu löschen.

### Priorität

Die „Priorität“ ist eine Zahl von −1000 bis 1000, Standard 0. Passen mehrere Regeln auf denselben Begriff, gilt:

* Die höhere Priorität gewinnt. Bei Gleichstand kommt „exakt“ vor „enthält“, danach die ältere Regel.
* Ausblenden und Hoch-/Herabstufen aller passenden Regeln wirken zusammen.
* Angepinnte Produkte werden in dieser Reihenfolge aneinandergehängt, höchstens 24.
* Weiterleitung und Banner kommen nur von der stärksten Regel.

Die Liste warnt bei Widersprüchen, zum Beispiel „Angepinnt und ausgeblendet zugleich“ oder wenn angepinnte Produkte nicht auffindbar sind.

## Grenzen im Überblick

| Einstellung                              | Grenze                               |
| ---------------------------------------- | ------------------------------------ |
| Aktive Regeln je Suchindex (Datenquelle) | 200                                  |
| Begriffe je Regel                        | 20, je Begriff höchstens 100 Zeichen |
| Angepinnte Produkte je Regel             | 24                                   |
| Ausgeblendete Produkte je Regel          | 100                                  |
| Stufen-Einträge je Regel                 | 10, mit je höchstens 10 Bedingungen  |
| Name                                     | höchstens 191 Zeichen                |
| Weiterleitungsziel                       | höchstens 2048 Zeichen               |
| Priorität                                | −1000 bis 1000                       |

Sind 200 aktive Regeln erreicht, deaktivieren Sie zuerst eine Regel.

## Wann Regeln wirken

Anpinnen, Ausblenden und Hoch-/Herabstufen wirken in der Suche nach wenigen Sekunden, auf der Suchergebnisseite spätestens nach zwei Minuten. Regeln mit Zeitraum starten und enden von selbst, mit bis zu 5 Minuten Verzögerung.

## Verlorene Chancen

Die Liste „Verlorene Chancen“ zeigt Suchbegriffe, bei denen Kunden nicht finden, was sie suchen. Oben stehen die Begriffe mit den meisten Suchen. Sie wählen den Zeitraum: 7, 30 (Standard) oder 90 Tage. Daneben steht die „Ø Klickrate im Suchindex“ als Vergleichswert.

Drei Gruppen mit je höchstens 100 Zeilen:

| Gruppe                       | Kriterium                                                                                                |
| ---------------------------- | -------------------------------------------------------------------------------------------------------- |
| „Keine Treffer“              | Kunden suchen danach und finden nichts. Meist fehlt ein Synonym, oder der Begriff meint eine Info-Seite. |
| „Treffer, aber keine Klicks“ | Mindestens 5 Suchen, Treffer vorhanden, aber niemand klickt.                                             |
| „Niedrige Klickrate“         | Mindestens 20 Suchen, mindestens ein Klick, Klickrate unter dem Durchschnitt der Datenquelle.            |

Die Spalten zeigen den Begriff (in der häufigsten Schreibweise, Groß-/Kleinschreibung und Umlaut-Varianten zusammengefasst), die Zahl der Suchen, bei „Niedrige Klickrate“ die Klickrate und den „Möglichen Umsatz“. Der mögliche Umsatz ist die Zahl der Suchen mal dem durchschnittlichen Umsatz je Suche in dieser Datenquelle. Er ist eine grobe Schätzung und kein garantierter Mehrumsatz. Gab es im Zeitraum keinen Umsatz, bleibt das Feld mit einem Strich leer.

Bei „Keine Treffer“ zeigen Schilder, ob die automatische Rettung eingegriffen hat: „gelockert“ (mit mehr Tippfehler-Toleranz gab es doch Treffer), „auto-korrigiert → …“ (ein ähnlicher Begriff wurde gesucht) oder „Ersatzprodukte“ (beliebte Produkte wurden gezeigt). Der Begriff bleibt trotzdem in der Liste, weil Ihr Sortiment ihn noch nicht direkt bedient.

### Ein-Klick-Aktionen je Zeile

* **„Synonym anlegen“:** Es öffnet sich ein Fenster „Synonym für …“, in dem Sie weitere Begriffe durch Komma eintragen, zum Beispiel „Couch, Sofa“. Bei „auto-korrigiert“ ist die Korrektur vorausgefüllt. Meldung: „Synonym angelegt. Es wirkt nach wenigen Sekunden in der Suche.“ Mehr auf der Seite [Synonyme](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/synonyme.md).
* **„Weiterleitung anlegen“:** Sie geben ein Ziel an. Es entsteht eine aktive Regel „Weiterleitung: “ mit „exakt“, die Sie später im Editor ändern können.
* **„Produkte anpinnen“:** Öffnet den Editor mit dem Begriff.
* **„90 Tage ignorieren“:** Die Zeile verschwindet 90 Tage aus der Liste. An der Suche ändert sich nichts. Das eignet sich für Tippfehler, Unsinn oder Begriffe, die Sie bewusst nicht bedienen.
* **Zauberstab-Symbol:** Für den Begriff gibt es schon eine Regel. Ein Klick öffnet sie.

Auch aus der [Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md) führt der Link „Verlorene Chancen bearbeiten“ direkt in diese Liste.

## Beispiele

**Aktion bewerben.** Begriff „grill“, Treffer „enthält“, drei Aktionsgrills angepinnt, ein Banner mit Zeitraum bis Ende August. Wer nach „grill“ oder „grill zubehör“ sucht, sieht oben die Aktion.

**Info-Seite.** Begriff „versand“, exakt, Weiterleitung auf `/versand`. Wer „versand“ abschickt, bekommt die Versandinformationen statt einer Produktliste.

**Produkt bei einem Begriff ausblenden.** Ein Produkt, das zu einem Begriff regelmäßig ungewollt erscheint, blenden Sie bei diesem Begriff aus. Im restlichen Shop bleibt es erreichbar.

**Marke bevorzugen.** Begriff „akkuschrauber“, Hersteller Bosch +2, Zubehör −2.

## Tipps

* Starten Sie mit „Verlorene Chancen“. Die Liste zeigt, wo eine Regel am meisten bringt.
* Prüfen Sie jede neue Regel im „Editor“ mit der Vorschau, bevor Sie speichern.
* Nutzen Sie „Duplizieren“ für ähnliche Regeln. Die Kopie startet inaktiv, Sie können sie in Ruhe anpassen.
* Wählen Sie Zeiträume für Aktionen, damit Regeln von selbst enden.
* Bei Sortierungen wie „Preis“ gilt das Anpinnen nicht. Testen Sie deshalb mit der Sortierung nach Relevanz.

## Weiterlesen

{% content-ref url="/pages/gnVUxo3jg0HO6NiKigX0" %}
[Synonyme](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/synonyme.md)
{% endcontent-ref %}

{% content-ref url="/pages/d5mIc2dVZOIZDCZQW1u1" %}
[Produkte im Dashboard](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/produkte-im-dashboard.md)
{% endcontent-ref %}

{% content-ref url="/pages/X477UQ3qyxb8nuVOceWJ" %}
[Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md)
{% endcontent-ref %}

{% content-ref url="/pages/EFhYbJhqfikKs7df9Kz1" %}
[Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchbegriff-regeln.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
