> 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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/fehlersuche-und-faq.md).

# Fehlersuche und häufige Fragen

Typische Probleme mit Cross Selling Pro und wie Sie sie Schritt für Schritt prüfen und lösen.

Etwas erscheint nicht, zeigt die falschen Produkte oder die Zahlen fehlen? Auf dieser Seite finden Sie die häufigsten Fälle mit den Prüfschritten in sinnvoller Reihenfolge. Fangen Sie oben an und gehen Sie die Punkte der Reihe nach durch.

{% hint style="info" %}
Viele Fragen lassen sich schneller mit der Vorschau in der Vorlage oder der Empfehlungs-Sandbox unter **Produkte & Daten → Produkte** klären. Dort sehen Sie, welche Filter gegriffen haben und warum ein Produkt empfohlen wurde.
{% endhint %}

## Der Block oder Slider erscheint gar nicht

Wichtig vorab: Ein Block ohne Ergebnis wird **aus der Seite entfernt**. Das gilt auch bei einem Fehler. Es gibt keine Meldung und keine leere Fläche. Nur der Conversion Booster zeigt in diesem Fall „Keine Empfehlungen verfügbar.“

Prüfen Sie in dieser Reihenfolge:

1. **Paket:** Ist der Typ oder das Layout in Ihrem Paket enthalten? Nicht gebuchte Typen und Layouts werden im Shop ohne Meldung nicht angezeigt. Im Erlebniswelten-Editor steht dann „Wird nicht ausgespielt“. Ihr Paket sehen Sie unter **System → Pakete**.
2. **Ausspielort:** Bei Offcanvas und Warenkorbseite je Verkaufskanal „Aktivieren“ und „Empfehlungs-Vorlage“ prüfen. Achten Sie auf die Vererbung von „Alle Verkaufskanäle“.
3. **Kein Ausgangsprodukt:** „Automatisch (PDP)“ findet auf Seiten ohne Produkt (Startseite, Kategorie, Landingpage) nichts. Im Kundenkonto weichen Vorlagen mit Ausgangsprodukt auf persönliche Empfehlungen oder Bestseller aus.
4. **Zu wenige Daten:** „Oft zusammen gekauft“ braucht Bestellungen, persönliche Typen wie „Zuletzt Angesehen“ oder „Weitermachen wo du aufgehört hast“ brauchen Tracking, die Wunschliste braucht gemerkte Artikel. Setzen Sie eine Fallback-Schwelle (siehe unten).
5. **Alles herausgefiltert:** harte Filter, „Nur gleiche Marke“ bei Produkten ohne Marke, Regeln. Die Vorschau der Vorlage markiert die Regel, die nichts übrig lässt.
6. **Ausschlüsse:** Das aktuelle Produkt, seine Varianten und im Warenkorb alle Warenkorb-Produkte samt Varianten werden immer ausgeschlossen.
7. **Sichtbarkeit:** Mit „Nur Produkte zeigen, die der Kunde sehen darf“ (Standard an) fallen Produkte weg, die der Kunde im Shop nicht sehen darf.
8. **Kontingent:** Nur im Paket Basic stoppen die Empfehlungen bis Monatsende, wenn das Kontingent erreicht ist. Den Verbrauch sehen Sie unter **System → Pakete**.
9. **Produktdaten fehlen:** Unter **Produkte & Daten → Quellen** prüfen, ob die Quelle indiziert ist. Unter **System → Einstellungen** prüfen, ob Verkaufskanal und Sprache eine Quelle zugeordnet haben.
10. **Mobil:** Auf der Warenkorbseite ist vielleicht „Auf Mobilgeräten ausblenden“ an, im Offcanvas „Auf Mobile aktivieren“ aus.
11. **Browser:** Öffnen Sie die Entwicklertools. Werden Anfragen an InsightSearch von einer Content-Security-Policy oder einem Werbeblocker blockiert? Gibt es Skriptfehler eines Themes?

## Der Slider ist manchmal leer, manchmal nicht

