Skip to main content

Overzicht

Upcart is een aparte app naast Aftersell, dus Strategies zijn niet in de Upsells-module ingebouwd zoals in de post-purchase en checkout flows van Aftersell. In plaats daarvan verbind je de twee apps met een klein script dat de Strategies API rechtstreeks aanroept en het resultaat via de publieke API van Upcart doorgeeft aan de bestaande Upsells-module van Upcart. Het script is drop-in - plak het één keer in de custom HTML van Upcart, vervang twee waarden (je Strategy API-sleutel en de Strategy-ID), en de Upsells-module begint de producten te tonen die de Strategy retourneert.

Wat je nodig hebt

  1. Je Strategy API-sleutel. Ga in Aftersell naar Settings → Product Strategy en kopieer in de kaart Security Token je token (dit is je Strategy API-sleutel).
  2. De Strategy-ID. Open de Strategy die je wilt uitvoeren in de Aftersell Strategy-editor en kopieer de ID.
  3. De Upsells-module ingeschakeld in Upcart. Het script overschrijft de lijst met producten die in het bestaande upsellblok worden getoond, dus de module moet zijn ingeschakeld om iets weer te geven.

Het script toevoegen

Ga in Upcart naar Settings → Custom HTML → Scripts (before load) en plak het onderstaande script. Vervang STRATEGY_ID en STRATEGY_API_KEY door de waarden uit Aftersell en sla vervolgens op.
Je Strategy API-sleutel autoriseert aanroepen naar de Strategies van je winkel. Het bovenstaande script plaatst de sleutel in client-side code, wat de enige praktische manier is om de API vanuit de cart drawer aan te roepen. Behandel de sleutel zoals je elke andere publieke storefront-credential zou behandelen en roteer deze via Aftersell Settings → Product Strategy als de sleutel ooit op een onbedoelde manier wordt blootgesteld.

Wat de Strategy ziet

Omdat dit vanuit de storefront-winkelwagen wordt uitgevoerd, is de context een beperkte subset van wat er beschikbaar is op de eigen surfaces van Aftersell:

Productcontext

De regelitems die momenteel in de Upcart-winkelwagen zitten, worden als inputproducten meegestuurd. Triggers zoals producttype, leverancier, producthandle, producttitel en alle product-ID / variant-ID triggers worden allemaal geëvalueerd op basis van deze items.

Cartcontext

  • Subtotaal - het subtotaal van de winkelwagen in de hoofdvaluta-eenheden van de winkel (bijv. dollars). Upcarts total_price is in kleinere eenheden (centen), dus het script deelt door 100 om overeen te komen met de eenheden die de rest van de Strategies API gebruikt - en de eenheden waarin je cart_subtotal-regels zijn opgesteld.
  • Aantal items - totale hoeveelheid over alle regels.
  • Aantal regels - aantal verschillende regelitems.

Sessiecontext

  • Valutacode - overgenomen uit window.Shopify.currency.active.
Klanttriggers en UTM-triggers matchen niet. Het standaardscript stuurt geen klanttags, aantal bestellingen, locatie of UTM-parameters mee - dus elke regel die deze triggers gebruikt, wordt nooit geactiveerd. Gebruik product-, cart- en valutatriggers, of een Catch all, om ervoor te zorgen dat er altijd iets wordt geretourneerd.

Wat er gebeurt wanneer de Strategy een resultaat geeft

De producten die de Strategy retourneert, vervangen volledig de lijst die Upcart anders in de Upsells-module zou tonen. De door de merchant gedefinieerde upselllijst wordt voor de duur van die winkelwagen overschreven - er wordt niet mee samengevoegd. Elk Strategy-product wordt gemapt naar de productvorm die Upcart verwacht (varianten, afbeeldingen, opties, metavelden, enz.), zodat het in het upsellblok precies zoals elk ander product wordt weergegeven.

Wanneer er geen product wordt geretourneerd

Als de Strategy geen producten retourneert, toont de Upsells-module niets - er worden geen upsells weergegeven. Om dit te voorkomen, configureer je een Catch all in de Strategy, zodat er altijd een terugvalproduct is om te retourneren. Zie de pagina Strategies bouwen voor het instellen van een Catch all.

Herevaluatie bij wijzigingen in de winkelwagen

In tegenstelling tot checkout-upsells evalueert de Upcart-implementatie de Strategy opnieuw telkens wanneer de winkelwagen verandert - items toegevoegd, verwijderd of in hoeveelheid gewijzigd. Het script abonneert zich op het cartUpdated-event van Upcart, stuurt de nieuwe winkelwagen naar de Strategies API en vernieuwt de cart drawer met de nieuwe upselllijst. Een controle op de cart-signature slaat overbodige aanroepen over als de regelitems en hoeveelheden niet daadwerkelijk zijn veranderd, zodat opeenvolgende cart-events die de winkelwagen niet wezenlijk wijzigen de API niet opnieuw aanroepen.

Tips voor Upcart-Strategies

  • Ontwerp rond de winkelwagen. Triggers op basis van de vorm van de winkelwagen en producten zijn hier de sterkste signalen. Klantgeschiedenis en op UTM gebaseerde targeting worden niet door het standaardscript meegestuurd.
  • Gebruik Catch all als vangnet. Zonder Catch all toont de Upsells-module niets wanneer geen enkele regel matcht.
  • Standaard cachevriendelijk. De cart-signature-beveiliging voorkomt dat de API opnieuw wordt aangeroepen als de winkelwagen niet wezenlijk is veranderd - handig voor shoppers die de winkelwagen openen en sluiten zonder deze te bewerken.