Überblick
Was du benötigst
- Deinen Strategy-API-Schlüssel. Gehe in Aftersell zu Settings → Product Strategy und kopiere in der Karte Security Token deinen Token (das ist dein Strategy-API-Schlüssel).
- Die Strategy-ID. Öffne die Strategy, die du ausführen möchtest, im Aftersell-Strategy-Editor und kopiere ihre ID.
- Das aktivierte Upsells-Modul in Upcart. Das Skript überschreibt die Liste der im bestehenden Upsell-Block angezeigten Produkte. Das Modul muss also aktiviert sein, damit überhaupt etwas gerendert wird.
Das Skript hinzufügen
STRATEGY_ID und STRATEGY_API_KEY durch die Werte aus Aftersell und speichere dann.
Was die Strategy sieht
Produkt-Kontext
Warenkorb-Kontext
- Subtotal – Zwischensumme des Warenkorbs in den Haupteinheiten der Store-Währung (z. B. Dollar). Upcarts
total_priceist in Untereinheiten (Cent) angegeben, daher teilt das Skript durch 100, um den Einheiten zu entsprechen, die der Rest der Strategies-API verwendet – und in denen deinecart_subtotal-Regeln verfasst sind. - Item count – Gesamtmenge über alle Positionen.
- Line count – Anzahl der unterschiedlichen Positionen.
Session-Kontext
- Währungscode – wird aus
window.Shopify.currency.activegelesen.
Was passiert, wenn die Strategy ein Ergebnis liefert
Wenn kein Produkt zurückgegeben wird
Neuauswertung bei Warenkorbänderungen
cartUpdated-Event von Upcart, sendet den neuen Warenkorb an die Strategies-API und aktualisiert den Cart Drawer mit der neuen Upsell-Liste.
Eine Warenkorbsignatur-Prüfung überspringt redundante Aufrufe, wenn sich Positionen und Mengen nicht tatsächlich geändert haben. Aufeinanderfolgende Warenkorb-Events, die den Warenkorb nicht wesentlich verändern, treffen die API also nicht erneut.
Tipps für Upcart-Strategies
- Baue auf dem Warenkorb auf. Warenkorbmerkmale und Produkt-Trigger sind hier die stärksten Signale, die du hast. Kundenhistorie und UTM-basiertes Targeting werden vom Standardskript nicht gesendet.
- Nutze Catch all als Sicherheitsnetz. Ohne Catch all zeigt das Upsells-Modul nichts an, wenn keine Regel greift.
- Standardmäßig cache-freundlich. Die Warenkorbsignatur-Absicherung verhindert erneute API-Aufrufe, wenn sich der Warenkorb nicht wesentlich geändert hat – gut für Käufer, die den Warenkorb öffnen und schließen, ohne ihn zu bearbeiten.