> 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/vorschau-und-sandbox.md).

# Vorschau und Sandbox

Wie Sie eine Vorlage mit der Vorschau und der Empfehlungs-Sandbox prüfen, bevor sie im Shop erscheint.

Bevor eine Vorlage im Shop erscheint, sollten Sie sehen, welche Produkte sie liefert. Dafür gibt es zwei Werkzeuge: die Vorschau direkt in der Vorlage und die Empfehlungs-Sandbox im Plugin-Dashboard. Beide rechnen mit Ihren echten Produktdaten, verändern aber nichts im Shop und zählen nicht auf Ihr monatliches Anfrage-Kontingent.

## Vorschau oder Sandbox?

|                 | Vorschau                                                                        | Empfehlungs-Sandbox                                                                           |
| --------------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Wo              | in der Vorlage, Karte „Vorschau“                                                | Seitenleiste **Produkte & Daten → Produkte**                                                  |
| Wofür           | schnell prüfen, was eine Vorlage liefert, und welche Regel wie viel ausschließt | Vorlagen und Typen vergleichen, einzelne Werte ausprobieren, Gründe für eine Empfehlung sehen |
| Vergleich A/B   | nein                                                                            | ja                                                                                            |
| Speichert etwas | nein                                                                            | nein                                                                                          |

## Die Vorschau in der Vorlage

Die Karte „Vorschau“ steht unten im Formular einer Vorlage. Sie erscheint erst, wenn die Vorlage einmal gespeichert ist. Danach rechnet sie mit den aktuellen Werten im Formular, auch mit Änderungen, die Sie noch nicht gespeichert haben. So probieren Sie Filter und Gewichte aus, bevor Sie speichern.

### So nutzen Sie die Vorschau

1. Öffnen Sie eine gespeicherte Vorlage unter **Ausspielung → Empfehlungs-Vorlagen**.
2. Scrollen Sie zur Karte „Vorschau“. Dort steht, womit gerechnet wird, zum Beispiel „Aus der Vorlage: …, 6 Produkte.“
3. Wählen Sie je nach Typ ein „Referenzprodukt“ oder einen „Kunde“ (siehe Tabelle).
4. Gibt es mehrere Datenquellen, wählen Sie im Feld „Index“ die passende.
5. Klicken Sie auf „Vorschau aktualisieren“. Nach jeder Änderung an der Vorlage klicken Sie erneut, um das neue Ergebnis zu sehen.

| Empfehlungstyp                                                                                                   | Auswahl                                                         |
| ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- |
| „Ähnliche Produkte (Alternativen)“                                                                               | „Referenzprodukt“                                               |
| „Passt gut dazu (wird zusammen gekauft)“                                                                         | „Referenzprodukt“ (optional)                                    |
| „Personalisiert …“, „Zuletzt Angesehen“, „Weitermachen …“, „Erneut kaufen …“, „Inspiriert durch deine Wünsche …“ | „Kunde“                                                         |
| „Bestseller (Meistverkaufte Produkte)“, „Trends …“                                                               | keine Auswahl nötig („Für diesen Typ ist keine Auswahl nötig.“) |

Die Vorschau zeigt so viele Produkte wie das „Limit“ der Vorlage, höchstens aber 24.

{% hint style="info" %}
Die Vorschau gibt es nur für die Quelle „InsightSearch API“. Bei einer Shop-Quelle wie „Dynamische Produktgruppe“ meldet sie „Die Vorschau ist nur für die Quelle InsightSearch verfügbar. …“
{% endhint %}

### Das Ergebnis lesen

**Trichter:** Eine Zeile wie „198 Produkte im Index · 194 erfüllen die Regeln · 6 angezeigt“ zeigt, wie viele Produkte jede Stufe übrig lässt. Ohne Regeln entfällt der mittlere Teil. Bleibt bei „erfüllen die Regeln“ kaum etwas, sind die Filter zu streng.

**Was die Berechnung getan hat:** Unter „Angewendet:“ stehen alle Filter, die gegriffen haben. Dazu kommen Hinweise wie:

| Hinweis                                                                                     | Bedeutung                                                                             |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| „Modus „Gleiche Kategorie“ ist entfallen: das Referenzprodukt hat keine Kategorie.“         | Der Modus konnte nicht angewendet werden.                                             |
| „Gelockert: übergeordnete Kategorie statt genauer Kategorie“                                | Es gab zu wenige Treffer, InsightSearch hat die übergeordnete Kategorie dazugenommen. |
| „Gelockert: gleiche Typ-Gruppe statt gleichem Typ“                                          | Beim Produkttyp wurde gelockert.                                                      |
| „Die Berechnung lief über das ältere Verfahren (Ausweichweg). Das Ergebnis kann abweichen.“ | InsightSearch hat ausnahmsweise das bisherige Rechenverfahren genutzt.                |

**Regel-Diagnose:** Hat die Vorlage Regeln, zeigt eine Tabelle je Regel:

| Spalte             | Inhalt                                                                                          |
| ------------------ | ----------------------------------------------------------------------------------------------- |
| „Regel“            | die Regel                                                                                       |
| „Aufgelöster Wert“ | der tatsächlich verwendete Wert, bei „Wert vom Referenzprodukt“ der Wert des gewählten Produkts |
| „Treffer (allein)“ | wie viele Produkte diese Regel allein erfüllen                                                  |
| „Auswirkung“       | „schränkt um … ein“, „erweitert um …“ oder „keine Auswirkung“                                   |

