> 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/voraussetzungen-und-pakete.md).

# Voraussetzungen und Pakete

Was Ihr Shop für Cross Selling Pro braucht und welche Funktionen, Empfehlungstypen und Kontingente in den Paketen Basic bis Enterprise enthalten sind.

Bevor Sie Cross Selling Pro einrichten, lohnt ein kurzer Blick auf die technischen Voraussetzungen. Die meisten Shops erfüllen sie bereits, entscheidend sind die Hintergrundverarbeitung von Shopware und ein erreichbarer Produkt-Feed. Im zweiten Teil dieser Seite finden Sie, was in welchem Paket enthalten ist und wie Ihr Anfrage-Kontingent gezählt wird.

## Versionen

| Plugin-Version      | Shopware-Version      |
| ------------------- | --------------------- |
| 2.x (aktuell 2.2.1) | Shopware 6.7          |
| 1.x (aktuell 1.4.1) | Shopware 6.6 ab 6.6.9 |

Beide Versionslinien haben denselben Funktionsumfang. Eine eigene PHP-Version schreibt das Plugin nicht vor, es gelten die Systemanforderungen Ihrer Shopware-Version. Die Storefront von Shopware ist Pflicht, denn Empfehlungen und Tracking laufen dort.

Das Such-Plugin InsightSearch brauchen Sie nicht. Nutzen Sie beide Plugins, arbeiten sie zusammen (siehe [Zusammenspiel mit InsightSearch, cogi Commander und 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)).

## Was in Ihrem Shop laufen muss

### Hintergrundverarbeitung

Das Plugin erledigt viele Aufgaben im Hintergrund: Warenkorb-, Bestell- und Seitenaufruf-Ereignisse an InsightSearch senden, Zahlstatus übertragen, Bestellungen nachtragen, Push-Pakete senden. Dafür muss die Hintergrundverarbeitung von Shopware dauerhaft laufen, und zwar auch für die Warteschlange mit niedriger Priorität, über die das Tracking läuft.

{% hint style="warning" %}
Der Admin-Worker von Shopware arbeitet nur, solange ein Admin-Fenster offen ist. Für Live-Shops sollte die Hintergrundverarbeitung als Dienst auf dem Server laufen. Den genauen Befehl finden Sie 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). Warten Tracking-Ereignisse länger als 24 Stunden, zeigt das Plugin-Dashboard einen Hinweis.
{% endhint %}

### Geplante Aufgaben

Die geplanten Aufgaben von Shopware (Scheduled Tasks) müssen laufen. Darüber prüft das Plugin stündlich die Verbindung und Ihr Paket, gleicht nachts Bestellungen ab und erzeugt den Produkt-Export für den Feed neu. Ohne geplante Aufgaben veraltet der Feed und Paketwechsel kommen nicht an.

### Produktdaten für InsightSearch

InsightSearch braucht Ihre Produktdaten, um Empfehlungen zu berechnen. Der Setup-Wizard richtet das ein:

* **Produkt-Feed (Pull, Standard im Livebetrieb):** Der Wizard legt einen Verkaufskanal vom Typ „Produktvergleich“ mit Produkt-Export an. InsightSearch ruft diesen Feed ab. Die Feed-Adresse muss dafür **öffentlich und ohne Anmeldung** erreichbar sein. Passwortschutz, IP-Sperren oder Bot-Schutz vor dem Shop verhindern den Abruf.
* **Push:** Das Plugin sendet die Produkte selbst. Push ist für DEV- und Stage-Umgebungen gedacht, die von außen nicht erreichbar sind.

Mehr dazu unter [Setup-Wizard: Datenfeed](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/installation/setup-wizard-datenfeed.md).

### Browser der Besucher

Die Empfehlungen werden im Browser Ihrer Besucher direkt bei InsightSearch abgerufen. Prüfen Sie deshalb:

* Eine strenge Content-Security-Policy in Ihrem Shop muss Verbindungen zu InsightSearch erlauben.
* Eine Web-Firewall oder ein Bot-Schutz darf die Shop-Adressen des Plugins (Zugangsschlüssel, Produktdaten, Live-Preise, Sichtbarkeitsprüfung) nicht blockieren.
* Werbeblocker einzelner Besucher können Empfehlungen unterdrücken. Darauf haben Sie keinen Einfluss.

### Shopware-Account und In-App-Käufe

Pakete buchen Sie über den In-App-Kauf von Shopware. Ihr Shop muss dafür mit Ihrem Shopware-Account verbunden sein.

### Theme

Das Plugin bringt eigene Gestaltungen für Slider, Offcanvas, Bundle/Set und Conversion Booster mit, inklusive Anpassungen für Zenit-Themes. Nach Installation oder Update muss das Theme neu kompiliert werden, damit die Gestaltung greift.

## Die Pakete

Cross Selling Pro gibt es in fünf Paketen: **Basic**, **Starter**, **Experte**, **Advanced** und **Enterprise**. Ihr Paket sehen Sie im Plugin-Dashboard unter **System → Pakete** in der Karte „Pakete & Funktionen“ mit der Zeile „Ihr aktueller Plan“. Dort vergleichen Sie die Pakete. Der Knopf „Details“ öffnet den In-App-Kauf von Shopware.

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-383c14848c9551212912299059888d43c7868086%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-pakete.png?alt=media" alt="Bereich Pakete mit der Vergleichstabelle der Funktionen"><figcaption></figcaption></figure>

