> ## 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.
# 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](/de/aftersell/subscription-upgrades-setup).
## Status der API-Key-Verifizierung
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 Berechtigungs-Trigger: Variant on subscription
Der Assistent richtet automatisch einen einzelnen Trigger für dich ein; du musst ihn nicht von Hand einrichten:
| Trigger | Einstellung |
| - | - |
| **Variant on subscription** | Auf deine berechtigte (Ziel-)Variante gesetzt. Wird nur ausgelöst, wenn diese Variante **als Abonnement-Position** in der Bestellung enthalten ist. |
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).
**Ersetze dies nicht durch einen Product-Trigger plus einen Subscription-Trigger.** Diese ältere Kombination besteht aus zwei unabhängigen Bedingungen, sodass eine Bestellung, die dein Trigger-Produkt als *Einmalkauf* zusammen mit einem *nicht zusammenhängenden* Abonnement-Artikel enthält, beide erfüllt: Der Funnel wird ausgelöst, und das Upgrade schlägt dann nachgelagert fehl, weil es kein passendes Abonnement zum Ändern gibt. **Variant on subscription** ist eine einzelne Bedingung, die nicht auf diese Weise auseinanderfallen kann, und der Assistent migriert ältere Funnels automatisch weg von dieser Kombination.
Ohne einen produktspezifischen Trigger wird ein Funnel möglicherweise Kunden angezeigt, deren Bestellung das berechtigte Abonnementprodukt nicht enthält. Das verschwendet Impressionen und erzeugt eine Abonnementänderung, die stillschweigend fehlschlägt: Das Angebotsprodukt wird der Bestellung hinzugefügt, aber in Recharge, Skio oder Loop wird kein Abonnement geändert.
Wenn **Show this funnel for all customers** aktiviert ist, überschreibt dies alle anderen Trigger und der Funnel wird bei jedem Checkout ausgelöst. Für Funnels mit Abonnement-Upgrades wird das nicht empfohlen.
## Welchen Preis die Recurring subtotal anzeigt
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:
| Upgrade-Typ | Preis stammt von |
| - | - |
| Change delivery or billing frequency | Dem **Trigger**-Produkt |
| Replace with a different subscription product | Dem **Ersatz**-Produkt |
| Both, change frequency and replace subscription product | Dem **Ersatz**-Produkt |
| Add another subscribable item to subscription | Dem **hinzugefügten** Artikel |
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.
## Upgrade-Timing
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.
Aftersell ändert die gerade aufgegebene Bestellung des Kunden nicht. Diese Einstellung verschiebt nur das Abrechnungsintervall. Hake sie nur an, wenn dein Fulfillment-Anbieter so eingerichtet ist, dass er das Platzhalterprodukt des Upgrades erkennt und den upgegradeten Artikel mit der aktuellen Bestellung versendet.
Diese Checkbox ist standardmäßig deaktiviert und nicht in jedem Shop verfügbar. Sie erscheint nur bei den Upgrade-Typen **Change delivery or billing frequency** und **Both, change frequency and replace subscription product** und erst, nachdem die Option für deinen Shop aktiviert wurde. Kontaktiere den Support über den In-App-Chat, wenn du sie benötigst.
## Wiederkehrender Rabatt
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**.
## One-time upgrade price nach Upgrade-Typ
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](#upgrade-timing) 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 Preis*differenz* 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](/de/aftersell/subscription-upgrades-add-item).
**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.
## Warum das Angebotsprodukt ein Platzhalter ist
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.