> 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/zusammenspiel-mit-anderen-plugins.md).

# Zusammenspiel mit anderen Plugins

Wie Cross Selling Pro mit dem Such-Plugin InsightSearch, dem cogi Commander, dem Fortschrittsbalken, Konfigurator-Plugins und Themes zusammenarbeitet.

Cross Selling Pro arbeitet für sich allein. Einige Plugins im selben Shop ergänzen es aber sinnvoll: das Such-Plugin InsightSearch, der cogi Commander als Kennzahlen-Übersicht, der Fortschrittsbalken und Plugins für gestaltbare Produkte. Diese Seite zeigt, was jeweils passiert, welche Voraussetzungen gelten und wo Sie es einstellen.

{% hint style="info" %}
Cross Selling Pro braucht das Such-Plugin **nicht**. Alle hier beschriebenen Kombinationen sind freiwillig. Fehlt ein Plugin, verhält sich Cross Selling Pro ganz normal.
{% endhint %}

## Such-Plugin InsightSearch

Ist das Such-Plugin InsightSearch im selben Shop installiert, kann die Suche Produkte aus Cross Selling Pro anzeigen. Es gibt zwei Funktionen. Beide stellen Sie im **Such-Plugin** ein, im Admin von Cross Selling Pro gibt es dafür keine Einstellung.

### Ersatzprodukte bei Suchen ohne Treffer

Findet eine Suche nichts, fragt die Suche Cross Selling Pro nach Produkten, die zum Suchbegriff passen. Grundlage ist die KI-Ähnlichkeit der Produkte.

* **Im Such-Overlay** erscheinen diese Produkte nur, wenn die Suche selbst nichts retten konnte. Eine gelockerte oder korrigierte Suche hat Vorrang. Kommt nach etwa 1,5 Sekunden keine Antwort, bleiben die normalen Ersatzprodukte der Suche stehen.
* **Auf der Suchergebnisseite** wartet die Suche höchstens eine Sekunde. Bei einem Fehler bleiben ebenfalls die normalen Ersatzprodukte.
* Zeigen Sie bei null Treffern eine eigene Erlebniswelt, kommen die Produkte nur dazu, wenn in der Suche „Ersatzprodukte zusätzlich zur CMS-Seite bei Suchen ohne Ergebnisse“ eingeschaltet ist.
* Die Anzahl richtet sich nach „Anzahl Ersatzprodukte“ der Suche. Die Überschrift im Shop lautet „Das könnte Sie interessieren“.
* Gesendet werden nur die Fläche und der Suchbegriff, keine Kundenkennung. Diese Ersatzprodukte sind deshalb nicht persönlich.

{% hint style="info" %}
Ersatzprodukte aus Cross Selling Pro gibt es ab Paket Starter. Im Paket Basic bleibt es bei den normalen Ersatzprodukten der Suche.
{% endhint %}

### „Passt zu …“ im Such-Overlay

Nach den Treffern lädt das Overlay bis zu vier ergänzende Produkte zum **ersten** Treffer. Die Überschrift lautet „Passt zu“ und dann der Produktname. Produkte, die schon als Treffer zu sehen sind, erscheinen dort nicht.

* Pro Suchanfrage gibt es einen Abruf. Tippt der Besucher weiter, wird der alte Abruf abgebrochen.
* Kommt nichts oder dauert es länger als etwa 1,5 Sekunden, erscheint der Bereich nicht.
* Einen Warenkorb-Knopf zeigen die Karten nur, wenn in der Suche „In-den-Warenkorb-Button im Such-Overlay“ an ist. Bei Varianten steht „Auswählen“.
* Diese Funktion nutzt den Typ „Ähnliche Produkte“ und ist schon im Paket Basic enthalten.

### Voraussetzungen für die Kopplung

Die Suche schaltet beide Funktionen nur frei, wenn alles Folgende zutrifft:

1. Cross Selling Pro ist installiert **und aktiv**.
2. Cross Selling Pro ist verbunden, der Einrichtungsassistent ist also abgeschlossen.
3. Für den Verkaufskanal und die Sprache des Besuchers ist eine Quelle zugeordnet. Das stellen Sie im Plugin-Dashboard von Cross Selling Pro unter **System → Einstellungen** in der Sprachzuordnung ein.
4. Die jeweilige Funktion ist in der Suche eingeschaltet und im Paket enthalten.

Trifft etwas davon nicht zu, sieht der Besucher im Shop nichts davon: keine leere Fläche, kein Platzhalter. Suchmaschinen und Crawler bekommen diese Produkte grundsätzlich nicht.

### Einstellungen im Such-Plugin

Sie finden die Schalter unter **Erweiterungen → Meine Erweiterungen → InsightSearch (Such-Plugin) → Konfigurieren**.

| Einstellung                                               | Karte                               | Wirkung                                                           | Standard |
| --------------------------------------------------------- | ----------------------------------- | ----------------------------------------------------------------- | -------- |
| „„Passt dazu“ im Such-Overlay“                            | „Sucheinstellungen“                 | Zeigt ergänzende Produkte zum ersten Treffer im Overlay           | an       |
| „Ersatzprodukte aus Cross-Selling Pro - KI Cross Selling“ | „Keine Treffer & verwandte Treffer“ | Holt Ersatzprodukte bei Suchen ohne Treffer aus Cross Selling Pro | an       |

