Skip to main content
Deze pagina verzamelt de gedetailleerde regels achter de installatiewizard voor Subscription Upgrade: hoe prijzen worden afgeleid, hoe de opties voor timing en korting zich gedragen, de geschiktheidstrigger en waarom het aanbiedingsproduct een placeholder is. Zie Abonnementsupgrades instellen voor de stapsgewijze walkthrough.

​
Statussen van API-sleutelverificatie

In stap 1 valideert Test API key je token bij je provider: er wordt gecontroleerd of het authenticeert, alle vereiste scopes heeft en bij je winkel hoort. Het resultaat toont een van twee statussen:
  • Groen vinkje, “API key verified”. Het token is geauthenticeerd, alle vereiste scopes zijn aanwezig en het token hoort bij je winkel. Continue is ingeschakeld.
  • Rood annuleerpictogram. De controle is niet foutloos verlopen. Het bericht naast het pictogram geeft aan welke van twee dingen er is gebeurd: je provider heeft het token geweigerd (ingetrokken, of vereiste scopes ontbreken, en het bericht noemt het specifieke probleem), of Aftersell kon de controle niet voltooien (“Could not verify the API key. Please try again.”), wat een mislukte aanroep is en geen ongeldig token. Herstel het token als het is geweigerd; test anders gewoon opnieuw.
Er is geen derde, mildere status, en een resultaat waarbij de verificatie niet kon worden voltooid ziet er precies zo uit als een weigering, dus lees het bericht in plaats van alleen naar het pictogram te kijken. Continue blijft uitgeschakeld totdat de controle groen terugkomt. Het wijzigen van de provider of het token wist het vorige resultaat, dus test opnieuw na elke wijziging. Deze controle bestaat om mislukte abonnementsupgrades te voorkomen die anders pas aan het licht zouden komen nadat er bij een klant is afgeschreven.

​
De geschiktheidstrigger: Variant on subscription

De wizard stelt automatisch één trigger voor je in; je hoeft deze niet handmatig in te stellen: Alle ingeschakelde triggers gebruiken AND-logica: aan elke voorwaarde moet worden voldaan om de funnel te tonen. Je kunt in de stap Triggers van de funnel-editor extra optionele triggers toevoegen (gegroepeerd onder een inklapbaar gedeelte Additional triggers dat een aantal toont en automatisch opent wanneer er optionele triggers zijn ingesteld).
Vervang dit niet door een Product-trigger plus een Subscription-trigger. Die oudere combinatie bestaat uit twee onafhankelijke voorwaarden, dus een bestelling met je triggerproduct als eenmalige aankoop naast een ongerelateerd abonnementsitem voldoet aan beide: de funnel gaat af en de upgrade mislukt vervolgens verderop, omdat er geen overeenkomend abonnement is om te wijzigen. Variant on subscription is één voorwaarde die niet op die manier uit elkaar kan vallen, en de wizard migreert oudere funnels automatisch weg van de combinatie.
Zonder productspecifieke trigger kan een funnel worden getoond aan klanten die het geschikte abonnementsproduct niet in hun bestelling hebben. Dat verspilt impressies en leidt tot een abonnementswijziging die zonder melding mislukt: het aanbiedingsproduct wordt aan de bestelling toegevoegd, maar er wordt geen abonnement gewijzigd in Recharge, Skio of Loop.
Als Show this funnel for all customers is ingeschakeld, overschrijft dit alle andere triggers en gaat de funnel bij elke checkout af. Dit wordt niet aanbevolen voor funnels voor abonnementsupgrades.

​
Welke prijs het Recurring subtotal toont

Het Recurring subtotal in de aanbieding vertelt de klant wat de volgende verlenging gaat kosten. Van welk product die prijs wordt overgenomen, hangt af van het upgradetype: Dit is de meest voorkomende bron van verwarring. Een upgrade die alleen de frequentie wijzigt, behoudt bewust hetzelfde product, dus het terugkerende subtotaal kan alleen de prijs van het triggerproduct tonen, welke frequentie je ook instelt. Als je daar de prijs van een ander product verwachtte, wil je waarschijnlijk in plaats daarvan Both, change frequency and replace subscription product. Het gebruikte aantal komt uit Override subscription quantity, dat alleen bij de vervangingstypen verschijnt. Bij een upgrade die alleen de frequentie wijzigt, is het altijd 1.

​
Upgradetiming

