> 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/meilenstein-empfehlungen.md).

# Meilenstein-Empfehlungen

Meilenstein-Empfehlungen zeigen im Warenkorb Produkte, deren Preis die Lücke bis zum nächsten Ziel des Fortschrittsbalkens schließt, zum Beispiel bis zum Gratisversand.

{% hint style="info" %}
Verfügbar ab Paket Starter. Der Modus „Nur passende Produkte“ und die Preis-Gewichtung sind ab Paket Experte verfügbar.
{% endhint %}

Zeigt Ihr Shop mit dem Plugin „Fortschrittsbalken“ zum Beispiel „Noch 20 € bis zum Gratisversand“, kann Cross Selling Pro genau dazu passende Produkte vorschlagen. Im Offcanvas-Warenkorb und auf der Warenkorbseite rücken dann Produkte nach vorne, deren Preis die Lücke bis zum nächsten Meilenstein schließt. Der Kunde erreicht sein Ziel mit einem Klick, und Ihr Warenkorbwert steigt.

## Voraussetzungen

* Das Plugin **„Fortschrittsbalken“** von codegiganten ist installiert, aktiv und in seinen eigenen Einstellungen eingeschaltet. Nötig ist mindestens Version 2.5.0 für Shopware 6.7 bzw. 1.4.0 für Shopware 6.6.
* Am jeweiligen Ausspielort (Offcanvas-Warenkorb bzw. Warenkorbseite) ist eine **aktive Empfehlungs-Vorlage** eingerichtet. Die Meilenstein-Produkte werden in deren Liste gemischt. Ohne aktive Vorlage bleibt die Funktion ohne Wirkung.
* Ihr Paket ist mindestens **Starter**.

Fehlt der Fortschrittsbalken oder ist er nicht bereit, ist der Bereich im Admin ausgegraut. Ein Hinweis sagt, was zu tun ist, zum Beispiel „Installier den Fortschrittsbalken, dann steht dir die Funktion zur Verfügung.“ oder „Schalte den Fortschrittsbalken in seinen Einstellungen ein, dann steht dir die Funktion zur Verfügung.“. Der Link „Zum Fortschrittsbalken im Shopware Store“ führt zum Plugin.

## Einrichten

{% stepper %}
{% step %}

### Warenkorb-Empfehlungen aktivieren

Richten Sie am Ausspielort Offcanvas-Warenkorb und/oder Warenkorbseite eine Empfehlungs-Vorlage ein und aktivieren Sie die Empfehlungen dort. Wie das geht, steht auf der Seite [Warenkorb und 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).
{% endstep %}

{% step %}

### Meilenstein-Bereich öffnen

Öffnen Sie **Inhalte → KI-gestütztes Cross-Selling**. Wählen Sie in der Seitenleiste **Ausspielung → Ausspielorte** und dort **Meilenstein**. In der Plugin-Konfiguration finden Sie außerdem die Karte „Meilenstein-Empfehlungen“ mit einem Link auf diese Seite.
{% endstep %}

{% step %}

### Funktion einschalten

Schalten Sie „Produkte bis zum nächsten Meilenstein berücksichtigen“ ein und prüfen Sie, ob „Im Warenkorb-Offcanvas anwenden“ und „Auf der Warenkorbseite anwenden“ so stehen, wie Sie es möchten.
{% endstep %}

{% step %}

### Werte anpassen und speichern

Passen Sie bei Bedarf Toleranz, Anzahl der Meilensteine und die Plätze vorne an. Speichern Sie anschließend.
{% endstep %}
{% endstepper %}

<figure><img src="https://2593420173-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuEsjhAVOA2wlUumeZYPB%2Fuploads%2Fgit-blob-15d0be0d5121f9ec9af493f269992083db62da58%2Fcross-selling-pro-or-ki-%2B-warenkorb-cross-selling-%2B-bundles-and-sets-ausspielorte-meilenstein.png?alt=media" alt="Seite Ausspielorte und Darstellung, Bereich Meilenstein"><figcaption></figcaption></figure>

## Einstellungen

| Einstellung                                             | Wirkung                                                                                                                                                          | Standard  |
| ------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| „Produkte bis zum nächsten Meilenstein berücksichtigen“ | schaltet die Meilenstein-Empfehlungen ein                                                                                                                        | aus       |
| „Im Warenkorb-Offcanvas anwenden“                       | wirkt im Offcanvas-Warenkorb. Setzt eine aktive Empfehlungsvorlage für das Offcanvas voraus.                                                                     | an        |
| „Auf der Warenkorbseite anwenden“                       | wirkt auf der Warenkorbseite. Setzt aktivierte Empfehlungen im Warenkorb voraus.                                                                                 | an        |
| „Anzahl Meilensteine“                                   | wie viele offene Meilensteine berücksichtigt werden, beginnend mit dem nächsten (1 bis 3)                                                                        | 1         |
| „Toleranz über dem Restbetrag (%)“                      | wie viel teurer als der fehlende Betrag ein Produkt sein darf (0 bis 100)                                                                                        | 30        |
| „Plätze vorne“                                          | wie viele Meilenstein-Produkte höchstens vorne eingereiht werden (1 bis 6). Die übrigen Plätze behalten die normalen Empfehlungen, die Gesamtzahl bleibt gleich. | 3         |
| „Modus“ (ab Experte)                                    | „Gewichten (ähnliche Produkte bleiben, passender Preis rückt nach vorne)“ oder „Nur passende Produkte“                                                           | Gewichten |
| „Gewichtung Preis (%)“ (ab Experte)                     | 0 % = nur Ähnlichkeit, 100 % = nur Preispassung (0 bis 100)                                                                                                      | 50        |