Ist die Kopplung nicht gegeben, zeigt die Suche die Schalter als „aus“ und gesperrt, mit einem Hinweis, was fehlt. Ihr gespeicherter Wert bleibt dabei erhalten. Ist Cross Selling Pro gar nicht installiert, steht dort ein Link „Im Shopware Store ansehen“.

### Kontingent, Statistik und Warenkorb

* Jeder Abruf aus der Suche zählt auf das monatliche Anfrage-Kontingent von **Cross Selling Pro**. Ist es im Paket Basic erschöpft, verhält sich die Suche wie ohne Kopplung.
* Legt ein Besucher ein solches Produkt in den Warenkorb, trägt die Position die Empfehlungs-Kennzeichnung. Der Umsatz zählt dann als Umsatz durch Empfehlungen.
* Klicks auf „Passt zu …“ gehen in das Tracking von Cross Selling Pro.

### Weitere Berührungspunkte

* **Ersatzbild:** Ist in Cross Selling Pro unter der Karte „Produktbilder“ kein „Ersatzbild für Produkte ohne Bild“ gewählt, nimmt das Plugin das Ersatzbild aus dem Such-Plugin. Fehlt auch das, erscheint ein grauer Platzhalter.
* **Besucher-Erkennung:** Beide Plugins erkennen Besucher und Besuche auf dieselbe Weise. Ein Besuch endet nach 30 Minuten ohne Aktivität.
* **Alter Slider der Suche:** Das Such-Plugin bringt einen Erlebniswelten-Block „AI Basis Empfehlungsslider (veraltet)“ mit. Für neue Seiten nutzen Sie bitte die Blöcke aus der Kategorie „AI CrossSelling“ von Cross Selling Pro.

## cogi Commander

Der cogi Commander („cogi Commander | Analytics, Statistiken & mehr“) ist ein eigenes Plugin der codegiganten GmbH. Er sammelt die Kennzahlen aller cogi-Plugins im Shop und zeigt je Plugin eine Kachel. Cross Selling Pro meldet seine Zahlen seit Version 2.2.1 (Shopware 6.7) bzw. 1.4.1 (Shopware 6.6).

{% hint style="info" %}
Die Zahlen im Commander sind eine eigene Zählung im Shop. Sie müssen nicht genau mit der Statistik im Plugin-Dashboard übereinstimmen. Für genaue Auswertungen nutzen Sie die Statistik von Cross Selling Pro.
{% endhint %}

### Die Kachel

Die Kachel heißt „cogi InsightSearch Cross-Selling“ mit der Beschreibung „Einblendungen, Klicks, Warenkorb und Umsatz durch Empfehlungen.“ Die Hauptkennzahl ist der Umsatz. Dazu kommen ein Verlaufsdiagramm und Tabellen.

| Kennzahl                            | Aufgeteilt nach  |
| ----------------------------------- | ---------------- |
| „Einblendungen von Empfehlungen“    | Fläche           |
| „Booster angezeigt“                 | Anzeigeart       |
| „Booster-Produkt gesehen“           | Anzeigeart       |
| „Booster geschlossen“               | Anzeigeart       |
| „Klicks auf Empfehlungen“           | Fläche           |
| „In den Warenkorb aus Empfehlungen“ | Fläche           |
| „Bestellungen mit Empfehlungen“     | nicht aufgeteilt |
| „Umsatz durch Empfehlungen“         | Fläche           |

Flächen sind zum Beispiel Slider in Erlebniswelten, Offcanvas, Warenkorbseite, Checkout-Zwischenseite, Kundenkonto, Bundle/Set sowie die beiden Funktionen in der Suche. „Booster“ meint hier den **Conversion Booster**, nicht die Booster in einer Vorlage.

### So wird gezählt

* Einblendungen und Klicks kommen aus dem Browser. Sie folgen deshalb der Einstellung „Ereignisse aus dem Browser“ in der Karte „Tracking“ und erscheinen nur, wenn Cross Selling Pro verbunden ist.
* „In den Warenkorb“ zählt jede Position mit Empfehlungs-Kennzeichnung. Das Hauptprodukt des Conversion Boosters zählt nicht.
* Bestellungen zählen einmal je Bestellung. Der Umsatz ist die Summe der Empfehlungspositionen nach anteiligem Rabatt, umgerechnet in die Standardwährung.
* Stornierungen werden im Commander nicht abgezogen.
* Bots und Crawler sortiert das Plugin vorher aus.

### Wenn der Commander (noch) fehlt

Ist der Commander nicht installiert, schreibt Cross Selling Pro Tagessummen in eine eigene Tabelle im Shop. Diese Summen bleiben 90 Tage im Shop. Installieren Sie den Commander später, holt er sie stündlich ab.