Standaard gaat een upgrade in vanaf de volgende factureringscyclus van de klant, waarbij de bestaande verlengingsdatum behouden blijft. Als de timingoptie voor je winkel is ingeschakeld, verschijnt er een selectievakje onder de frequentievelden:
My fulfillment provider ships the upgraded item on the current order
Als je dit aanvinkt, start het nieuwe factureringsinterval direct in plaats van bij de volgende verlenging, en wordt het veld One-time upgrade price in stap 4 ontgrendeld.
Aftersell wijzigt de bestelling die de klant zojuist heeft geplaatst niet. Deze instelling verplaatst alleen het factureringsinterval. Vink het alleen aan als je fulfillmentprovider is ingesteld om het placeholderproduct van de upgrade te herkennen en het geüpgradede item met de huidige bestelling te verzenden.
Dit selectievakje staat standaard uit en is niet in elke winkel beschikbaar. Het verschijnt alleen bij de upgradetypen Change delivery or billing frequency en Both, change frequency and replace subscription product, en pas nadat de optie voor je winkel is ingeschakeld. Neem contact op met support via de chat in de app als je het nodig hebt.

​
Terugkerende korting

Een optionele stimulans die wordt toegepast op elke toekomstige verlenging van het geüpgradede abonnement (niet alleen de eerste cyclus). Niet beschikbaar voor het type waarbij een item wordt toegevoegd. Hoe het veld verschijnt, hangt af van of het geselecteerde selling plan getrapte prijsregels heeft:
  • Wanneer een selling plan met kortingsniveaus is geselecteerd (bijvoorbeeld een Loop-plan dat $20 korting geeft op de eerste afschrijving en $10 korting vanaf de tweede afschrijving), wordt het vrije invoerveld vervangen door een lijst met keuzerondjes, één per niveau. Elke optie toont het kortingsbedrag en het bereik van afschrijvingen waarop deze van toepassing is (bijvoorbeeld “Charge 1” of “Charge 2 onward”). Selecteer het niveau dat op elke toekomstige verlenging moet worden toegepast.
  • Wanneer er geen selling plan is geselecteerd, of het geselecteerde plan geen kortingsniveaus heeft, verschijnt het standaard vrije invoerveld. Voer het bedrag in en kies Percentage of Fixed amount.

​
Eenmalige upgradeprijs per upgradetype

De One-time upgrade price is wat de klant op deze Shopify-bestelling betaalt wanneer die accepteert.
  • Bij de typen Change delivery or billing frequency en Both is deze standaard vergrendeld op 0, omdat je abonnementsprovider aan het einde van de huidige factureringscyclus afschrijft en het placeholderproduct voor $0.00 op de Shopify-bestelling verschijnt. Het veld wordt pas bewerkbaar wanneer het selectievakje voor upgradetiming in stap 3 is aangevinkt.
  • Bij Replace with a different subscription product en Add another subscribable item to subscription is het timingselectievakje niet van toepassing, dus het prijsveld is altijd bewerkbaar.
Wat je erin invult, hangt af van het upgradetype:
  • Frequentie, vervanging of beide: het prijsverschil tussen het oorspronkelijke en het geüpgradede abonnement. De klant behoudt het abonnement en deze afschrijving dekt het verschil.
  • Add another subscribable item: het bedrag voor het toegevoegde item op deze bestelling. Er wordt niets gewisseld, dus er hoeft geen verschil te worden berekend: dit is simpelweg wat de klant nu betaalt voor het nieuwe item, dat vervolgens met het abonnement terugkeert. Zie Een item toevoegen aan een bestaand abonnement.
Korting op de eerste bestelling. Een optionele korting die alleen op deze upgradeaankoop wordt toegepast, ingevoerd als percentage (%) of vast bedrag. Het veld staat naast One-time upgrade price en verschijnt wanneer dat veld bewerkbaar is, zowel op het tabblad Create new als Pick existing. Bij het type waarbij een item wordt toegevoegd verschijnt het veld nog steeds, maar wordt het altijd als 0 opgeslagen; aanbiedingen die een item toevoegen hebben nooit een korting, dus stel in plaats daarvan de gewenste prijs in op het aanbiedingsproduct.

​
Waarom het aanbiedingsproduct een placeholder is

Het aanbiedingsproduct is alleen een visuele placeholder, geen echt product dat de klant koopt. Shopify staat niet toe dat een abonnementsproduct als post-purchase upsell wordt getoond na een bestelling die al een abonnement bevat, dus Aftersell legt de prijs tussen upgrades vast met een placeholder-SKU zonder abonnement.
  • De afbeelding, titel en prijs die je instelt, verschijnen op de aanbiedingskaart.
  • Bij acceptatie wordt de weergegeven prijs op de Shopify-bestelling afgeschreven en past Recharge, Skio of Loop de daadwerkelijke upgrade in de volgende cyclus toe op het abonnement.
  • Als je Pick existing kiest in plaats van er een aan te maken, moet het product eenmalige aankoop ondersteunen; producten die alleen als abonnement beschikbaar zijn, worden uit de kiezer gefilterd.