> 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/erste-schritte.md).

# Erste Schritte

Checkliste für die Zeit nach der Einrichtung, in sinnvoller Reihenfolge, mit Links zu den Seiten.

Der Wizard hat Ihre Produkte eingelesen, die Suche läuft. Mit den folgenden Schritten bringen Sie sie auf ein gutes Niveau. Arbeiten Sie die Liste der Reihe nach ab. Jeder Punkt braucht nur wenige Minuten und verweist auf die Seite mit den Einzelheiten.

## Aufgabenliste

### 1. Suche aktivieren

Der Wizard schaltet die Suche am Ende selbst ein. Prüfen Sie es trotzdem: Öffnen Sie die Plugin-Konfiguration, Karte „Sucheinstellungen“, und kontrollieren Sie den Schalter „Suche aktivieren“. Die Einstellungen gelten je Verkaufskanal, „Alle Verkaufskanäle“ vererbt sie an alle Kanäle. Ist die Suche aus, sehen Ihre Kunden weiter die Shopware-Suche.

Mehr dazu: [Plugin-Konfiguration](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/plugin-einstellungen.md)

### 2. Sprachen zuordnen

Die Suche zeigt in einer Sprache nur dann Treffer, wenn dafür eine Datenquelle zugeordnet ist. Der Wizard legt die Zuordnung für die gewählte Sprache selbst an. Haben Sie weitere Sprachen oder Verkaufskanäle, ordnen Sie diese im Bereich „Einstellungen“ in der Karte „Sprachen einzelnen Datenquellen zuordnen“ zu. Pro Verkaufskanal kann eine Sprache nur einem Feed zugeordnet werden.

Mehr dazu: [Sprachzuordnung und Untertitel](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.md)

### 3. Produktdaten prüfen

Sehen Sie im Bereich „Quellen“ nach, ob Ihre Datenquelle den Status „Synchron“ hat und die erwartete Zahl an Produkten zeigt. Im Bereich „Produkte“ finden Sie unter „Datenqualität“ Hinweise auf unvollständige Produktdaten, zum Beispiel Varianten ohne Gruppen-Kennung. Fehlen Felder wie Marke oder Kategorie, aktivieren Sie sie über „Datenfelder bearbeiten“ und lesen die Produkte danach mit „Produktdaten neu einlesen“ neu ein.

Mehr dazu: [Quellen (Indizes)](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/indizes.md), [Datenfelder bearbeiten](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/feed-template-editor.md), [Produkte im Dashboard](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/produkte-im-dashboard.md)

### 4. Aktivierungsmodus wählen

Der Aktivierungsmodus bestimmt, wie sich das Such-Fenster öffnet. Sie finden ihn in der Plugin-Konfiguration, Karte „Sucheinstellungen“, unter „Aktivierungsmodus der Suche“. Vorgabe ist „Shopware Standard Suchfeld nutzen“. Die weiteren Modi sind „Suchfeld immer sichtbar“, „Aktivierung über externen Trigger“ und „Aktivierung über Such-Button“. Der Standard passt für die meisten Themes. Hat Ihr Theme kein Suchfeld oder ein ungewöhnlich aufgebautes, probieren Sie einen anderen Modus.

Mehr dazu: [Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md)

### 5. Suche im Shop testen

Öffnen Sie Ihren Shop und suchen Sie nach typischen Begriffen: Produktnamen, Marken, Artikelnummern, ein Wort mit Tippfehler. Probieren Sie das Such-Overlay und die Suchergebnisseite aus, am Rechner und am Handy. Wenn Sie Einstellungen vergleichen möchten, hilft die „Such-Sandbox“ im Bereich „Produkte“. Auch die Suchstrategie ist einen Blick wert: „Standard“ ist ausgewogen, „Präzise“ eignet sich für Artikelnummern in Fachshops, „Explorativ“ liefert möglichst viele Treffer.

Mehr dazu: [Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md), [Suchergebnisseite](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suchergebnisseite.md), [Suche auf dem Handy](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-auf-dem-handy.md)

### 6. Filter einrichten

Filter helfen Kunden, Treffer einzugrenzen. Sie bauen auf Datenattributen auf. Prüfen Sie im Bereich „Datenattribute“, dass die gewünschten Attribute „Aktiv“ sind, und legen Sie dann im Bereich „Filter“ Ihre Filter an: Name, Darstellung als Liste oder Schieberegler, Position. Änderungen an Filtern können bis zu 5 Minuten dauern.

Mehr dazu: [Filter](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/filter.md), [Datenattribute](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenattribute.md)

### 7. Synonyme anlegen

Kunden suchen nicht immer so, wie Ihre Produkte heißen. Legen Sie im Bereich „Synonyme“ gleichwertige Begriffe an, zum Beispiel `Pullover, Sweatshirt, Hoodie`, oder eine einseitige Zuordnung wie `Hose, Jeans => Pants`. Neue und geänderte Synonyme wirken nach kurzer Zeit.

Mehr dazu: [Synonyme](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/synonyme.md)

### 8. Rettung bei null Treffern einstellen

Wenn nichts gefunden wird, kann die Suche es gelockert noch einmal versuchen, Tippfehler korrigieren und Ersatzprodukte zeigen. Die Schalter dafür liegen in der Plugin-Konfiguration in der Karte „Keine Treffer & verwandte Treffer“. Die meisten sind ab Werk eingeschaltet. Prüfen Sie, ob die Vorgaben zu Ihrem Shop passen.

Mehr dazu: [Keine Treffer](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/keine-treffer.md)

### 9. Statistik ansehen

Nach einigen Tagen mit Besuchern zeigt die Statistik, wonach gesucht wird, welche Suchen ohne Treffer bleiben und wie viel Umsatz über die Suche entsteht. Besonders nützlich ist die Liste der Suchen ohne Treffer: Daraus lassen sich neue Synonyme ableiten. Die Statistik sehen nur Admin-Benutzer, die Bestellungen ansehen dürfen.

Mehr dazu: [Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md), [Berechtigungen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/berechtigungen.md)

### 10. Design anpassen

Zum Schluss passen Sie Aussehen und Anordnung von Such-Overlay und Ergebnisseite an Ihr Theme an: Layout der Suchergebnisse, Farben, Anzeige von Bildern und Preisen. Diese Einstellungen liegen ebenfalls in der Plugin-Konfiguration.

Mehr dazu: [Design anpassen](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/design-anpassen.md)

{% hint style="success" %}
Sie müssen nicht alles an einem Tag erledigen. Mit den Punkten 1 bis 5 ist die Suche bereits gut nutzbar. Die übrigen Punkte verbessern sie Schritt für Schritt, am besten anhand der Statistik.
{% endhint %}

## Weiterlesen

{% content-ref url="/pages/OXAoj5NTuVjQy9UJJi7n" %}
[Die Suche im Shop](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/suche-im-shop.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/IRaJNiR83at8tpKODJsz" %}
[Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.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/erste-schritte.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.