Stellen Sie im Element einen Ersatz ein:

| Einstellung             | Wirkung                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------- |
| „Fallback-Schwelle (≤)“ | Der Ersatz greift, wenn die Zahl der Empfehlungen **kleiner oder gleich** diesem Wert ist (0 bis 50) |
| „Fallback-Typ“          | „Kein Fallback“, „Andere Vorlage“, „Feste Produkte“ oder „Dynamische Produktgruppe“                  |

Beispiel: Limit 6, Fallback-Schwelle 3, Ersatz „Andere Vorlage“ mit Bestsellern. Eine Ersatz-Vorlage mit einem Typ, der nicht in Ihrem Paket ist, wird nicht verwendet.

## Es erscheinen unpassende Produkte

* Wählen Sie in der Vorlage einen engeren Modus, etwa „Nur gleiche Kategorie“. Findet er zu wenig, weicht er auf die übergeordnete Kategorie aus. Die Sandbox zeigt das als gelockert an.
* Schränken Sie mit dem Regel-Baukasten ein (ab Paket Experte), schließen Sie Varianten aus oder nutzen Sie den Produkttyp „Gleicher Typ“ (Beta, nach Freischaltung).
* Wählen Sie ein passendes Gewichtungsprofil. „Warum empfohlen?“ in der Sandbox zeigt, welches Signal den Ausschlag gab.
* Seit Version 2.2.1 rechnet InsightSearch Filter, Booster und Kaufsignale zusammen mit der KI-Ähnlichkeit. Empfehlungen können sich dadurch verändert haben.
* Standardsätze in Produktbeschreibungen können die KI-Ähnlichkeit verschlechtern. Im Bereich **Produkte & Daten → KI** gibt es dafür die Einstellung „Beschreibung für KI-Ähnlichkeit“.

## Das Produkt selbst oder Warenkorb-Produkte werden empfohlen

Seit Version 2.2.1 bzw. 1.4.1 sollte das nicht mehr passieren. Die aktuelle Produktseite ist immer ausgeschlossen, im Warenkorb, im Offcanvas und auf der Zwischenseite auch alle Warenkorb-Produkte samt Varianten. Auf Produktseiten können Sie zusätzlich „Warenkorb-Produkte ausschließen“ in der Vorlage einschalten (Standard aus). Tritt es trotzdem auf, prüfen Sie Ihre Plugin-Version.

## Änderungen kommen nicht im Shop an

* **Datenfeld geändert:** Starten Sie danach „Produktdaten neu einlesen“.
* **Produktdaten geändert:** Die Änderung wirkt nach der nächsten Übertragung. Beim Feed muss Shopware den Export neu erzeugt haben.
* **Ausspielort oder Bundle/Set-Vorlage geändert, Seite zwischengespeichert:** Leeren Sie den Shop-Zwischenspeicher.
* **Empfehlungs-Vorlage geändert:** wirkt sofort, betroffene Seiten werden beim Speichern verworfen.

Eine Übersicht finden Sie unter [Wann wirkt eine Änderung?](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/wann-wirkt-eine-aenderung.md).

## Die Statistik ist leer oder unvollständig