Regeln, die nicht ausgewertet werden konnten, stehen unter „Nicht auswertbare Regeln“, zum Beispiel wenn dem Referenzprodukt der Vergleichswert fehlt. Die Diagnose umfasst die ersten 20 Regeln. Die gleichen Treffer erscheinen auch direkt an den Regeln im Regel-Baukasten.

### Meldungen der Vorschau

| Meldung                                                                      | Was tun                                                                                                                                                                                              |
| ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| „Zugangsdaten fehlen. Bitte Verbindung prüfen.“ / „Zugangsdaten ungültig. …“ | Verbindung im Plugin-Dashboard prüfen                                                                                                                                                                |
| „Kein Index für diese Vorlage gefunden.“                                     | Datenquellen und Sprachzuordnung prüfen                                                                                                                                                              |
| „Der Index ist noch nicht bereit.“                                           | warten, bis die Produktdaten eingelesen sind                                                                                                                                                         |
| „Referenzprodukt nicht im Index gefunden.“                                   | ein anderes Produkt wählen oder die Produktdaten neu einlesen                                                                                                                                        |
| „Der Regelbaum ist zu komplex.“                                              | Regeln vereinfachen oder weniger tief verschachteln                                                                                                                                                  |
| „Zu viele Vorschau-Anfragen. Bitte kurz warten.“                             | kurz warten und erneut aktualisieren                                                                                                                                                                 |
| „Keine Produkte für diese Regeln gefunden.“                                  | Filter lockern, siehe [Filter und Regel-Baukasten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/filter-und-regeln.md) |

## Die Empfehlungs-Sandbox

Die Sandbox finden Sie in der Seitenleiste unter **Produkte & Daten → Produkte**. Sie ist eine eingebettete Seite aus Ihrem InsightSearch-Konto und rechnet live gegen Ihre Produktdaten. Sie speichert nichts und wirkt nicht auf den Shop.

### Ablauf

1. **Ausgangsprodukt wählen:** Produktnummer oder Titel eintippen und einen Vorschlag übernehmen. Bei Varianten erscheint eine Auswahlliste.
2. **„Vorlage oder Typ“ wählen:** Oben stehen Ihre Empfehlungs-Vorlagen, darunter die Empfehlungstypen ohne Vorlage. Mit einer Vorlage rechnet die Sandbox mit deren Typ, Einstellungen, Filtern und Produkttyp, so wie der Shop.
3. **Anpassungen (optional):** Die Felder darunter überschreiben einzelne Werte der Vorlage. Leere Felder übernehmen den Wert der Vorlage.
4. **Einzeln testen oder vergleichen:** Im A/B-Vergleich nimmt Konfiguration B eine andere Vorlage oder „Wie Konfiguration A“ mit einzelnen Abweichungen. Die Auswertung zeigt, wie viele Produkte gleich sind, wie viele ihre Position behalten haben und welche Einstellungen sich unterscheiden.
5. **„Warum empfohlen?“:** zeigt je Produkt den Anteil jedes Signals (Marke, Kategorie, Preis, KI-Ähnlichkeit, Beliebtheit, Kaufverhalten, Booster) und die Herkunft, etwa „gleiche Kategorie“ oder „oft zusammen gekauft“.
6. **Diagnose:** welche Filter angewendet wurden, welche entfallen sind und ob „Gleiche Kategorie“ gelockert wurde.

{% hint style="info" %}
Erscheinen Ihre Vorlagen nicht in der Auswahl, öffnen Sie die Vorlage, schalten den Expertenmodus ein und klicken unter „3. Gewichtung“ auf „Für Sandbox kopieren“. Fügen Sie die Werte in der Sandbox unter „Vorlagen-Konfiguration“ ein.
{% endhint %}

## Mit wenig Risiko live gehen

1. Vorlage anlegen, speichern und in der Vorschau mit zwei oder drei typischen Produkten prüfen.
2. In der Sandbox gegen die bisherige Vorlage vergleichen (A/B).
3. Unter „5. Darstellung“ eine „Fallback-Schwelle (≤)“ und einen Ersatz setzen, zum Beispiel eine Bestseller-Vorlage, damit der Block nie leer bleibt.
4. Die Vorlage zuerst an einer Stelle mit wenig Verkehr einbinden, etwa in einer noch nicht zugewiesenen Erlebniswelt oder nur in einem Verkaufskanal. Ausspielorte lassen sich je Verkaufskanal einstellen.
5. Nach dem Livegang die [Statistiken](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/statistiken.md) beobachten.

## 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/QgU30LU0ZaCBRpIydy5p" %}
[Filter und Regel-Baukasten](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/filter-und-regeln.md)
{% endcontent-ref %}

{% content-ref url="/pages/kmAEtVd6SYzhWwzFcHfH" %}
[Gewichtung, Vielfalt und Booster](https://docs.codegiganten.de/plugin-documentation/apps/cross-selling-pro-or-ki-+-warenkorb-cross-selling-+-bundles-and-sets/gewichtung-und-booster.md)
{% endcontent-ref %}

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