> 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/faq-and-haufige-probleme.md).

# FAQ und häufige Probleme

Antworten auf häufige Fragen zur Suche mit Verweisen auf die Seiten, die das Thema ausführlich behandeln.

Hier finden Sie kurze Antworten auf Fragen, die im Alltag am häufigsten auftauchen, und den Weg zur Seite mit allen Einzelheiten. Wenn Sie ein Problem lösen wollen, beginnen Sie bei der [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md).

## Frage und Antwortseite

| Frage                                                   | Antwortseite                                                                                                                                                                                                   |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Wie lange dauert es, bis Änderungen sichtbar sind?      | [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md)                                                                                        |
| Warum finde ich ein Produkt nicht?                      | [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md)                                                                                        |
| Kann ich die Suche pro Sprache einstellen?              | [Sprachzuordnung](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.md)                                                         |
| Warum erscheint die Shopware-Suche statt InsightSearch? | [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md)                                                                                        |
| Das Einlesen des Produktfeeds schlägt fehl. Was tun?    | [Das Einlesen des Produktfeeds schlägt fehl](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/faq-and-haufige-probleme/das-einlesen-des-produktfeeds-schlagt-fehl.md) |
| Wie bringe ich eine Stage-Umgebung in die Suche?        | [Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md)                                                                                  |
| Die Indexierung bleibt bei 96 Prozent stehen            | [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md)                                                                  |
| Was passiert, wenn das Kontingent erreicht ist?         | [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md)                                                                                        |
| Wie werden Käufe der Suche zugeordnet?                  | [Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md)                                                                                            |
| Braucht die Suche ein Cookie?                           | [Datenschutz](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenschutz.md)                                                                                        |
| Welche Befehle brauche ich als Agentur?                 | [Befehle](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/befehle.md)                                                                                                |

## Häufige Fragen

### Wie lange dauert es, bis Änderungen sichtbar sind?

Das hängt vom Weg ab. Beim Pull-Feed erscheinen Änderungen am Produkt nach dem nächsten Export-Lauf von Shopware und dem nächsten Abruf. Mit „Produktdaten neu einlesen“ im Bereich „Quellen“ geht es sofort. Beim Push bringt der Live-Abgleich Änderungen nach etwa zwei Minuten in die Suche, sonst gilt der nächste Push. Filter-Einstellungen wirken nach bis zu 5 Minuten. Die Tabelle dazu steht unter [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md#anderungen-sind-nicht-sichtbar).

### Warum finde ich ein Produkt nicht?

Meist ist das Produkt in Shopware inaktiv, im Verkaufskanal nicht sichtbar oder durch den Filter der dynamischen Produktgruppe ausgeschlossen. Prüfen Sie außerdem, ob Sie nach der Änderung die Produktdaten neu eingelesen haben. Die Checkliste finden Sie unter [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md#produkte-fehlen).

### Kann ich die Suche pro Sprache einstellen?

Ja. Sie ordnen jeder Sprache eines Verkaufskanals eine Datenquelle zu. Die Zuordnung gilt genau für diese Kombination aus Verkaufskanal und Sprache. Fehlt sie, bleibt die Shopware-Suche. Lesen Sie dazu [Sprachzuordnung und Untertitel](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/einstellungen/allgemeine-einstellungen.md).

### Warum erscheint die Shopware-Suche statt InsightSearch?

Entweder ist „Suche aktivieren“ aus, oder für den Verkaufskanal und die Sprache fehlt die Zuordnung. Auch eine Störung auf dem Server-Weg schaltet kurz auf die Shopware-Suche um. Die Prüfschritte stehen unter [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md#die-suche-zeigt-shopware-ergebnisse).

### Warum schlägt das Einlesen des Feeds fehl?

Häufige Ursachen sind ein Passwortschutz, eine Firewall, der Wartungsmodus oder ein leerer Produktexport. Unser Suchsystem ruft den Feed über das Internet ab, deshalb muss er ohne Anmeldung erreichbar sein. Alle Fehlerarten stehen unter [Das Einlesen des Produktfeeds schlägt fehl](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/faq-and-haufige-probleme/das-einlesen-des-produktfeeds-schlagt-fehl.md).

### Wie bringe ich eine Stage-Umgebung in die Suche?

Nutzen Sie für Stage und Entwicklung den Modus Push: Der Shop sendet die Produkte selbst, die Stage muss von außen nicht erreichbar sein. Dafür muss die Hintergrundverarbeitung von Shopware dauerhaft laufen. Mehr unter [Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.md) und [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

### Die Indexierung bleibt bei 96 Prozent stehen. Was tun?

Meist läuft kein Worker, oder er hat zu wenig Speicher. Das Plugin reiht hängende Pakete nach einigen Minuten selbst neu ein. Läuft gar kein Worker, gilt der Lauf nach einer Stunde als fehlgeschlagen und lässt sich neu starten. Prüfen Sie, ob ein Worker läuft, siehe [Push und Live-Abgleich](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/push-und-live-abgleich.md).

### Was passiert, wenn das Kontingent der Suchanfragen erreicht ist?

Bei Erreichen des Limits finden keinerlei Einschränkungen oder automatische Mehrkosten statt. Bei übermäßiger Überschreitung treten wir mit Ihnen in Kontakt, um gemeinsam eine Lösung zu finden. Der Shopping-Assistent (Beta) wird bei verbrauchtem Kontingent bis zum Monatsersten ausgeblendet. Siehe [Fehlersuche](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/fehlersuche.md#kontingent-erreicht).

### Wie werden Käufe der Suche zugeordnet?

Ein Kauf zählt je gekauftem Produkt (oder dessen Variante) als Umsatz über die Suche, wenn dieses Produkt in der Suche angeklickt oder von dort in den Warenkorb gelegt wurde. Zwischen Klick und Bestellung dürfen bis zu 72 Stunden liegen, im selben Browser. Mehr unter [Statistik](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/statistik.md).

### Braucht die Suche ein Cookie?

Das Plugin nutzt ein Cookie zur Wiedererkennung, aber nur nach Zustimmung im Cookie-Banner. Ohne Zustimmung funktioniert die Suche trotzdem, es gibt dann nur keine Wiedererkennung über mehrere Besuche. Einzelheiten und Hinweise für Ihre Datenschutzerklärung stehen unter [Datenschutz](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/datenschutz.md).

## Weiterlesen

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

{% content-ref url="/pages/6FkPYe3rryaW0kzcPtOe" %}
[Das Einlesen des Produktfeeds schlägt fehl](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/faq-and-haufige-probleme/das-einlesen-des-produktfeeds-schlagt-fehl.md)
{% endcontent-ref %}

{% content-ref url="/pages/SjGrQJy19tWx34BxWnlQ" %}
[Stage und Live](https://docs.codegiganten.de/plugin-documentation/apps/suche-intelligent-und-ki-optimiert/stage-und-live.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/faq-and-haufige-probleme.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.
