Konfigurationsreferenz für Abonnement-Upgrades

Diese Seite sammelt die detaillierten Regeln hinter dem Einrichtungsassistenten für Subscription Upgrades: wie Preise abgeleitet werden, wie sich die Timing- und Rabattoptionen verhalten, der Berechtigungs-Trigger und warum das Angebotsprodukt ein Platzhalter ist. Die Schritt-für-Schritt-Anleitung findest du unter Abonnement-Upgrades einrichten. In Schritt 1 prüft Test API key deinen Token bei deinem Anbieter und kontrolliert, ob er sich authentifiziert, alle erforderlichen Scopes besitzt und zu deinem Shop gehört. Das Ergebnis zeigt einen von zwei Status:

• Grünes Häkchen, “API key verified”. Der Token hat sich authentifiziert, alle erforderlichen Scopes sind vorhanden und der Token gehört zu deinem Shop. Continue ist aktiviert.
• Rotes Abbrechen-Symbol. Die Prüfung war nicht erfolgreich. Die Meldung neben dem Symbol sagt dir, welcher von zwei Fällen eingetreten ist: Dein Anbieter hat den Token abgelehnt (widerrufen oder fehlende erforderliche Scopes, und die Meldung nennt das konkrete Problem), oder Aftersell konnte die Prüfung nicht abschließen (“Could not verify the API key. Please try again.”), was ein fehlgeschlagener Aufruf und kein fehlerhafter Token ist. Korrigiere den Token, wenn er abgelehnt wurde; andernfalls teste einfach erneut.

Es gibt keinen dritten, abgeschwächten Status, und ein Ergebnis “konnte nicht verifiziert werden” sieht genauso aus wie eine Ablehnung, lies also die Meldung und nicht nur das Symbol. Continue bleibt deaktiviert, bis die Prüfung grün zurückkommt. Wenn du den Anbieter oder den Token bearbeitest, wird das vorherige Ergebnis gelöscht, teste also nach jeder Änderung erneut. Diese Sperre verhindert fehlgeschlagene Abonnement-Upgrades, die sonst erst sichtbar würden, nachdem einem Kunden bereits etwas berechnet wurde. Der Assistent richtet automatisch einen einzelnen Trigger für dich ein; du musst ihn nicht von Hand einrichten: Alle aktivierten Trigger verwenden UND-Logik: Jede Bedingung muss erfüllt sein, damit der Funnel angezeigt wird. Du kannst im Schritt Triggers des Funnel-Editors weitere optionale Trigger hinzufügen (gruppiert in einem einklappbaren Bereich Additional triggers, der eine Anzahl anzeigt und sich automatisch öffnet, wenn optionale Trigger gesetzt sind). Die Recurring subtotal im Angebot zeigt dem Kunden, was seine nächste Verlängerung kosten wird. Von welchem Produkt dieser Preis stammt, hängt vom Upgrade-Typ ab: Das ist die häufigste Quelle für Verwirrung. Ein reines Frequenz-Upgrade behält bewusst dasselbe Produkt bei, daher kann seine Recurring subtotal immer nur den Preis des Trigger-Produkts anzeigen, unabhängig von der eingestellten Frequenz. Wenn du dort den Preis eines anderen Produkts erwartet hast, möchtest du höchstwahrscheinlich stattdessen Both, change frequency and replace subscription product. Die verwendete Menge stammt aus Override subscription quantity, das nur bei den Ersatz-Typen erscheint. Bei einem reinen Frequenz-Upgrade ist sie immer 1. Standardmäßig wird ein Upgrade ab dem nächsten Abrechnungszyklus des Kunden wirksam, wobei sein bestehendes Verlängerungsdatum erhalten bleibt. Wenn die Timing-Option für deinen Shop aktiviert ist, erscheint unter den Frequenzfeldern eine Checkbox:

My fulfillment provider ships the upgraded item on the current order

