> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Checkout-Upsells

> Verwende eine Strategy, um das in einem Shopify-Plus-Checkout-Upsell-Widget angezeigte Produkt dynamisch auszuwählen.

<div id="overview">
  ## Überblick
</div>

Beim Konfigurieren eines Checkout-Upsell-Widgets kannst du den Produkt-Slot auf verschiedene Weise füllen: ein bestimmtes Produkt manuell auswählen, eines von der KI empfehlen lassen oder eine **Strategy** anhängen. Jede Option ist ein anderes Werkzeug für eine andere Aufgabe.

Strategies sind für **dynamisches Merchandising in Echtzeit** gedacht – das passende Zubehör zu einem Hauptprodukt kombinieren, einen ergänzenden Artikel vorschlagen oder je nach aktuellem Warenkorbinhalt ein anderes Produkt anzeigen. Während Checkout-**Trigger** entscheiden, *welches* Widget einem bestimmten Käufer angezeigt wird, entscheidet eine Strategy, *welches Produkt darin erscheint*. Trigger sind das Tor, Strategies sind das Gehirn hinter dem Erlebnis.

***

<div id="attaching-a-strategy-to-a-checkout-widget">
  ## Eine Strategy an ein Checkout-Widget anhängen
</div>

Strategies werden **pro Widget** angehängt, nicht an den Checkout als Ganzes. Du kannst Strategy-gesteuerte Widgets und Widgets mit statischen Produkten im selben Checkout kombinieren.

1. Öffne das Checkout-Widget, das du bearbeiten möchtest.
2. Wähle im Menü **Select product type** die Option **Strategy**.
3. Suche in der Strategy-Auswahl die gewünschte Strategy und wähle sie aus.
4. Klicke auf **Confirm** und speichere dann das Widget.

Nach dem Anhängen zeigt das Widget den Namen der Strategy anstelle eines bestimmten Produkts an. Bei jedem Laden des Checkouts wird die Strategy ausgewertet und das zurückgegebene Produkt im Widget gerendert.

<Tip>
  Gib deinen Strategies klare, aussagekräftige Namen. Der Strategy-Name ist das, was nach dem Anhängen im Widget-Editor angezeigt wird, und die einfachste Möglichkeit, auf einen Blick zu erkennen, welche Strategy welches Widget steuert.
</Tip>

***

<div id="what-the-strategy-sees">
  ## Was die Strategy sieht
</div>

Der Checkout hat einen **engeren Kontext** als Post-Purchase. Die Strategy wird beim Laden der Checkout-Seite ausgewertet, bevor die Bestellung aufgegeben wird – Kundenhistorie und Session-Attribution sind daher noch nicht verfügbar. Folgendes wird automatisch gesendet:

<div id="product-context">
  #### Produkt-Kontext
</div>

Die aktuell im Warenkorb befindlichen Positionen werden als Eingabeprodukte gesendet. Trigger wie **product tags**, **product collections**, **product type**, **vendor** und **product metafields** werden alle anhand dieser Artikel ausgewertet.

**Selling plan wird hier nicht ausgewertet.** Checkout-Positionen enthalten in diesem Payload keinen Selling plan, daher greift ein **Selling plan**-Trigger bei Checkout-Widgets nie.

<div id="cart-context">
  #### Warenkorb-Kontext
</div>

* **Subtotal** – die Zwischensumme des Warenkorbs.
* **Item count** – Gesamtmenge über alle Positionen.
* **Line count** – Anzahl der unterschiedlichen Positionen.

<Warning>
  **Kunden- und Session-Trigger greifen im Checkout nicht.** Kunden-Tags, Bestellanzahl, Land, Locale und UTM-Parameter sind nicht Teil des Checkout-Payloads. Wenn eine in einem Checkout-Widget verwendete Strategy auf diese Trigger angewiesen ist, werden diese Regeln nie ausgelöst, und nur produkt- oder warenkorbbezogene Regeln (oder der Catch all) können ein Produkt zurückgeben.
</Warning>

***

<div id="what-happens-when-the-strategy-returns">
  ## Was passiert, wenn die Strategy ein Ergebnis liefert
</div>

Die von der Strategy zurückgegebenen Produkte **ersetzen** den Platzhalter im Widget – sie werden nicht hinzugefügt. Der Käufer sieht das Widget so, als hättest du dieses Produkt selbst manuell ausgewählt.

Das Widget füllt seine Slots aus den zurückgegebenen Produkten in Prioritätsreihenfolge, bis zur Anzahl der Angebote, für die das Widget konfiguriert ist. Ein Widget mit nur einem Angebot verwendet das erste zurückgegebene Produkt.

***

<div id="when-no-product-is-returned">
  ## Wenn kein Produkt zurückgegeben wird
</div>

Wenn keine Regeln greifen und die Strategy keine Produkte zurückgibt, wird das Widget dem Käufer **nicht angezeigt** – der Slot verschwindet vollständig aus dem Checkout.

Damit dein Widget weiterhin angezeigt wird, konfiguriere in der Strategy einen **Catch all**, sodass immer ein Fallback-Produkt zurückgegeben werden kann. Wie du einen Catch all einrichtest, erfährst du auf der Seite [Strategies erstellen](/de/aftersell/strategies_building_in_app).

***

<div id="evaluation-timing">
  ## Zeitpunkt der Auswertung
</div>

Standardmäßig wird eine Strategy an einem Checkout-Widget **einmal beim Laden der Checkout-Seite** ausgewertet. Das beim Seitenaufruf gewählte Produkt bleibt das angezeigte Produkt, auch wenn der Käufer während des Checkouts Artikel hinzufügt oder entfernt.

Wenn beim Widget die **flexible Trigger-Neuprüfung** aktiviert ist, wird die Strategy stattdessen bei jeder Warenkorbänderung während des Checkouts neu ausgewertet, und das Widget aktualisiert sich entsprechend dem neuen Warenkorb – ähnlich wie sich die [Upcart-Integration](/de/aftersell/implementing_strategies_upcart_upsells) verhält. Plane deine Regeln passend zum jeweils vom Widget verwendeten Modus: eine feste Momentaufnahme beim Laden des Checkouts oder eine Live-Neuauswertung bei jeder Warenkorbänderung.

***

<div id="tips-for-checkout-strategies">
  ## Tipps für Checkout-Strategies
</div>

* **Baue nur auf Produkten und Warenkorb auf.** Kunden- und sessionbezogene Trigger greifen im Checkout nie. Erstelle Strategies daher auf Basis von Produktattributen (Tags, Kollektionen, Metafelder) und Warenkorbmerkmalen (Zwischensumme, Artikelanzahl, Positionsanzahl).
* **Nutze Catch all als Sicherheitsnetz.** Eine Strategy ohne Catch all blendet das Widget aus, wenn nichts greift. Ein einfacher Catch all sorgt dafür, dass der Slot immer *etwas* anzeigt.
* **Kombiniere dynamische und statische Widgets.** Nicht jedes Widget muss Strategy-gesteuert sein. Ein gängiges Muster ist eine Strategy am primären Upsell-Widget (am stärksten personalisiert) und ein statisches Produkt an einem sekundären Widget (bewährter Verkaufsschlager).
