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

# Erste Schritte

In wenigen Schritten von der fertigen Einrichtung zu den ersten Empfehlungen auf Produktseite und im Warenkorb.

Diese Anleitung bringt Sie nach der Einrichtung schnell zu sichtbaren Empfehlungen im Shop. Sie legen eine Vorlage an, bauen sie in die Produktseite ein und schalten auf Wunsch Empfehlungen im seitlichen Warenkorb ein. Die Zeitangabe gilt, wenn Ihre Produkte bereits eingelesen sind.

## Voraussetzungen

* Das Plugin ist installiert und aktiviert. Siehe [Installation](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/installation.md).
* Der Setup-Wizard ist abgeschlossen und Ihre Produkte sind indexiert. Siehe [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).

{% hint style="info" %}
Lieber geführt? Der [Einrichtungsassistent](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/installation/konfigurationsassistent.md) legt mehrere Vorlagen auf einmal an. Diese Seite zeigt den Weg von Hand, damit Sie die wichtigsten Stellen kennenlernen.
{% endhint %}

## Schritt 1: Stand prüfen

Öffnen Sie **Inhalte → KI-gestütztes Cross-Selling**. Die Übersicht zeigt die Karte „Systemstatus“.

* Bei „Verbindung“ sollte „Verbunden“ stehen.
* Bei „Datenquellen“ sollte mindestens eine Datenquelle gezählt sein.
* Erscheint der Hinweis „Es sind Datenquellen vorhanden, aber noch keine Sprache/kein Sales Channel zugeordnet.“, klicken Sie auf **„Sprachen zuordnen“**. Ordnen Sie dort der Datenquelle Ihre Verkaufskanäle und Sprachen zu und speichern Sie. Ohne diese Zuordnung liefert der Shop keine Empfehlungen aus.

## Schritt 2: Vorlage anlegen

Eine Vorlage legt fest, welche Produkte empfohlen werden. Für die Produktseite eignen sich ähnliche oder passende Produkte.

1. Öffnen Sie in der Seitenleiste **Ausspielung → Empfehlungs-Vorlagen** und klicken Sie auf **„Vorlage anlegen“**.
2. Wählen Sie in der Karte **„Schnellstart“** im Feld „Preset“ den Eintrag **„Automatisch (empfohlen)“**. Er setzt bewährte Startwerte für ähnliche Produkte und bevorzugt lieferbare Artikel.
3. Geben Sie unter „Allgemein“ einen „Name“ ein, zum Beispiel „Produktseite ähnlich“. Der Name ist nur im Admin sichtbar.
4. Klicken Sie auf **„Speichern“**.

<details>

<summary>Welches Preset passt für die Produktseite?</summary>

| Preset                                 | Wofür                                                                                             | Ab Paket |
| -------------------------------------- | ------------------------------------------------------------------------------------------------- | -------- |
| „Automatisch (empfohlen)“              | Ähnliche Produkte als Alternativen. Funktioniert ab dem ersten Tag, auch ohne Bestellungen.       | Basic    |
| „Zubehör (Produktseite)“               | Oft zusammen gekaufte Produkte passender Produkttypen, ohne Kaufdaten ähnliche passende Produkte. | Basic    |
| „Oft zusammen gekauft (nur Kaufdaten)“ | Nur echte gemeinsame Käufe. Braucht Bestellhistorie.                                              | Experte  |

Die Einstellung „Passende Typen“ im Preset „Zubehör (Produktseite)“ wirkt nur mit der Produkttyp-Erkennung. Diese ist eine Beta-Funktion und wird von InsightSearch freigeschaltet. Ohne Freischaltung verhält sich das Preset wie ohne Produkttyp.

</details>

## Schritt 3: In die Produktseite einbauen

Vorlagen erscheinen erst im Shop, wenn sie eingebunden sind. Auf der Produktseite geschieht das über eine Erlebniswelt.

1. Öffnen Sie **Inhalte → Erlebniswelten** und dort das Layout Ihrer Produktseite (Typ Produktseite).
2. Fügen Sie einen Block aus der Kategorie **„AI CrossSelling“** ein, zum Beispiel **„AI CrossSelling: Standard-Karten“**.
3. Wählen Sie im Element unter **„Empfehlungs-Vorlage“** Ihre neue Vorlage. Vergeben Sie einen „Titel“, zum Beispiel „Passt dazu“.
4. Speichern Sie das Layout und weisen Sie es den Produkten zu (Shopware-Standard, zum Beispiel als Standard-Layout für Produktseiten).