Wenn du sie anhakst, beginnt das neue Abrechnungsintervall sofort statt bei der nächsten Verlängerung, und das Feld One-time upgrade price in Schritt 4 wird freigeschaltet. Ein optionaler Anreiz, der auf jede zukünftige Verlängerung des upgegradeten Abonnements angewendet wird (nicht nur auf den ersten Zyklus). Nicht verfügbar für den Typ zum Hinzufügen eines Artikels. Wie das Feld angezeigt wird, hängt davon ab, ob der ausgewählte Selling Plan gestaffelte Preisrichtlinien hat:

• Wenn ein Selling Plan mit Rabattstufen ausgewählt ist (zum Beispiel ein Loop-Plan, der $20 Rabatt auf die erste Abbuchung und $10 Rabatt ab der zweiten Abbuchung gewährt), wird das Freitextfeld durch eine Liste von Optionsfeldern ersetzt, eines pro Stufe. Jede Option zeigt den Rabattbetrag und den Abbuchungsbereich, für den er gilt (zum Beispiel “Charge 1” oder “Charge 2 onward”). Wähle die Stufe, die auf jede zukünftige Verlängerung angewendet werden soll.
• Wenn kein Selling Plan ausgewählt ist oder der ausgewählte Plan keine Rabattstufen hat, erscheint das Standard-Freitextfeld. Gib den Betrag ein und wähle Percentage oder Fixed amount.

Der One-time upgrade price ist der Betrag, den der Kunde bei dieser Shopify-Bestellung zahlt, wenn er annimmt.

• Bei den Typen Change delivery or billing frequency und Both ist er standardmäßig auf 0 gesperrt, weil dein Abonnement-Anbieter am Ende des aktuellen Abrechnungszyklus abbucht und das Platzhalterprodukt in der Shopify-Bestellung mit $0.00 erscheint. Er wird nur bearbeitbar, wenn die Upgrade-Timing-Checkbox in Schritt 3 angehakt ist.
• Bei Replace with a different subscription product und Add another subscribable item to subscription gilt die Timing-Checkbox nicht, daher ist das Preisfeld immer bearbeitbar.

Was du eintragen solltest, hängt vom Upgrade-Typ ab:

• Frequenz, Ersatz oder beides: die Preisdifferenz zwischen dem ursprünglichen und dem upgegradeten Abonnement. Der Kunde behält sein Abonnement, und diese Abbuchung deckt die Differenz ab.
• Weiteren abonnierbaren Artikel hinzufügen: der Betrag für den hinzugefügten Artikel bei dieser Bestellung. Es wird nichts getauscht, daher gibt es keine Differenz zu berechnen: Das ist einfach das, was der Kunde jetzt für den neuen Artikel zahlt, der dann mit seinem Abonnement wiederkehrt. Siehe Einen Artikel zu einem bestehenden Abonnement hinzufügen.

First-order discount. Ein optionaler Rabatt, der nur auf diesen Upgrade-Kauf angewendet wird, eingegeben als Prozentsatz (%) oder Festbetrag. Er steht neben One-time upgrade price und erscheint immer dann, wenn dieses Feld bearbeitbar ist, sowohl im Tab Create new als auch im Tab Pick existing. Beim Typ zum Hinzufügen eines Artikels erscheint das Feld zwar, wird aber immer als 0 gespeichert; Angebote zum Hinzufügen eines Artikels haben nie einen Rabatt, lege also stattdessen den gewünschten Preis beim Angebotsprodukt fest. Das Angebotsprodukt ist nur ein visueller Platzhalter, kein echtes Produkt, das der Kunde kauft. Shopify erlaubt nicht, dass ein Abonnementprodukt nach einer Bestellung, die bereits ein Abonnement enthält, als Post-Purchase-Upsell angezeigt wird, daher erfasst Aftersell den Preis zwischen Upgrades stattdessen mit einer Platzhalter-SKU ohne Abonnement.

• Das Bild, der Titel und der Preis, die du festlegst, erscheinen in der Angebotskarte.
• Bei Annahme wird der angezeigte Preis in der Shopify-Bestellung berechnet, und Recharge, Skio oder Loop wendet das eigentliche Upgrade im nächsten Zyklus auf das Abonnement an.
• Wenn du Pick existing wählst, statt eines zu erstellen, muss das Produkt Einmalkäufe unterstützen; reine Abonnementprodukte werden aus der Auswahl herausgefiltert.