1. **Hintergrundverarbeitung:** Warenkorb, Bestellungen und Klicks gehen über die Hintergrundverarbeitung von Shopware an InsightSearch. Sie muss dauerhaft laufen und alle Warteschlangen abarbeiten, die das Plugin nutzt. Stauen sich Ereignisse länger als 24 Stunden, zeigt das Plugin-Dashboard einen Hinweis mit dem passenden Befehl. Details unter [Technik und Betrieb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/technik-und-betrieb.md).
2. **Einwilligung:** Steht „Ereignisse aus dem Browser“ auf „Nur mit Einwilligung“, fehlen Einblendungen und Klicks von Besuchern ohne Komfort-Cookie. Bei „Aus“ fehlen sie ganz.
3. **Bestell-Tracking:** Ist „Bestell-Tracking aktivieren“ an und hat der Verkaufskanal mit seiner Sprache eine Quelle zugeordnet?
4. **Rechte:** Statistik und Nutzer-Tracking brauchen das Recht „Bestellungen ansehen“.
5. **Paket:** Die volle Statistik gibt es ab Paket Experte. Klickrate und Umsatz-Tracking gibt es ab Starter.
6. **Kauf auf Rechnung:** Werden Zahlungen nie als bezahlt bestätigt, wählen Sie bei „Transaktionsstatus die als "bezahlt" gelten“ zusätzlich „Offen“. Fehlen ältere Bestellungen, nutzen Sie unter **Produkte & Daten → Quellen** „Synchronisieren“ oder „Zahlstatus neu berechnen“.
7. **Fremdwährung:** Die Kachel im Admin-Dashboard zählt nur die Hauptwährung und weist darauf hin.
8. **Weniger Einblendungen als früher:** Eine Einblendung zählt erst, wenn mindestens die Hälfte der Empfehlung sichtbar ist, einmal je Seitenaufruf. Niedrigere Zahlen als in alten Versionen sind deshalb normal.
9. **Bruch am Update-Tag:** Mit dem Update auf 2.2.1 bzw. 1.4.1 beginnt die Zählung der Sitzungen neu.

## Der cogi Commander zeigt nichts oder andere Zahlen

* Ist der Commander installiert und aktiv? Ist dort „Von cogi-Suite-Plugins gemeldete Touchpoints sammeln“ an?
* Einblendungen und Klicks erscheinen nur, wenn Cross Selling Pro verbunden ist.
* Ältere Zeiträume lassen sich nur für Bestellungen und Umsatz nachtragen, per Befehl (siehe [Technik und Betrieb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/technik-und-betrieb.md)).
* Abweichungen zur Statistik im Plugin-Dashboard sind normal. Es sind zwei getrennte Zählungen. Im Commander werden Stornierungen nicht abgezogen.

## Printess-Produkte landen ohne Gestaltung im Warenkorb oder öffnen immer die Produktseite

* In der Karte „Printess“ müssen „Printess-Produkte unterstützen“ und „Editor im Modal öffnen“ an sein. Ist das Modal aus, geht es auf die Produktseite.
* Haben Sie einen eigenen Konfigurator mit ausgeschaltetem „Konfigurator im Modal öffnen“ eingerichtet, öffnen alle Konfigurator-Produkte auf der Produktseite, auch Printess.
* Vor Version 2.1.9 führte jede Printess-Empfehlung auf die Produktseite. Aktualisieren Sie in diesem Fall das Plugin.
* Aus Empfehlungen heraus lässt sich ein Konfigurator-Produkt ohne Gestaltung nicht kaufen. Der Shop zeigt dann einen Hinweis im Warenkorb.

## Meilenstein-Produkte erscheinen nicht

Prüfen Sie: Fortschrittsbalken ab 2.5.0 (Shopware 6.7) bzw. 1.4.0 (Shopware 6.6) installiert, aktiv und eingeschaltet. Meilenstein unter **Ausspielung → Ausspielorte → Meilenstein** eingeschaltet. Am Ausspielort ist eine Vorlage aktiv. Paket ab Starter. Der Warenkorb ist nicht leer und das Ziel noch nicht erreicht. Es gibt Produkte im passenden Preisfenster. Varianten mit „ab“-Preis zählen nicht. Mehr unter [Meilenstein-Empfehlungen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/meilenstein-empfehlungen.md).

## „Passt zu …“ oder die Ersatzprodukte fehlen in der Suche

* Cross Selling Pro ist aktiv, verbunden und hat für Verkaufskanal und Sprache eine Quelle.
* Die Schalter im Such-Plugin sind an.
* Ersatzprodukte gibt es erst ab Paket Starter. Im Basic kann zudem das Kontingent erschöpft sein.
* Bei einer gelockerten oder korrigierten Suche kommen keine Ersatzprodukte aus Cross Selling Pro.
* Zeigen Sie bei null Treffern eine eigene Erlebniswelt, muss „Ersatzprodukte zusätzlich zur CMS-Seite bei Suchen ohne Ergebnisse“ an sein.
* Antwortet Cross Selling Pro nicht rechtzeitig (etwa 1,5 Sekunden im Overlay, eine Sekunde auf der Ergebnisseite), bleibt es bei den normalen Ersatzprodukten.