Ohne Paket Experte sind „Modus“ und „Gewichtung Preis (%)“ ausgeblendet. An ihrer Stelle steht ein Paket-Hinweis.

{% hint style="info" %}
Die Farben des Balkens stellen Sie im Plugin „Fortschrittsbalken“ ein. Cross Selling Pro ändert daran nichts. Der Link „Einstellungen des Fortschrittsbalkens öffnen“ führt direkt dorthin.
{% endhint %}

## So wird gerechnet

### Das Preisfenster

Cross Selling Pro sucht Produkte, deren Preis zwischen dem fehlenden Betrag und dem fehlenden Betrag plus Toleranz liegt.

**Beispiel:** Es fehlen 20 € bis zum Gratisversand, die Toleranz steht auf 30 %. Dann passen Produkte von 20 € bis 26 €. Günstigere Produkte zählen nicht, weil sie das Ziel nicht erreichen.

Bei „Anzahl Meilensteine“ 2 oder 3 entsteht für jeden offenen Meilenstein ein eigenes Preisfenster.

### Welche Produkte in Frage kommen

* Nur Produkte, die laut Fortschrittsbalken für den Meilenstein **mitzählen**.
* Geprüft wird mit dem **echten Preis des Kunden** (also mit Kundengruppe, Staffel und Mindestabnahme), nicht mit einem Listenpreis.
* Produkte mit Varianten, die nur einen „ab“-Preis haben, fallen heraus, weil ihr Endpreis erst nach der Variantenwahl feststeht.
* Produkte, die schon im Warenkorb liegen, werden nicht vorgeschlagen.
* Ist der Warenkorb leer, gibt es keine Meilenstein-Produkte.

### Welche Produkte ausgewählt werden

| Paket      | Auswahl im Preisfenster                                                                                                                                                                                                                                                                             |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Starter    | eine zufällige Auswahl passender Produkte. Innerhalb eines Besuchs bleibt die Reihenfolge am selben Tag gleich. Lagerstand und die Regeln der Vorlage gelten.                                                                                                                                       |
| ab Experte | Produkte, die dem Referenzprodukt der Vorlage ähnlich sind, gemischt mit der Preispassung. Ein Produkt genau beim fehlenden Betrag passt am besten. Wie stark der Preis zählt, steuert „Gewichtung Preis (%)“. Gibt es zu wenige ähnliche Treffer, wird mit der Auswahl wie bei Starter aufgefüllt. |

### Wie die Liste aussieht

* **„Gewichten“:** Vorne stehen bis zu „Plätze vorne“ Meilenstein-Produkte, danach die normale Empfehlungsliste. Die Gesamtzahl der Karten ändert sich nicht.
* **„Nur passende Produkte“:** Es erscheinen nur Meilenstein-Produkte. Passt keines, zeigt der Block die normalen Empfehlungen.

Antwortet die Abfrage nicht innerhalb von 1,5 Sekunden oder tritt ein Fehler auf, erscheint einfach die normale Liste. Der Warenkorb wartet also nie lange.

## Wo Meilenstein-Empfehlungen erscheinen

Nur im **Offcanvas-Warenkorb** und auf der **Warenkorbseite**. Im Kundenkonto, auf der [Checkout-Zwischenseite](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/checkout-zwischenseite.md) und in Erlebniswelten-Elementen gibt es keine Meilenstein-Produkte.

## Kontingent und Statistik

* Jedes Laden der Meilenstein-Empfehlungen ist eine eigene Anfrage und zählt zusätzlich zur normalen Empfehlung auf Ihr monatliches Kontingent. Mehr dazu auf der Seite [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).
* In der Statistik bleiben die Produkte ihrer Fläche zugeordnet (Offcanvas bzw. Warenkorb) und sind zusätzlich als Meilenstein-Produkte gekennzeichnet.

## Wenn keine Meilenstein-Produkte erscheinen

Gehen Sie diese Punkte der Reihe nach durch:

1. Ist der Fortschrittsbalken in der nötigen Version installiert, aktiv und in seinen Einstellungen eingeschaltet?
2. Ist „Produkte bis zum nächsten Meilenstein berücksichtigen“ eingeschaltet, und gilt der Schalter für den Ausspielort, den Sie prüfen?
3. Hat der Ausspielort eine aktive Empfehlungs-Vorlage?
4. Ist Ihr Paket mindestens Starter?
5. Liegt etwas im Warenkorb, und ist der Meilenstein noch nicht erreicht?
6. Gibt es Produkte im Preisfenster, die für den Meilenstein mitzählen? Erhöhen Sie zum Test die Toleranz.
7. Sind die passenden Produkte vielleicht nur Variantenprodukte mit „ab“-Preis?

<details>

<summary>Beispiel für einen Shop mit Gratisversand ab 50 €</summary>

Ein Kunde hat Waren für 38 € im Warenkorb. Der Fortschrittsbalken zeigt „Noch 12 € bis zum Gratisversand“. Mit 30 % Toleranz sucht Cross Selling Pro Produkte zwischen 12 € und 15,60 €. Bei „Plätze vorne“ 3 und einem Block mit 6 Karten stehen vorne bis zu drei solcher Produkte, danach drei normale Empfehlungen.

</details>

## Weiterlesen

{% 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/GG8JfBfbbZLaf1c7u3hP" %}
[Ausspielorte und Darstellung](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/ausspielorte.md)
{% endcontent-ref %}

{% content-ref url="/pages/aCNptxGGhAgb4q2w1Roy" %}
[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)
{% 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/meilenstein-empfehlungen.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.