### Anfrage-Kontingent

| Paket      | Anfragen je Kalendermonat |
| ---------- | ------------------------- |
| Basic      | 100.000                   |
| Starter    | 500.000                   |
| Experte    | 1.000.000                 |
| Advanced   | 5.000.000                 |
| Enterprise | unbegrenzt                |

**Was als Anfrage zählt:** Jeder Empfehlungsblock, der im Shop geladen wird, ist eine Anfrage, auch wenn er keine Produkte findet. Meilenstein-Empfehlungen im Warenkorb zählen zusätzlich als eigene Anfrage. Die Vorschau im Vorlagenformular und die Sandbox zählen nicht.

**Was beim Erreichen passiert:** Nur im Paket Basic werden nach Erreichen des Limits bis zum Monatsende keine Empfehlungen mehr ausgespielt. In allen anderen Paketen gibt es keine Einschränkungen und keine automatischen Mehrkosten. Bei einer erheblichen Überschreitung meldet sich InsightSearch bei Ihnen, um gemeinsam eine Lösung zu finden.

Ihren Verbrauch sehen Sie unter **Überblick → Übersicht** in der Karte „Monatliches Anfrage-Kontingent“ mit „Aktuelle Anfragen“ und „Hochrechnung Monatsende“.

### Empfehlungstypen je Paket

| Ab Paket | Empfehlungstypen                                                                  |
| -------- | --------------------------------------------------------------------------------- |
| Basic    | Ähnliche Produkte, Zuletzt angesehen                                              |
| Starter  | zusätzlich Bestseller, Erneut kaufen, Empfehlungen zum Suchbegriff im Such-Plugin |
| Experte  | zusätzlich Trends, Persönlich, Passt gut dazu, Weitermachen, Wunschliste          |

Was die Typen tun, steht unter [Empfehlungs-Typen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/empfehlungs-typen.md).

### Kartenlayouts je Paket

| Ab Paket | Layouts                                                                                                |
| -------- | ------------------------------------------------------------------------------------------------------ |
| Basic    | „Shopware Klassisch“, „Minimale (Kleine Kacheln)“                                                      |
| Starter  | zusätzlich „Kompakte Kacheln“, „Große Kacheln“                                                         |
| Experte  | zusätzlich „Detaillierte Kacheln“, „Kacheln im Raster“, „Produkt Liste“, „Mosaik“, „Produkt Spotlight“ |

Beispiele zu den Layouts finden Sie unter [Erlebniswelten-Elemente und Kartenlayouts](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/slider-erlebniswelten.md).

### Funktionen je Paket

| Ab Paket | Funktionen                                                                                                                                              |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Starter  | „Offcanvas-Empfehlungen“, „Warenkorb-Empfehlungen“, „Feste Produkte“, Umsatz-Tracking, Klickraten-Statistik, „Meilenstein-Empfehlungen“                 |
| Experte  | „Rule Builder“ (Regel-Baukasten), „Zubehör-Element (Bundle Set)“, „Volle Statistiken“, „Empfehlungen im Kundenkonto“, „Meilenstein-Empfehlungen mit KI“ |
| Advanced | „Conversion Booster“                                                                                                                                    |

Auf der Warenkorbseite gibt es die Darstellungen Raster und Liste ab Experte, davor einen Slider. Die Checkout-Zwischenseite hat keine Paketsperre.

### So erkennen Sie gesperrte Funktionen

* **Hinweiskarte** mit Schloss, „Verfügbar ab …“ und dem Knopf „Pakete vergleichen“, zum Beispiel bei einem gesperrten Empfehlungstyp oder Ausspielort.
* **Überlagerung:** Der Inhalt liegt unscharf darunter, darüber steht „Mehr Empfehlungen, mehr Umsatz.“, zum Beispiel bei festen Produkten, Regel-Baukasten oder Statistik.
* **Schloss in Auswahllisten:** Gesperrte Optionen tragen das Schloss und den Paketnamen.
* **In Erlebniswelten:** Ein Element, das Ihr Paket nicht enthält, zeigt im Editor „Wird nicht ausgespielt · Verfügbar ab …“ mit dem Link „Pakete ansehen“.
* **Grüne Plakette:** „Im Paket … enthalten“ zeigt, dass eine Funktion in Ihrem Paket freigeschaltet ist.

## Paket wechseln

1. Öffnen Sie im Plugin-Dashboard **System → Pakete**.
2. Klicken Sie beim gewünschten Paket auf „Details“.
3. Schließen Sie den Kauf im In-App-Kauf von Shopware ab.

Nach dem Kauf im Admin gilt das neue Paket sofort. Zusätzlich gleicht das Plugin Ihr Paket stündlich mit Shopware ab, auch ohne geöffneten Admin. Ein bezahltes Paket fällt erst zurück, wenn der Kauf mehrmals hintereinander nicht mehr gefunden wird. Eine kurze Störung stuft Sie also nicht herab.

## Weiterlesen

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

{% content-ref url="/pages/YEzwBfwJdo4PQnilLZp7" %}
[Empfehlungs-Typen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/empfehlungs-typen.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 %}


---

# 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/voraussetzungen-und-pakete.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.