Mehr unter [Zusammenspiel mit anderen Plugins](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/zusammenspiel-mit-anderen-plugins.md).

## Die Checkout-Zwischenseite erscheint nie

* Ist „Zwischenseite mit Empfehlungen aktivieren“ für diesen Verkaufskanal an?
* Ist eine „Erlebniswelt für die Zwischenseite“ gewählt?
* Wurde die Regel in „Nur bei dieser Regel“ gelöscht? Eine gelöschte Regel trifft nie zu. Wählen Sie eine andere Regel oder leeren Sie das Feld.
* Trifft die Regel auf Ihren Test-Warenkorb wirklich zu?

## Der Feed lässt sich nicht abholen

Das Plugin nennt im Admin die Ursache und einen Lösungsvorschlag. Häufige Fälle:

| Ursache                                                                       | Typische Lösung                                                                     |
| ----------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| Anmeldung nötig, Zugriff verboten (Passwort, IP-Sperre, Firewall, Bot-Schutz) | Feed-Adresse freigeben oder Push wählen (nur DEV und Stage)                         |
| Nicht gefunden                                                                | Export gelöscht oder deaktiviert, Zugriffsschlüssel oder Domain geändert            |
| Zeitüberschreitung                                                            | Export per geplanter Aufgabe erzeugen statt beim Abruf                              |
| Domain nicht auflösbar                                                        | Interne Domain: Push wählen                                                         |
| Zertifikat ungültig                                                           | Abgelaufenes oder selbst signiertes Zertifikat erneuern                             |
| Kein gültiger Feed oder leer                                                  | Vorlage des Exports prüfen, Produkte im Kanal sichtbar machen, Produktgruppe prüfen |

Erster Test: Öffnen Sie die Feed-Adresse in einem privaten Browserfenster. Erscheint dort kein XML, kann InsightSearch den Feed auch nicht lesen.

## Der Push hängt

1. Läuft die Hintergrundverarbeitung von Shopware dauerhaft?
2. Laufen die geplanten Aufgaben? Hängende Pakete werden automatisch neu eingereiht. Das kann bis zu 15 Minuten dauern.
3. Prüfen Sie das Speicherlimit des Workers und ob Ihr Dienst ihn nach einem Ende neu startet.
4. Nutzen Sie im Admin „Neu starten“ oder „Abbrechen“.
5. Meldet der Push, dass keine Produkte gefunden wurden, prüfen Sie Produktgruppe und Sichtbarkeit im Verkaufskanal.

## Hinweis „Empfehlungsindizes wurden gelöscht“

Ihr Shop hat längere Zeit kein Lebenszeichen gesendet, meist weil die geplanten Aufgaben nicht liefen. Bringen Sie die geplanten Aufgaben zum Laufen und starten Sie „Produktdaten neu einlesen“.

## Weiterlesen

{% content-ref url="/pages/enEkOGiDkia4Xa21DEfe" %}
[Technik und Betrieb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/technik-und-betrieb.md)
{% endcontent-ref %}

{% content-ref url="/pages/6k1qZUWCUdvgoVMAXycx" %}
[Wann wirkt eine Änderung?](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/wann-wirkt-eine-aenderung.md)
{% endcontent-ref %}

{% content-ref url="/pages/lGb76fhkkiwOWRoCEwJe" %}
[Praxis-Anleitungen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/praxis-anleitungen.md)
{% endcontent-ref %}

{% content-ref url="/pages/feLEn8eidOb5LUUtR1fr" %}
[Vorschau und Sandbox](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorschau-und-sandbox.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/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/fehlersuche-und-faq.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.