{% hint style="warning" %}
Im Commander gibt es den Schalter „Von cogi-Suite-Plugins gemeldete Touchpoints sammeln“ (Standard an). Ist er aus, verwirft der Commander die Zahlen. Sie werden dann auch nicht zwischengespeichert und sind verloren.
{% endhint %}

Ältere Bestellungen und deren Umsatz lassen sich einmalig per Kommandozeile nachtragen. Einblendungen, Klicks und Warenkorb-Aktionen von früher lassen sich nicht nachtragen, weil der Shop sie nie gespeichert hat. Den Befehl beschreibt die Seite [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).

## Fortschrittsbalken (Meilenstein-Empfehlungen)

Mit dem Fortschrittsbalken-Plugin der codegiganten GmbH rücken im Offcanvas und auf der Warenkorbseite Produkte nach vorne, deren Preis die Lücke zum nächsten Ziel schließt, etwa „noch 20 € bis zum Gratisversand“. Nötig sind der Fortschrittsbalken ab Version 2.5.0 (Shopware 6.7) bzw. 1.4.0 (Shopware 6.6), installiert, aktiv und in seinen Einstellungen eingeschaltet. Die Einstellungen finden Sie unter **Ausspielung → Ausspielorte → Meilenstein**. Alles Weitere steht auf der Seite [Meilenstein-Empfehlungen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/meilenstein-empfehlungen.md).

## Printess, Custom Products und eigene Konfiguratoren

Produkte, die vor dem Kauf gestaltet werden müssen, legt eine Empfehlung **nie direkt** in den Warenkorb. Die Einstellungen stehen in der Plugin-Konfiguration.

| Karte                                 | Einstellung                                | Wirkung                                                                                       | Standard           |
| ------------------------------------- | ------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------ |
| „Printess“                            | „Printess-Produkte unterstützen“           | Die Kachel zeigt „Jetzt gestalten“ und öffnet den Editor                                      | an                 |
| „Printess“                            | „Editor im Modal öffnen“                   | Öffnet den Editor im Fenster. Aus oder wenn der Editor nicht startet: Weiter zur Produktseite | an                 |
| „Custom Products“                     | „Custom Products unterstützen“             | Erkennt Produkte mit einer aktiven Vorlage von Shopware Custom Products                       | an                 |
| „Custom Products“                     | „Button in der Empfehlungs-Kachel“         | Link „Zum Produkt“, Link mit dem normalen Details-Text oder „Button ausblenden“               | Link „Zum Produkt“ |
| „Eigener Konfigurator (Custom Build)“ | „Eigenes Konfigurator-Plugin unterstützen“ | Felder für andere Konfigurator-Plugins (Zusatzfelder, Selektoren, Kauf-Container)             | aus                |

* In Bundles und Sets sind solche Produkte nie auswählbar.
* Wird ein Konfigurator-Produkt ohne Gestaltung aus einer Empfehlung in den Warenkorb gelegt, lehnt der Shop das ab und zeigt einen Hinweis im Warenkorb. Die normale Produktseite ist davon nicht betroffen.

{% hint style="warning" %}
Richten Sie einen eigenen Konfigurator ein und schalten dort „Konfigurator im Modal öffnen“ aus, öffnen **alle** Konfigurator-Produkte auf der Produktseite, auch Printess-Produkte.
{% endhint %}

## Themes

Das Plugin bringt eigene Darstellungen für Slider, Offcanvas, Bundle/Set und Conversion Booster mit. Für Zenit-Themes enthält es eigene Anpassungen: Zenit blendet den Kauf-Button auf Produktkarten erst beim Überfahren ein und legt ihn über den Preis. In den Empfehlungs-Karten holt das Plugin den Knopf zurück und macht ihn sichtbar. Hinweise zum Kompilieren des Themes stehen 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).

## Weitere Shopware-Funktionen

* **Merkliste:** Ist die Merkliste in Shopware aktiv, kann der Typ „Inspiration aus der Wunschliste“ die gemerkten Artikel als Ausgangsprodukte nutzen (ab Paket Experte).
* **Kundengruppen und Sichtbarkeit:** „Nur Produkte zeigen, die der Kunde sehen darf“ (Karte „Sichtbarkeit“, Standard an) prüft jede Empfehlung gegen die Sichtbarkeit in Shopware. Das gilt auch, wenn andere Plugins Produkte nur für bestimmte Kundengruppen freigeben.
* **Cookie-Hinweis:** Das Plugin trägt seine Cookies selbst in den Cookie-Hinweis von Shopware ein. Nutzen Sie ein anderes Einwilligungs-Tool, prüfen Sie, ob es die Einträge übernimmt. Details auf der Seite [Tracking und Datenschutz](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/cross-selling-tracking-und-datenverarbeitung.md).

## Weiterlesen

{% content-ref url="/pages/0xVBPaF5j0HLtjVsgEZE" %}
[Meilenstein-Empfehlungen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/meilenstein-empfehlungen.md)
{% endcontent-ref %}

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

{% 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/yGk0q1ZbtHnV3CYZdwEl" %}
[Voraussetzungen und Pakete](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/voraussetzungen-und-pakete.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/zusammenspiel-mit-anderen-plugins.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.