Die „Produktquelle“ steht auf „Automatisch (PDP)“: Die Empfehlungen beziehen sich dann immer auf das Produkt, das der Kunde gerade ansieht.

{% hint style="warning" %}
Die Blöcke „Standard-Karten“ und „Minimal“ sind ab Basic enthalten, „Kompakt“ und „Große Kacheln“ ab Starter, alle weiteren Layouts ab Experte. Ein Block mit einem nicht gebuchten Layout zeigt im Shop nichts an.
{% endhint %}

## Schritt 4: Empfehlungen im seitlichen Warenkorb

{% hint style="info" %}
Verfügbar ab Paket Starter.
{% endhint %}

Der seitliche Warenkorb (Offcanvas) öffnet sich, sobald ein Kunde etwas in den Warenkorb legt. Dafür brauchen Sie keine Erlebniswelt.

1. Legen Sie wie in Schritt 2 eine weitere Vorlage an, diesmal mit dem Preset **„Warenkorb: passendes Zubehör“**. Es mischt Empfehlungen zu allen Warenkorb-Positionen und schließt Produkte aus, die schon im Warenkorb liegen.
2. Öffnen Sie **Ausspielung → Ausspielorte** und dort den Bereich **„Offcanvas“**.
3. Lassen Sie oben „Alle Verkaufskanäle“ stehen oder wählen Sie einen Verkaufskanal.
4. Schalten Sie **„Aktivieren“** ein und wählen Sie unter **„Empfehlungs-Vorlage“** die neue Vorlage.
5. Klicken Sie auf **„Speichern“**.

Für die Warenkorbseite gehen Sie genauso im Bereich **„Warenkorb“** vor. Änderungen an Offcanvas und Warenkorb wirken sofort.

## Schritt 5: Testen

* **Vorschau in der Vorlage:** Öffnen Sie die gespeicherte Vorlage erneut. Die Karte „Vorschau“ rechnet genau mit den Einstellungen der Vorlage. Wählen Sie ein „Referenzprodukt“ und klicken Sie auf „Vorschau aktualisieren“. Die Vorschau erscheint erst nach dem ersten Speichern.
* **Empfehlungs-Sandbox:** Unter **Produkte & Daten → Produkte** probieren Sie Vorlagen an beliebigen Produkten aus und vergleichen zwei Einstellungen. Die Sandbox speichert nichts und wirkt nicht auf den Shop.
* **Im Shop:** Öffnen Sie eine Produktseite und legen Sie ein Produkt in den Warenkorb.

Mehr dazu unter [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).

## Tipp: Leere Blöcke vermeiden

Findet eine Vorlage keine Produkte, verschwindet der Block aus der Seite. Damit immer etwas erscheint, stellen Sie in der Vorlage im Abschnitt **„5. Darstellung“** einen Ersatz ein:

| Einstellung             | Empfehlung                                                                            |
| ----------------------- | ------------------------------------------------------------------------------------- |
| „Fallback-Schwelle (≤)“ | Zum Beispiel 2. Der Ersatz greift, sobald höchstens so viele Produkte geladen wurden. |
| „Fallback-Typ“          | „Andere Vorlage“, „Feste Produkte“ oder „Dynamische Produktgruppe“.                   |
| „Fallback-Vorlage“      | Zum Beispiel eine Bestseller-Vorlage (Bestseller ab Paket Starter).                   |

## Weiterlesen

{% content-ref url="/pages/2829bd749e75a2c5fa0d0691f89169becd233751" %}
[Empfehlungs Vorlagen](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/vorlagen/empfehlungs-vorlagen.md)
{% endcontent-ref %}

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

{% content-ref url="/pages/294b6ba37e158f79960adb2aab6b8d1f5a90312f" %}
[Warenkorb-Seite & Offcanvas-Warenkorb](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/warenkorb-seite-and-offcanvas-warenkorb.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 %}


---

# 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/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.
