In diesem Dokument wird beschrieben, wie Sie mit Lifecycle-Events von Abos umgehen, z. B. Verlängerungen und Abläufe. Außerdem werden zusätzliche Abofunktionen beschrieben, z. B. das Anbieten von Werbeaktionen und die Möglichkeit für Nutzer, ihre eigenen Abos zu verwalten.
Wenn Sie keine Aboprodukte für Ihre App konfiguriert haben, lesen Sie den Hilfeartikel Produkte erstellen und konfigurieren.
Aboübersicht
Ein Abo ist eine wiederkehrende Transaktion, die Nutzern bestimmte Berechtigungen gewährt. Die Berechtigungen stellen eine Reihe von Vorteilen dar, auf die Nutzer innerhalb eines bestimmten Zeitraums zugreifen können. Ein Abo kann einen Nutzer beispielsweise zu einem Premium-Zugriff berechtigen.
Mit Basis-Abos und Angeboten können Sie mehrere Konfigurationen für dasselbe Aboprodukt erstellen. Sie können beispielsweise ein Einführungsangebot für Nutzer erstellen, die Ihre App noch nie abonniert haben. Ebenso können Sie ein Upgrade-Angebot für Nutzer erstellen, die bereits ein Abo haben.
Eine detaillierte Übersicht über Aboprodukte, Basis-Abos und Angebote findest du in der Dokumentation in der Play Console-Hilfe.
Die Play Billing Library unterstützt die folgenden Abotypen:
Abo: Bei diesem Typ entspricht ein Artikel einer Berechtigung. Beispiel: Abo eines Musik-Streamingdienstes.
Abo mit Add-ons: Bei diesem Typ können mehrere unterschiedliche Berechtigungen in einem einzigen Kauf gebündelt werden. Beispiel: Abos für einen Musikstreamingdienst und einen Videodienst. Informationen zu Abos mit Add-ons finden Sie unter Abos mit Add-ons.
Integration von Prepaid-Tarifen
Prepaid-Tarife werden nach Ablauf nicht automatisch verlängert. Wenn Nutzer ihre Abo-Berechtigung ohne Unterbrechung verlängern möchten, müssen sie einen Prepaid-Tarif für dasselbe Abo aufladen.
Starten Sie für Aufladungen den Abrechnungsvorgang wie beim ursprünglichen Kauf. Sie müssen nicht angeben, dass es sich bei einem Kauf um eine Aufladung handelt.
Für das Aufladen von Prepaid-Tarifen wird immer der Ersetzungsmodus CHARGE_FULL_PRICE verwendet. Sie müssen diesen Modus nicht explizit festlegen. Dem Nutzer wird sofort ein vollständiger Abrechnungszeitraum in Rechnung gestellt und seine Berechtigung wird um die im Aufladebetrag angegebene Dauer verlängert.
Nach einer Aufladung werden die folgenden Felder im Ergebnisobjekt Purchase aktualisiert, um die letzte Aufladung widerzuspiegeln:
- Bestell-ID
- Kaufzeitpunkt
- Unterschrift
- Kauftoken
- Bestätigt
Die folgenden Purchase-Felder enthalten immer dieselben Daten wie der ursprüngliche Kauf:
- Paketname
- Kaufstatus
- Produkte
- Automatische Verlängerung
Bestätigung des Prepaid-Kaufs
Ähnlich wie Abos mit automatischer Verlängerung müssen Prepaid-Tarife nach dem Kauf bestätigt werden. Sowohl der Erstkauf als auch alle Aufladungen müssen bestätigt werden. Weitere Informationen finden Sie unter Käufe verarbeiten.
Da Prepaid-Tarife unter Umständen nur eine kurze Laufzeit haben, ist es wichtig, den Kauf so schnell wie möglich zu bestätigen.
Prepaid-Tarife mit einer Dauer von einer Woche oder länger müssen innerhalb von drei Tagen bestätigt werden.
Prepaid-Tarife mit einer Laufzeit von weniger als einer Woche müssen innerhalb der Hälfte der Laufzeit bestätigt werden. Entwickler haben beispielsweise 1,5 Tage Zeit, um einen Prepaid-Tarif mit einer Laufzeit von drei Tagen zu bestätigen.
Integration von Ratenabos
Bei einem Ratenabo zahlen Nutzer das Abo in mehreren Raten über einen bestimmten Zeitraum, anstatt die gesamte Abogebühr im Voraus zu bezahlen.
Zusätzliche Hinweise zu Ratenabos:
- Verfügbarkeit nach Land: Die Funktion für Ratenabos ist nur in Brasilien, Frankreich, Italien und Spanien verfügbar. Die aktuelle Verfügbarkeit finden Sie in der Console.
- Preis festlegen: Wenn Sie den Preis für ein Ratenabo in der Console festlegen, entspricht der Preis dem monatlichen Zahlungsbetrag. In Kombination mit der festgelegten Mindestlaufzeit ergibt sich daraus der Gesamtbetrag für das Abo auf dem Kaufbildschirm.
- Mindestlaufzeit: Die Gesamtdauer der ursprünglichen Abo-Verpflichtung, während der monatliche Zahlungen erforderlich sind. Wenn ein Basis-Abo beispielsweise eine Mindestlaufzeit von 15 Monaten hat, leistet der Nutzer in diesem Zeitraum 15 monatliche Zahlungen.
- Verlängerungen: Im Zusammenhang mit Ratenabos bedeutet „Verlängerung“ das Ende einer Mindestlaufzeit, entweder der anfänglichen oder einer nachfolgenden Mindestlaufzeit. Nach der ersten Registrierung erfolgt die erste Verlängerung nach Ablauf der gesamten anfänglichen Mindestlaufzeit. Nachfolgende Verlängerungen erfolgen nach Ablauf der jeweiligen Mindestlaufzeit. Die Verlängerungsarten für Ratenabos können „Jeden Monat automatisch verlängern“ oder „Für dieselbe Laufzeit automatisch verlängern“ sein. Bei „monatlich automatisch verlängert“ gibt es keine nachfolgende Verpflichtung und der Tarif verhält sich wie ein Monatsabo, bei dem jede monatliche Abogebühr eine Verlängerung darstellt.
- Abrechnungszeitraum: Bei Ratenabos bezieht sich dies auf das wiederkehrende Intervall, in dem einzelne Zahlungen erfolgen, wie im Basis-Abo angegeben.
- Verhalten bei Tarifänderungen im Vergleich zu Preisänderungen: Bei Preisänderungen und Kündigungen ist die Zusicherung verbindlich. Wenn ein Nutzer kündigen möchte oder ein Entwickler den Preis ändern möchte, wird die Änderung zum Ende der Mindestlaufzeit wirksam. Bei Tarifänderungen ist die Zusicherung nicht verbindlich. Das bedeutet, dass die Tarifänderung nicht bis zum Ende einer Mindestlaufzeit warten muss. Sie wird entweder sofort oder am nächsten Zahlungstermin wirksam, je nachdem, welcher Ersetzungsmodus festgelegt wurde.
- Änderung des Abos innerhalb desselben Abos: Ein Wechsel von einem Basis-Abo mit Ratenzahlung zu einem Basis-Abo ohne Ratenzahlung desselben Aboprodukts ist nicht zulässig.
Entwicklerbenachrichtigungen in Echtzeit (RTDNs): Eine
SUBSCRIPTION_CANCELLATION_SCHEDULED-RTDN wird sofort nach der vom Nutzer initiierten Kündigung gesendet, wenn für die Mindestlaufzeit noch Zahlungen ausstehen. Die Kündigung ist ausstehend und wird erst am Ende der Mindestlaufzeit wirksam. Wenn der Nutzer das Abo nicht wiederherstellt, werden am Ende der Mindestlaufzeit RTDNs vom TypSUBSCRIPTION_CANCELEDundSUBSCRIPTION_EXPIREDgesendet.Auszahlungen / Umsatzrealisierung: Die Auszahlungen an Entwickler erfolgen, wenn Nutzer ihre monatlichen Zahlungen leisten. Es gelten dieselben Bedingungen wie für alle anderen Abos. Entwickler erhalten keine Vorauszahlung, wenn sich der Nutzer für das Abo mit Ratenzahlung registriert.
Versäumte Zahlungen: Wenn ein Nutzer eine Ratenzahlung für ein Abo versäumt, versuchen weder Google noch der Entwickler, diese versäumten oder ausstehenden Zahlungen vom Nutzer einzufordern. Google kann jedoch während eines anwendbaren Kulanzzeitraums oder einer Kontosperre gemäß seinen normalen Zahlungswiederholungspraktiken regelmäßig versuchen, die Zahlung einzuziehen. Google ist gegenüber dem Entwickler nicht für ausstehende Ratenzahlungen verantwortlich.
Verfügbarkeit der Play Billing Library: Das Feld
installmentDetailsist nur für PBL 7 oder höher verfügbar. Ab PBL 5 wird das Ratenabo mitqueryProductDetails()zurückgegeben, das Abo enthält jedoch keine detaillierten Rateninformationen wie die Anzahl der zugesicherten Zahlungen des Abos.
Deeplinks verwenden, damit Nutzer ein Abo verwalten können
Deine App sollte auf einem Bildschirm für Einstellungen oder Präferenzen einen Link enthalten, über den Nutzer ihre Abos verwalten können. Du kannst diesen Link in das natürliche Design deiner App einbinden.
Du kannst einen Deeplink von deiner App zum Google Play-Abocenter für nicht abgelaufene Abos einfügen. Diese kannst du über das Feld subscriptionState der Aboressource ermitteln. Es gibt mehrere Möglichkeiten, Deeplinks zum Abocenter im Google Play Store zu erstellen.
Link zum Abocenter
Verwende die folgende URL, um Nutzer auf die Seite weiterzuleiten, auf der alle ihre Abos angezeigt werden, wie in Abbildung 1 und 2 dargestellt:
https://play.google.com/store/account/subscriptions

Dieser Deeplink kann nützlich sein, um Nutzern zu helfen, ein gekündigtes Abo im Abocenter des Google Play Store wiederherzustellen.
Link zu einer bestimmten Seite für die Aboverwaltung (empfohlen)
Wenn du direkt auf die Verwaltungsseite für ein nicht abgelaufenes Abo verlinken möchtest, gib den Paketnamen und die productId an, die mit dem gekauften Abo verknüpft sind. Wenn du die productId für ein bestehendes Abo programmatisch ermitteln möchtest, frage das Backend deiner App ab oder rufe BillingClient.queryPurchasesAsync() auf, um eine Liste der Abos zu erhalten, die mit einem bestimmten Nutzer verknüpft sind. Jedes Abo enthält die entsprechende productId als Teil der Abostatusinformationen.
Jedes SubscriptionPurchaseLineItem-Objekt, das mit einem Abokauf verknüpft ist, enthält den productId-Wert, der mit dem Abo verknüpft ist, das der Nutzer in dieser Werbebuchung gekauft hat.
Verwenden Sie die folgende URL, um Nutzer zu einem bestimmten Bildschirm für die Aboverwaltung weiterzuleiten. Ersetzen Sie dabei „your-sub-product-id“ und „your-app-package“ durch die productId bzw. den Namen des App-Pakets:
https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package
Der Nutzer kann dann seine Zahlungsmethoden verwalten und auf Funktionen wie Kündigung, erneutes Abonnieren und Pausieren zugreifen.
Nutzern erlauben, ihr Abo zu upgraden, zu downgraden oder zu ändern
Du kannst bestehenden Abonnenten verschiedene Optionen anbieten, um ihr Abo an ihre Bedürfnisse anzupassen:
- Wenn ihr mehrere Abostufen verkauft, z. B. „Basic“- und „Premium“-Abos, könnt ihr Nutzern erlauben, die Stufe zu wechseln, indem sie das Basis-Abo oder Angebot eines anderen Abos kaufen.
- Sie können Nutzern erlauben, ihren aktuellen Abrechnungszeitraum zu ändern, z. B. von einem monatlichen zu einem jährlichen Abo zu wechseln.
- Sie können Nutzern auch erlauben, zwischen Abos mit automatischer Verlängerung und Prepaid-Tarifen zu wechseln.
Sie können diese Änderungen fördern, indem Sie Aboangebote mit einem Rabatt für berechtigte Nutzer anbieten. Sie können beispielsweise ein Angebot erstellen, das einen Rabatt von 50 % auf das erste Jahr gewährt, wenn ein Nutzer von einem Monatstarif zu einem Jahrestarif wechselt. Dieses Angebot können Sie auf Nutzer beschränken, die einen Monatstarif abonniert und dieses Angebot noch nicht gekauft haben. Weitere Informationen zu den Teilnahmevoraussetzungen für Angebote finden Sie in der Hilfe.
Abbildung 3 zeigt eine Beispiel-App mit drei verschiedenen Abos:
In Ihrer App könnte ein Bildschirm ähnlich wie in Abbildung 3 angezeigt werden, auf dem Nutzer die Möglichkeit haben, ihr Abo zu ändern. In jedem Fall sollte für Nutzer klar sein, welches Abo sie derzeit haben und welche Optionen sie haben, es zu ändern.
Wenn Nutzer sich für ein Upgrade, ein Downgrade oder eine Änderung ihres Abos entscheiden, gibst du einen Ersetzungsmodus an, der festlegt, wie der anteilige Wert des aktuellen kostenpflichtigen Abrechnungszeitraums angewendet wird und wann eine Änderung der Berechtigung erfolgt.
Ersatzmodi
In der folgenden Tabelle sind die verfügbaren Ersetzungsmodi, Beispielanwendungen und die Anzahl der als bezahlt geltenden Zahlungen aufgeführt.
Ersatzmodus |
Beschreibung |
Nutzungsbeispiel |
Verbindliche Zahlungen, die als bezahlt erfasst wurden (für den Ersatz eines Ratenabos) |
|
Das Abo wird sofort aktualisiert. Die verbleibende Zeit wird anhand der Preisdifferenz angepasst und dem neuen Abo gutgeschrieben, indem das nächste Abrechnungsdatum vorverlegt wird. Das ist das Standardverhalten. |
Upgrade auf eine teurere Stufe ohne sofortige zusätzliche Zahlung. |
0 |
|
Der Aboartikel wird sofort aktualisiert und der Abrechnungszeitraum bleibt unverändert. Die Preisdifferenz für den verbleibenden Zeitraum wird dem Nutzer dann in Rechnung gestellt. Hinweis: Diese Option ist nur für ein Upgrade eines Aboartikels verfügbar, bei dem sich der Preis pro Zeiteinheit erhöht. |
Upgrade auf eine teurere Stufe, ohne das Abrechnungsdatum zu ändern. |
1 |
|
Der Aboartikel wird sofort up- oder downgraded und dem Nutzer wird sofort der volle Preis für die neue Berechtigung in Rechnung gestellt. Der verbleibende Wert des vorherigen Abos wird entweder für dieselbe Berechtigung übernommen oder anteilig für die Zeit berechnet, wenn zu einer anderen Berechtigung gewechselt wird. Hinweis: Wenn für das neue Abo ein kostenloser Testzeitraum oder ein Einführungsangebot gilt, werden dem Nutzer zum Zeitpunkt des Upgrades oder Downgrades 0 € oder der Preis des Einführungsangebots in Rechnung gestellt. |
Upgrade von einem kürzeren auf einen längeren Abrechnungszeitraum. |
1 (Hinweis: 0, wenn das neue Abo einen kostenlosen Testzeitraum hat) |
|
Das Abo wird sofort aktualisiert und der neue Preis wird bei der Verlängerung des Abos berechnet. Der Abrechnungszeitraum bleibt gleich. |
Upgrade auf eine höhere Abostufe, wobei der verbleibende kostenlose Zeitraum erhalten bleibt. |
0 |
|
Das Abo wird erst bei der Verlängerung aktualisiert, aber der neue Kauf wird sofort mit den folgenden beiden Artikeln ausgestellt:
Hinweis: Bei Abos mit Ratenzahlung erfolgt die Aboänderung zu Beginn des nächsten Zahlungsdatums. |
Downgrade auf eine günstigere Stufe |
1 |
|
Der Zahlungsplan für den Aboartikel bleibt beim Ersatz unverändert. |
Abo-Artikel zu einem Abo mit Add-ons hinzufügen oder daraus entfernen, wenn ein bestimmter Artikel unverändert bleiben soll. |
– |
Weitere Informationen zu verschiedenen Upsell- und Winback-Anwendungen von Upgrade- oder Downgrade-Angeboten finden Sie im Leitfaden zu Angeboten und Werbeaktionen.
Ersatzmodus für einen Kauf festlegen
Sie können je nach Ihren Einstellungen und Ihrer Geschäftslogik verschiedene Ersetzungsmodi für verschiedene Arten von Abo-Umstellungen verwenden. In diesem Abschnitt wird erläutert, wie Sie einen Ersetzungsmodus für eine Änderung in einem Abo festlegen und welche Einschränkungen gelten.
Abo erneut abonnieren oder Tarif innerhalb desselben Abos wechseln
In der Google Play Console können Sie einen Standardersatzmodus festlegen. Mit dieser Einstellung kannst du auswählen, wann bestehenden Abonnenten der Betrag in Rechnung gestellt wird, wenn sie ein anderes Basis-Abo abschließen oder ein Angebot für dasselbe Abo in Anspruch nehmen oder das Abo nach einer Kündigung erneut abschließen. Die verfügbaren Optionen sind Sofort abrechnen (entspricht CHARGE_FULL_PRICE) und Am nächsten Abrechnungsdatum abrechnen (entspricht WITHOUT_PRORATION). Dies sind die einzigen relevanten Ersetzungsmodi, wenn du innerhalb desselben Abos das Basis-Abo wechselst.
Wenn du beispielsweise ein Rückgewinnungsangebot für dasselbe Abo implementierst, nachdem der Nutzer gekündigt hat, aber bevor das Abo endet, kannst du den neuen Kauf als regulären Kauf verarbeiten, ohne Werte in SubscriptionUpdateParams anzugeben. Das System verwendet den Standardersatzmodus, den Sie im Abo konfiguriert haben, und übernimmt automatisch die Umstellung vom alten auf den neuen Kauf.
Abo wechseln oder Standard-Ersetzungsmodus überschreiben
Wenn der Nutzer das Aboprodukt ändert, also ein anderes Abo kauft, oder wenn du den Standardersatzmodus aus irgendeinem Grund überschreiben möchtest, gibst du die anteilige Rate zur Laufzeit als Teil der Parameter für den Kaufvorgang an.
Beachten Sie die folgenden Einschränkungen, um ReplacementMode in SubscriptionProductReplacementParams oder SubscriptionUpdateParams im Rahmen der Konfiguration des Kaufvorgangs zur Laufzeit korrekt anzugeben:
- Wenn du ein Upgrade oder Downgrade durchführst oder einen Wechsel innerhalb desselben Abos zu einem Prepaid-Tarif von einem Prepaid-Tarif, einem sich automatisch verlängernden Abo oder einem Ratenzahlungsplan initiierst, ist der einzige zulässige Ersetzungsmodus
CHARGE_FULL_PRICE. Wenn du einen anderen Ersetzungsmodus angibst, schlägt der Kauf fehl und dem Nutzer wird ein Fehler angezeigt. - Wenn du innerhalb desselben Abos von einem Prepaid-Tarif oder einem sich automatisch verlängernden Abo zu einem sich automatisch verlängernden Abo wechselst, sind
CHARGE_FULL_PRICEundWITHOUT_PRORATIONgültige anteilige Abrechnungsmodi. Wenn du einen anderen anteiligen Modus angibst, schlägt der Kauf fehl und dem Nutzer wird ein Fehler angezeigt. - Der Wechsel von einem Basis-Abo mit Ratenzahlung zu einem Basis-Abo ohne Ratenzahlung innerhalb desselben Aboprodukts ist nicht zulässig.
- Wenn du den Ersetzungsmodus
KEEP_EXISTINGinSubscriptionProductReplacementParamsverwendest, um die Zahlung für einen Artikel während des Ersetzens unverändert zu lassen, muss die alte Produkt-ID mit der Produkt-ID des neuen Produkts übereinstimmen. DerKEEP_EXISTING-Modus wird inSubscriptionUpdateParamsnicht unterstützt.
Beispiele für Ersetzungen und Verhalten
Sehen Sie sich das folgende Szenario an, um die Funktionsweise der einzelnen anteiligen Modi zu verstehen:
Samwise hat ein Abo für Online-Inhalte der Country Gardener-App. Er hat ein Monatsabo für die Stufe 1-Version der Inhalte, die nur Text enthält. Dieses Abo kostet ihn 2 $ pro Monat und wird am Ersten des Monats verlängert.
Am 15. April hat sich Samwise für ein Upgrade auf die Jahresversion des Abos der Stufe 2 entschieden, das Video-Updates enthält und 36 $ pro Jahr kostet.
Beim Upgrade des Abos wählt der Entwickler einen anteiligen Modus aus. In der folgenden Liste wird beschrieben, wie sich die einzelnen anteiligen Modi auf das Abo von Samwise auswirken:
WITH_TIME_PRORATION
Das Stufe 1-Abo von Samwise endet sofort. Da er für einen vollen Monat (1. bis 30. April) bezahlt, aber nach der Hälfte des Abozeitraums ein Upgrade durchgeführt hat, wird die Hälfte des Abopreises (1 $) auf sein neues Abo angerechnet. Da das neue Abo jedoch 36 $ pro Jahr kostet, reicht das Guthaben von 1 $ nur für 10 Tage (16. bis 25. April). Am 26. April werden ihm daher 36 $ für ein neues Abo in Rechnung gestellt und am 26. April jedes Folgejahres weitere 36 $.
Du solltest die PurchasesUpdatedListener deiner App aufrufen, sobald der Kauf erfolgreich abgeschlossen wurde und du den neuen Kauf im Rahmen eines queryPurchasesAsync()-Aufrufs abrufen kannst. Dein Backend erhält sofort eine SUBSCRIPTION_PURCHASED-Entwicklerbenachrichtigung in Echtzeit.
CHARGE_PRORATED_PRICE
Dieser Modus kann verwendet werden, da der Abopreis pro Zeiteinheit für Stufe 2 (36 $/Jahr = 3 $/Monat) höher ist als der Abopreis pro Zeiteinheit für Stufe 1 (2 $/Monat). Das Stufe 1-Abo von Samwise endet sofort. Da er für einen ganzen Monat bezahlt, aber nur die Hälfte davon genutzt hat, wird die Hälfte des Monatsabos (1 $) auf sein neues Abo angerechnet. Da das neue Abo jedoch 36 $ pro Jahr kostet, betragen die Kosten für die verbleibenden 15 Tage 1,50 $. Ihm wird also die Differenz von 0,50 $ für sein neues Abo in Rechnung gestellt. Am 1. Mai werden Samwise 36 $ für die neue Abostufe und am 1. Mai jedes darauffolgenden Jahres weitere 36 $ in Rechnung gestellt.
Du solltest die PurchasesUpdatedListener deiner App aufrufen, sobald der Kauf erfolgreich abgeschlossen wurde und du den neuen Kauf im Rahmen eines queryPurchasesAsync()-Aufrufs abrufen kannst. Dein Backend erhält sofort eine SUBSCRIPTION_PURCHASED-Entwicklerbenachrichtigung in Echtzeit.
WITHOUT_PRORATION
Das Stufe 1-Abo von Samwise wird sofort und ohne Aufpreis auf Stufe 2 hochgestuft. Am 1. Mai werden ihm 36 $ für seine neue Abostufe und am 1. Mai jedes Folgejahres weitere 36 $ in Rechnung gestellt.
Du solltest die PurchasesUpdatedListener deiner App aufrufen, sobald der Kauf erfolgreich abgeschlossen wurde und du den neuen Kauf im Rahmen eines queryPurchasesAsync()-Aufrufs abrufen kannst. Dein Backend erhält sofort eine SUBSCRIPTION_PURCHASED-Entwicklerbenachrichtigung in Echtzeit.
DEFERRED
Das Stufe 1-Abo von Samwise läuft bis zum 30. April weiter. Am 1. Mai tritt das Abo der Stufe 2 in Kraft und Samwise werden 36 $ für seine neue Abostufe in Rechnung gestellt.
Du solltest die PurchasesUpdatedListener deiner App aufrufen, sobald der Kauf erfolgreich abgeschlossen wurde und du den neuen Kauf im Rahmen eines queryPurchasesAsync()-Aufrufs abrufen kannst. Dein Backend erhält sofort eine SUBSCRIPTION_PURCHASED-Entwicklerbenachrichtigung in Echtzeit. Du solltest den Kauf genauso verarbeiten wie jeden anderen neuen Kauf zu diesem Zeitpunkt. Bestätige insbesondere den neuen Kauf. Beachte, dass die startTime des neuen Abos erst dann ausgefüllt wird, wenn der Ersatz wirksam wird, also wenn das alte Abo abläuft. An diesem Punkt erhalten Sie eine SUBSCRIPTION_RENEWED-RTDN für das neue Abo. Weitere Informationen zum Verhalten von ReplacementMode.DEFERRED findest du unter Verzögerten Ersatz verarbeiten.
CHARGE_FULL_PRICE
Das Stufe 1-Abo von Samwise endet sofort. Sein Stufe-2-Abo beginnt heute und ihm werden 36 $ in Rechnung gestellt. Da er für einen ganzen Monat bezahlt, aber nur die Hälfte davon genutzt hat, wird die Hälfte des Monatsabos (1 $) auf sein neues Abo angerechnet. Da das neue Abo 36 € pro Jahr kostet, wird die Laufzeit seines Abos um 1/36 eines Jahres (ca. 10 Tage) verlängert. Die nächste Abrechnung für Samwise erfolgt also in einem Jahr und 10 Tagen und beträgt 36 $. Danach werden ihm jedes Jahr 36 $ in Rechnung gestellt.
Sehen Sie sich bei der Auswahl eines anteiligen Modus unsere Empfehlungen für den Ersatz an.
KEEP_EXISTING
Samwise hat ein Abo für Onlineinhalte der App „Country Gardener“. Er hat ein Monatsabo für Plan 1 für grundlegende Inhalte. Dieses Abo kostet 3 Monate lang einen Einführungspreis von 2 $ pro Monat und danach 4 $ pro Monat. Samwise hat diesen Artikel am 1. April gekauft. Die Country Gardener-App bietet Plan 2 als Add-on-Spezialinhalt für 3 $ pro Monat an. Am 15. April hat Samwise seinem Abo der Country Gardener-App Tarif 2 hinzugefügt und den bestehenden Tarif 1 beibehalten. Der Zahlungsplan von Samwise sieht so aus:
- Ein anteiliger Preis von 1,50 $ für Tarif 2, fällig am 15.April.
- Ein Preis von 5,00 $ pro Monat für die folgenden 2 Monate, der sowohl den Einführungspreis für Abo 1 als auch den regulären Preis für Abo 2 abdeckt.
- Danach wird monatlich ein Betrag von 7, 00 $ fällig.
Aboänderungen in der App auslösen
Ihre App kann Nutzern ein Upgrade oder Downgrade anbieten. Die Schritte sind dieselben wie beim Starten eines Kaufvorgangs. Bei einem Upgrade oder Downgrade musst du jedoch Details zum aktuellen Abo, zum zukünftigen (aktualisierten oder herabgestuften) Abo und zum zu verwendenden Ersetzungsmodus angeben.
„SubscriptionProductReplacementParams“ für den Ersatz verwenden (bevorzugt)
Im folgenden Beispiel wird gezeigt, wie Sie ein Abo mit SubscriptionProductReplacementParams aktualisieren.
Das Objekt
BillingFlowParams.ProductDetailsParamshat jetzt einesetSubscriptionProductReplacementParams()-Methode, mit der Sie Informationen zum Ersetzen auf Produktebene angeben können.SubscriptionProductReplacementParamshat zwei Setter-Methoden:setOldProductId:Dies ist das alte Produkt, das durch das Produkt im aktuellenProductDetails.ersetzt werden soll.setReplacementMode:Dies ist der Ersetzungsmodus auf Artikelebene. Die Modi sind im Wesentlichen mitSubscriptionUpdateParamsidentisch, aber die Wertzuordnung wurde aktualisiert.
Die vorhandenen Parameter für die Aktualisierung der Kaufstufe
BillingFlowParams.setSubscriptionUpdateParams()sollten mitsetOldPurchaseToken()erstellt werden.Sobald
setSubscriptionProductReplacementParams()für eine derProductDetailsParamsaufgerufen wird, hatSubscriptionUpdateParams.setSubscriptionReplacementMode()keine Auswirkungen mehr.
Im folgenden Codebeispiel wird gezeigt, wie ein Abo von (old_product_1, old_product_2) zu (product_1, product_2, product_3) geändert wird. In diesem Szenario ersetzt product_1 old_product_1, product_2 ersetzt old_product_2 und product_3 wird dem Abo sofort hinzugefügt.
Kotlin
val billingClient: BillingClient = this.billingClient val replacementModeForBasePlan: Int = SubscriptionProductReplacementParams.ReplacementMode.KEEP_EXISTING val replacementModeForAddon: Int = SubscriptionProductReplacementParams.ReplacementMode.CHARGE_PRORATED_PRICE val purchaseTokenOfExistingSubscription: String = "your_old_purchase_token" // ProductDetails instances obtained from queryProductDetailsAsync(); val productDetailsParams1 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails1) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan) .build() ) .build() val productDetailsParams2 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails2) // Required: Set the ProductDetails object .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon) .build() ) .build() // Example for a third item without replacement params val productDetailsParams3 = ProductDetailsParams.newBuilder() .setProductDetails(productDetails3) // Required: Set the ProductDetails object .build() val newProductDetailsList = listOf( productDetailsParams1, productDetailsParams2, productDetailsParams3 ) val billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build() ) .setProductDetailsParamsList(newProductDetailsList) .build() // To launch the billing flow: billingClient.launchBillingFlow(activity, billingFlowParams)
Java
BillingClient billingClient = …; int replacementModeForBasePlan =…; int replacementModeForAddon =…; // ProductDetails obtained from queryProductDetailsAsync(). ProductDetailsParams productDetails1 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_1") .setReplacementMode(replacementModeForBasePlan)) .build(); ProductDetailsParams productDetails2 = ProductDetailsParams.newBuilder() .setSubscriptionProductReplacementParams( SubscriptionProductReplacementParams.newBuilder() .setOldProductId("old_product_id_2") .setReplacementMode(replacementModeForAddon)) .build(); ProductDetailsParams productDetails3 = ...; ArrayListnewProductDetailsList = new ArrayList<>(); newProductDetailsList.add(productDetails1); newProductDetailsList.add(productDetails2); newProductDetailsList.add(productDetails3); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken(purchaseTokenOfExistingSubscription) .build()) .setProductDetailsParamsList(productDetailsList) .build(); billingClient.launchBillingFlow(billingFlowParams);
SubscriptionUpdateParams für Ersatz festlegen (eingestellt)
Im folgenden Beispiel wird gezeigt, wie Sie ein Abo mit SubscriptionUpdateParams aktualisieren.
Kotlin
val offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken() val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList( listOf( BillingFlowParams.ProductDetailsParams.newBuilder() .setProductDetails(productDetails) .setOfferToken(offerToken) .build() ) ).setSubscriptionUpdateParams( BillingFlowParams.SubscriptionUpdateParams.newBuilder() .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode( BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE ) .build() ).build() billingClient.launchBillingFlow( activity, billingParams ) // ...
Java
String offerToken = productDetails .getSubscriptionOfferDetails(selectedOfferIndex) .getOfferToken(); BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder() .setProductDetailsParamsList( ImmuableList.of( ProductDetailsParams.newBuilder() // fetched using queryProductDetailsAsync .setProductDetails(productDetails) // offerToken can be found in // ProductDetails=>SubscriptionOfferDetails .setOfferToken(offerToken) .build())) .setSubscriptionUpdateParams( SubscriptionUpdateParams.newBuilder() // purchaseToken can be found in Purchase#getPurchaseToken .setOldPurchaseToken("old_purchase_token") .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE) .build()) .build(); BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams); // ...
Empfehlungen für Ersatzgeräte
In der folgenden Tabelle sind verschiedene Szenarien für die anteilige Berechnung aufgeführt, zusammen mit unseren Empfehlungen für jedes Szenario:
| Szenario | Empfohlener Ersatzmodus | Ergebnis |
|---|---|---|
| Upgrade auf eine teurere Stufe | CHARGE_PRORATED_PRICE |
Der Nutzer erhält sofort Zugriff, während der Abrechnungszeitraum gleich bleibt. |
| Downgrade auf eine günstigere Stufe | DEFERRED |
Der Nutzer hat bereits für die teurere Stufe bezahlt, sodass er bis zum nächsten Abrechnungsdatum Zugriff behält. |
| Upgrade während eines kostenlosen Testzeitraums, wobei der Testzeitraum beibehalten wird | WITHOUT_PRORATION |
Der Nutzer führt für den Rest des Testzeitraums ohne Aufpreis ein Upgrade auf eine höhere Stufe durch. |
| Upgrade während eines kostenlosen Testzeitraums – Zugriff auf den kostenlosen Testzeitraum wird beendet | CHARGE_PRORATED_PRICE |
Der Nutzer erhält sofort Zugriff auf die neue Stufe und der verbleibende Wert des kostenlosen Testzeitraums wird übertragen. Der übertragene Wert wird auf Grundlage des Preises des Basis-Abos berechnet. |
| Beibehalten des Zahlungsplans einiger Abo-Artikel, während andere Abo-Artikel zum Abo mit Add-ons hinzugefügt oder daraus entfernt werden. | KEEP_EXISTING |
Der Nutzer zahlt weiterhin den alten Preis für den unveränderten Artikel. Neue Elemente werden sofort hinzugefügt. Andere alte Elemente können durch Angabe eines Ersetzungsmodus ersetzt oder entfernt werden. |
Käufe von Aboänderungen verarbeiten
Aboänderungen sind in jeder Hinsicht neue Käufe und sollten nach erfolgreichem Abschluss des Abrechnungsvorgangs als solche verarbeitet und bestätigt werden. Zusätzlich zur ordnungsgemäßen Verarbeitung des neuen Kaufs musst du den ersetzten Kauf deaktivieren.
Das In-App-Verhalten ist dasselbe wie bei jedem neuen Kauf. Deine App erhält das Ergebnis des neuen Kaufs in deinem PurchasesUpdatedListener und der neue Kauf ist in queryPurchasesAsync verfügbar.
Die Google Play Developer API gibt in der Aboressource den Wert linkedPurchaseToken zurück, wenn ein Kauf einen vorhandenen Kauf ersetzt. Sie können itemReplacement unter SubscriptionPurchaseLineItem im neuen Kauf prüfen, um die Details zum Ersatz auf Artikelebene zu sehen.
Außerdem können Sie das Feld offerPhase verwenden, um die aktuelle Angebotsphase (z. B. anteiliger Zeitraum oder kostenloser Testzeitraum) für das neue Abo zu ermitteln und so eine personalisierte Nutzererfahrung zu bieten. Achten Sie darauf, das in der linkedPurchaseToken bereitgestellte Token zu entwerten, damit das alte Token nicht für den Zugriff auf Ihre Dienste verwendet wird. Informationen zum Umgang mit Upgrades und Downgrades finden Sie unter Upgrades, Downgrades und erneute Registrierungen.
Wenn du das neue Kaufftoken erhältst, folge dem gleichen Überprüfungsverfahren wie bei der Überprüfung eines neuen Kaufftokens. Bestätige diese Käufe mit BillingClient.acknowledgePurchase() aus der Google Play Billing Library oder Purchases.subscriptions:acknowledge aus der Google Play Developer API.
Ersatzgerät mit späterer Rückgabe
Im Modus „Verzögerter Ersatz“ kann ein Nutzer die verbleibende Berechtigung im alten Abo aufbrauchen, bevor das neue Abo beginnt.
Wenn du ReplacementMode.DEFERRED für einen neuen Kauf verwendest, gibt queryPurchasesAsync() nach dem Kaufvorgang ein neues Kaufftoken zurück, das mit dem alten Produkt verknüpft bleibt, bis der verzögerte Ersatz am nächsten Verlängerungsdatum erfolgt. Danach wird das neue Produkt zurückgegeben.
In der Vergangenheit konntest du diese Nutzererfahrung mit der verworfenen ProrationMode.DEFERRED erreichen. ProrationMode.DEFERRED wurde jedoch mit der Play Billing Library 6 verworfen. In der folgenden Tabelle sehen Sie, wo sich das Verhalten unterscheidet:
Zeit |
ProrationMode.DEFERRED (eingestellt) |
ReplacementMode.DEFERRED |
Direkt nach dem erfolgreichen Kaufvorgang (App) |
Die Berechtigung für das alte Abo bleibt bis zum nächsten Verlängerungsdatum bestehen. Damit die App die richtige Berechtigung gewährt, gibt Das neue Kaufftoken wird nicht angezeigt und kann daher zu diesem Zeitpunkt nicht verarbeitet werden. |
Das neue Kaufftoken wird angezeigt und sollte an dieser Stelle verarbeitet werden. Dabei muss berücksichtigt werden, wann der Ersatz erfolgen soll. |
Direkt nach dem erfolgreichen Kaufvorgang (Backend) |
Die RTDN „SUBSCRIPTION_PURCHASED“ wird nach dem Kaufvorgang nicht gesendet. Das Backend wird noch nicht über den neuen Kauf informiert. |
Die RTDN „SUBSCRIPTION_PURCHASED“ mit der alten „product_id“ wird sofort nach dem Kaufvorgang für das neue Kauf-Token gesendet. Wenn Sie die Methode purchases.subscriptionsv2.get mit dem neuen Kauf-Token aufrufen, wird ein Kauf mit einer „startTime“ zurückgegeben, die die Kaufzeit mit zwei Werbebuchungen angibt:
SUBSCRIPTION_EXPIRED wird für das alte Kaufftoken gesendet. Wenn Sie die Methode purchases.subscriptionsv2.get mit dem alten Kaufftoken aufrufen, wird es als abgelaufen angezeigt. Die Berechtigung für das alte Abo wird für die verbleibende Zeit auf den neuen Kauf übertragen. |
Beim Ersetzen – erste Verlängerung nach dem Kaufvorgang (App) |
Das neue Kaufftoken wird jetzt angezeigt und sollte verarbeitet werden. |
Der neue Kauf sollte bereits verarbeitet worden sein, wenn der Kaufvorgang erfolgreich war. Die App muss also keine besonderen Maßnahmen ergreifen, außer dafür zu sorgen, dass die richtige Berechtigung gewährt wird. |
Bei Ersatz – erste Verlängerung nach dem Kaufvorgang (Backend) |
Der neue Kauf kann jetzt verarbeitet und bestätigt werden, wenn die erste SUBSCRIPTION_RENEWED-RTDN gesendet wird. Anhand der |
Der neue Kauf wurde verarbeitet und bestätigt, als die RTDN „SUBSCRIPTION_PURCHASED“ für das neue Kauftoken gesendet und als „startTime“ aufgezeichnet wurde. Bei „ReplacementMode.DEFERRED“ folgen die ersten Verlängerungen dem Standardverhalten aller anderen Verlängerungen. Sie müssen keine spezielle Logik für Ersetzungen verarbeiten, wenn dieses Ereignis eintritt. Wenn Sie die Methode purchases.subscriptionsv2.get mit dem neuen Kaufftoken aufrufen, wird ein Kauf mit zwei Werbebuchungen zurückgegeben:
|
Anstelle des verworfenen ProrationMode.DEFERRED sollte ab sofort ReplacementMode.DEFERRED verwendet werden, da es dasselbe Verhalten in Bezug auf Berechtigungsänderungen aufweist, aber eine Möglichkeit bietet, den Kauf zu verwalten, die besser mit dem Verhalten bei anderen neuen Käufen übereinstimmt.
Kundenverwaltung
Mit Entwicklerbenachrichtigungen in Echtzeit kannst du sofort erkennen, wenn ein Nutzer kündigt. Wenn ein Nutzer kündigt, aber sein Abo noch nicht abgelaufen ist, kannst du ihm Push-Benachrichtigungen oder In-App-Nachrichten senden, um ihn zu bitten, das Abo wieder zu aktivieren.
Wenn du die Anzahl der Kündigungen reduzieren möchtest, die in Google Play initiiert werden, kannst du Angebote zur Kundenbindung konfigurieren. Google Play zeigt berechtigten Abonnenten ein Angebot zur Kundenbindung an, wenn sie versuchen, ihr Abo zu kündigen. Wenn sie das Angebot annehmen, wird ihr Abo zu einem ermäßigten Preis fortgesetzt.
Nachdem ein Nutzer sein Abo gekündigt hat, kannst du versuchen, ihn entweder in deiner App oder über den Google Play Store zurückzugewinnen. In der folgenden Tabelle werden verschiedene Aboszenarien sowie die zugehörigen Rückgewinnungsaktionen und App-Anforderungen beschrieben.
| Vor Ablauf des Abos | Nach Ablauf des Abos | |||
| In-App | Im Google Play Store | In-App | Im Google Play Store | |
| Funktion „Kunden zurückgewinnen“ | In-App-Abo | Wiederherstellen | In-App-Abo | Erneut abonnieren |
| Nutzer durchläuft den Bezahlvorgang | Ja | Nein | Ja | Ja |
| Das Nutzerabo bleibt mit derselben SKU verknüpft. | Nutzer können sich für dieselbe oder eine andere SKU registrieren | Ja | Nutzer können sich für dieselbe oder eine andere SKU registrieren | Ja |
| Erstellt ein neues Kaufftoken | Ja | Nein | Ja | Ja |
| Standardmäßig aktiviert | Nein | Ja, Support für alle Entwickler erforderlich | Nein |
Apps ohne Billing Library 2.0+: Nein Apps mit Billing Library 2.0+: Ja. Entwickler können die Funktion in der Console deaktivieren. |
| Wann dem Nutzer der Preis in Rechnung gestellt wird |
Bei Verwendung derselben SKU: Ende des aktuellen Abrechnungszeitraums. Bei Verwendung einer anderen SKU: hängt vom anteiligen Modus ab. |
Ende des aktuellen Abrechnungszeitraums | Sofort | Sofort |
| Implementierung erforderlich | Stellen Sie in Ihrer App eine Benutzeroberfläche für die erneute Registrierung bereit. |
Änderung des Abostatus erkennen Deeplink zum Google Play Store |
In Ihrer App eine Benutzeroberfläche für die erneute Registrierung bereitstellen | Out-of-App-Käufe verarbeiten |
Vor Ablauf des Abos – In-App
Bei gekündigten, aber noch nicht abgelaufenen Abos kannst du Abonnenten erlauben, ihr Abo in deiner App wiederherzustellen. Verwende dazu denselben Kaufvorgang für In-App-Produkte wie für neue Abonnenten. Achte darauf, dass in der Benutzeroberfläche angezeigt wird, dass der Nutzer ein bestehendes Abo hat. Beispielsweise könntest du das aktuelle Ablaufdatum und den wiederkehrenden Preis des Nutzers mit einem Button Reaktivieren anzeigen.
In den meisten Fällen möchtest du dem Nutzer denselben Preis und dieselbe SKU anbieten, die er bereits abonniert hat:
- Leite einen neuen Abokauf mit derselben SKU ein.
- Das neue Abo ersetzt das alte und wird am selben Ablaufdatum verlängert. Das alte Abo wird sofort als abgelaufen markiert.
- Beispiel: Achilles hat ein Abo für die Beispiel-Musik-App, das am 1. August abläuft. Am 10. Juli schließt er das Monatsabo zum selben Preis pro Monat wieder ab. Das neue Abo wird mit dem verbleibenden Guthaben anteilig berechnet, ist sofort aktiv und wird weiterhin am 1. August verlängert.
Wenn du einen anderen Preis anbieten möchtest, z. B. einen neuen kostenlosen Testzeitraum oder einen Rabatt zur Rückgewinnung, kannst du dem Nutzer stattdessen eine andere SKU anbieten:
- Leiten Sie ein Upgrade oder Downgrade mit der anderen SKU ein und verwenden Sie dabei den Ersetzungsmodus
WITHOUT_PRORATION. - Das neue Abo ersetzt das alte und wird am selben Ablaufdatum verlängert. Dem Nutzer wird der Preis der neuen SKU, einschließlich etwaiger Einführungspreise, am ursprünglichen Ablaufdatum in Rechnung gestellt. Wenn das alte Abo mit einer verschleierten Konto-ID erstellt wurde, sollte dieselbe ID für Upgrades und Downgrades an die
BillingFlowParamsübergeben werden. - Beispiel: Achilles hat ein Abo für die Beispiel-Musik-App, das am 1. August abläuft. Am 10. Juli schließt er ein Jahresabo zum Einführungspreis ab. Das neue Abo ist sofort aktiv und dem Nutzer wird am 1. August der Einführungspreis in Rechnung gestellt.
- Wenn du dich dafür entscheidest, einen kostenlosen Testzeitraum oder einen Einführungspreis in deine SKU zur Rückgewinnung aufzunehmen, musst du dafür sorgen, dass der Nutzer die Voraussetzungen erfüllt. Deaktiviere dazu in der Google Play Console das Kästchen Einen kostenlosen Testzeitraum pro App zulassen, wodurch der Nutzer nur einen kostenlosen Testzeitraum pro App erhält.
Wenn du das Kaufftoken erhältst, verarbeite den Kauf wie bei einem neuen Abo. Außerdem gibt die Google Play Developer API in der Aboressource einen linkedPurchaseToken zurück. Achten Sie darauf, das in der linkedPurchaseToken bereitgestellte Token zu entwerten, damit das alte Token nicht für den Zugriff auf Ihre Dienste verwendet wird.
Vor Ablauf des Abos – im Google Play Store
Solange das Abo gekündigt, aber noch aktiv ist, können Nutzer es im Abocenter von Google Play wiederherstellen, indem sie auf Erneut abonnieren (früher Wiederherstellen) klicken. Das Abo und das Kaufftoken bleiben gleich.
Weitere Informationen zum Wiederherstellen von Abos finden Sie unter Wiederherstellungen.
Nach Ablauf des Abos – In-App
Du kannst Nutzern mit abgelaufenen Abos erlauben, dein Abo in deiner App noch einmal abzuschließen. Verwende dazu denselben Kaufvorgang für In-App-Produkte wie für neue Abonnenten. Wichtige Hinweise:
- Wenn Sie Nutzern einen Rabatt anbieten möchten, können Sie eine Produkt-ID mit einem Sonderpreis für Ihr Abo anbieten, auch als Winback-SKU bezeichnet. Du kannst das Angebot in deiner App bereitstellen oder den Nutzer außerhalb der App über das Angebot informieren, z. B. per E-Mail.
- Wenn du ein Abo zur Rückgewinnung starten möchtest, starte den Kaufvorgang in deiner Android-App mit der Google Play Billing Library. Das ist derselbe Vorgang wie bei einem neuen Abo, aber du kannst die SKU bestimmen, die für den Nutzer verfügbar ist.
- Wenn du dich dafür entscheidest, einen kostenlosen Testzeitraum oder einen Einführungspreis in deine SKU zur Rückgewinnung aufzunehmen, musst du dafür sorgen, dass der Nutzer die Voraussetzungen erfüllt. Entferne dazu in der Google Play Console das Häkchen aus dem Kästchen Einen kostenlosen Testzeitraum pro App zulassen, wodurch der Nutzer nur einen kostenlosen Testzeitraum pro App erhält.
- Wenn der Nutzer dieselbe SKU noch einmal abonniert, hat er keinen Anspruch mehr auf kostenlose Testzeiträume oder Einführungspreise. Achte darauf, dass deine Benutzeroberfläche dies widerspiegelt.
Wenn du das Kaufftoken erhältst, verarbeite den Kauf wie bei einem neuen Abo. Sie erhalten in der Aboressource keine linkedPurchaseToken.
Nach Ablauf des Abos – im Google Play Store
Wenn diese Option aktiviert ist, können Nutzer die gleiche SKU bis zu ein Jahr nach Ablauf noch einmal abonnieren, indem sie im Google Play-Abocenter auf Erneut abonnieren klicken. Dadurch werden ein neues Abo und ein neues Kaufftoken generiert.
Das erneute Abonnieren gilt als Out-of-App-Kauf. Beachte daher die Best Practices für die ordnungsgemäße Bestätigung über dein Backend.
Ihr Abo bewerben
Du kannst Gutscheincodes erstellen, um ausgewählten Nutzern einen verlängerten kostenlosen Testzeitraum für ein bestehendes Abo zu gewähren. Weitere Informationen finden Sie unter Gutscheincodes.
Bei kostenlosen Testzeiträumen prüft Google Play vor Beginn des Testzeitraums, ob der Nutzer eine gültige Zahlungsmethode hat. Einige Nutzer sehen diese Bestätigung möglicherweise als Reservierung oder Belastung ihrer Zahlungsmethode. Diese Reservierung oder Belastung ist vorübergehend und wird später rückgängig gemacht oder erstattet.
Nach Ablauf des Testzeitraums wird die Zahlungsmethode des Nutzers mit dem vollen Abobetrag belastet.
Wenn ein Nutzer ein Abo während des kostenlosen Testzeitraums kündigt, bleibt das Abo bis zum Ende des Testzeitraums aktiv und es fallen nach Ablauf des Testzeitraums keine Kosten an.
Abrechnung für einen Abonnenten aufschieben
Sie können den Berechtigungszeitraum für ein Abo mit der Methode subscriptionsv2.defer verlängern. Wenn Sie ein Abo mit Add-ons verschieben, werden alle Elemente im Abo um denselben Zeitraum verschoben. Während des Aufschubzeitraums hat der Nutzer ein Abo für Ihre Inhalte mit vollem Zugriff, ihm wird jedoch nichts in Rechnung gestellt. Das Verlängerungsdatum des Abos wird aktualisiert, sodass es dem neuen Datum entspricht.
Bei Prepaid-Tarifen können Sie die API zum Aufschieben der Abrechnung verwenden, um das Ablaufdatum zu verschieben.
Die verzögerte Abrechnung bietet folgende Möglichkeiten:
- Du kannst Nutzern als Sonderangebot kostenlosen Zugriff gewähren, z. B. eine Woche kostenlos, wenn sie einen Film kaufen.
- Kunden aus Kulanz kostenlosen Zugriff gewähren
Die Abrechnung kann pro API-Aufruf um mindestens einen Tag und maximal ein Jahr verschoben werden. Wenn du die Abrechnung noch weiter aufschieben möchtest, kannst du die API vor dem neuen Abrechnungsdatum noch einmal aufrufen.
Beispiel: Darcy hat ein Monatsabo für Onlineinhalte der App „Fishing Quarterly“. Normalerweise werden ihr am ersten Tag jedes Monats 1, 25 £ in Rechnung gestellt. Im März hat sie an einer Onlineumfrage des App-Publishers teilgenommen. Der Verlag belohnt sie mit sechs kostenlosen Wochen, indem er die nächste Zahlung auf den 15. Mai verschiebt, also sechs Wochen nach dem zuvor geplanten Abrechnungsdatum am 1. April.
- Darcy werden für April und Anfang Mai keine Kosten in Rechnung gestellt und sie hat weiterhin Zugriff auf die Inhalte. Am 15.Mai wird ihr die normale Abogebühr von 1, 25 £ für den Monat in Rechnung gestellt. Das nächste Verlängerungsdatum ist jetzt der 15. Juni.
Wenn du eine Abrechnung verschiebst, solltest du den Nutzer per E-Mail oder in der App darüber informieren, dass sich sein Abrechnungsdatum geändert hat.
Vorgehensweise bei abgelehnten Zahlungen
Wenn bei der Verlängerung eines Abos Zahlungsprobleme auftreten, versucht Google eine Zeit lang regelmäßig, das Abo zu verlängern, bevor es gekündigt wird. Dieser Wiederherstellungszeitraum kann aus einem Kulanzzeitraum, gefolgt von einer Kontosperre, bestehen. In diesem Zeitraum sendet Google dem Nutzer E‑Mails und Benachrichtigungen, in denen er aufgefordert wird, seine Zahlungsmethode zu aktualisieren.
Nach der Ablehnung der Zahlung beginnt ein Kulanzzeitraum, sofern einer konfiguriert ist. Während des Kulanzzeitraums solltest du dafür sorgen, dass der Nutzer weiterhin Zugriff auf die Aboberechtigungen hat.
Nach Ablauf des Kulanzzeitraums wird für das Abo eine Kontosperre angewendet. Während der Kontosperre sollten Sie dafür sorgen, dass der Nutzer keinen Zugriff auf die Aboberechtigungen hat.
In der Google Play Console können Sie die Dauer des Kulanzzeitraums und der Kontosperre für jedes Basis-Abo mit automatischer Verlängerung festlegen. Wenn Sie eine Zeitspanne festlegen, die unter den Standardwerten liegt, kann sich die Anzahl der Abos verringern, die nach abgelehnten Zahlungen wiederhergestellt werden.
Wenn du die Wahrscheinlichkeit maximieren möchtest, dass ein Abo nach einer abgelehnten Zahlung wiederhergestellt wird, kannst du den Nutzer über das Zahlungsproblem informieren und ihn bitten, es zu beheben.
Du kannst dies entweder selbst tun, wie in den Abschnitten Kulanzzeitraum und Kontosperre beschrieben, oder die In-App-Messaging API implementieren, über die Google Nutzern in deiner App eine Nachricht anzeigt.
Wenn ein Zahlungsproblem auftritt, kann Google Play deinen Nutzern eine Benachrichtigung anzeigen. Dazu können Sie die In-App-Messaging-Funktion verwenden, um sie über ausstehende Zahlungen zu informieren. Wenn du In-App-Messaging aktiviert hast, wird während des Kulanzzeitraums und der Kontosperre einmal täglich eine Nachricht zu Zahlungsproblemen angezeigt. So können Nutzer das Zahlungsproblem beheben, ohne die App zu verlassen. Weitere Informationen finden Sie unter In-App-Messaging.
In-App-Messaging
Wenn du In-App-Messaging mit InAppMessageCategoryId.TRANSACTIONAL aktiviert hast, zeigt Google Play Nutzern eine Nachricht an, wenn ein Zahlungsproblem oder eine ausstehende Opt-in-Preiserhöhung vorliegt.
Wir empfehlen, diese API immer dann aufzurufen, wenn der Nutzer die App öffnet, um festzustellen, ob die Mitteilung angezeigt werden soll.
Wenn der Nutzer sein Abo erfolgreich wiederhergestellt oder die Preiserhöhung bestätigt hat, erhältst du den Antwortcode SUBSCRIPTION_STATUS_UPDATED zusammen mit einem Kauf-Token. Anschließend sollten Sie dieses Kaufftoken verwenden, um die Google Play Developer API aufzurufen und den Abostatus in Ihrer App zu aktualisieren.
In-App-Messaging einbinden
Verwenden Sie BillingClient.showInAppMessages(), um Nutzern In-App-Nachrichten anzuzeigen.
Hier ein Beispiel für das Auslösen des In-App-Messaging-Ablaufs:
Kotlin
val inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build() // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages( activity, inAppMessageParams, object : InAppMessageResponseListener { override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED ) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } } )
Java
InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder() .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL) .build(); // Note: To display the in-app message, PBL requires an activity instance that // can provide a valid window token. This token is necessary for the Play Store // to display the message overlay correctly on top of the application's window. // The passed Activity must be in a state where its window is created and // attached to the WindowManager. billingClient.showInAppMessages(activity, inAppMessageParams, new InAppMessageResponseListener() { @Override public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) { if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) { // The flow has finished and there is no action needed from developers. } else if (inAppMessageResult.responseCode == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) { // The subscription status changed. For example, a subscription // is recovered from a suspended state, or a user confirms a // price increase. Developers should expect the purchase // token to be returned with this response code and use // the purchase token with the Google Play Developer API. } } });
Abbrüche und ausstehende Status verarbeiten
In diesem Abschnitt wird erläutert, wie du mit gekündigten oder widerrufenen Abos umgehst und wie du Abos verwaltest, die während des Kaufvorgangs in den Status „Ausstehend“ wechseln.
Abbrechen oder widerrufen
Mit der Google Play Developer API kannst du ein Abo kündigen oder widerrufen. Diese Funktion ist auch in der Google Play Console verfügbar.
Kündigen: Nutzer können ein Abo bei Google Play kündigen. Du kannst Nutzern auch die Möglichkeit geben, das Abo in deiner App oder auf deiner Website zu kündigen. Ihre App sollte diese Kündigungen wie unter Kündigungen beschrieben verarbeiten.
Widerrufen: Wenn Sie das Abo widerrufen, verliert der Nutzer sofort den Zugriff darauf. Dies kann beispielsweise verwendet werden, wenn ein technischer Fehler aufgetreten ist, der den Nutzer am Zugriff auf Ihr Produkt gehindert hat, und der Nutzer das Produkt nicht weiter verwenden möchte. Ihre App sollte diese Kündigungen wie unter Widerrufe beschrieben verarbeiten.
In der folgenden Tabelle werden die Unterschiede zwischen „Abbrechen“ und „Widerrufen“ veranschaulicht.
| Verlängerung wird beendet | Zugriff entziehen | |
| Abbrechen | Ja | Nein |
| Widerrufen | Ja | Ja |
Ausstehende Abotransaktionen verarbeiten
Ausstehende Transaktionen können beim Erstkauf, beim Aufladen, beim Upgrade oder beim Downgrade auftreten. Der Abokauf beginnt mit dem Status SUBSCRIPTION_STATE_PENDING, bevor er zu SUBSCRIPTION_STATE_ACTIVE wechselt. Wenn die Transaktion abgelaufen ist oder vom Nutzer abgebrochen wurde, wird sie auf SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED gesetzt. Sie dürfen die Berechtigung des Nutzers erst nach Abschluss der Transaktion aktualisieren.
Die Änderung des Abostatus für den Erstkauf mit ausstehenden Transaktionen ist unkompliziert. Ihre App erhält ein Purchase mit dem Status PENDING, wenn der Nutzer eine ausstehende Transaktion initiiert. Wenn die Transaktion abgeschlossen ist, erhält deine App wieder die Purchase, wobei der Status auf PURCHASED aktualisiert wurde. Eine SubscriptionNotification-Nachricht vom Typ SUBSCRIPTION_PURCHASED wird an deinen RTDN-Client gesendet. Folge dem normalen Prozess, um den Kauf zu bestätigen, dem Nutzer Zugriff auf die Inhalte zu gewähren und den Kauf zu bestätigen. Wenn die Transaktion abläuft oder abgebrochen wird, wird eine SubscriptionNotification-Nachricht mit dem Typ SUBSCRIPTION_PENDING_PURCHASE_CANCELED an deinen RTDN-Client gesendet. In solchen Fällen hätte der Nutzer niemals Zugriff auf die Inhalte erhalten dürfen.
Bei Aufladungen, Upgrades oder Downgrades mit ausstehenden Transaktionen ändert sich der Status sowohl für das alte als auch für das neue Abo. Wenn der Nutzer eine ausstehende Aufladung, ein Upgrade oder ein Downgrade initiiert, erhält deine App eine Purchase für das alte Abo mit einem PendingPurchaseUpdate-Objekt. Zu diesem Zeitpunkt besitzt der Nutzer noch das alte Abo und hat das neue Abo noch nicht erhalten. Wenn du getProducts() und getPurchaseToken() für das Objekt PendingPurchaseUpdate aufrufst, werden die Produkt-IDs und das Kauf-Token des neuen Abos zurückgegeben. Wenn die Transaktion abgeschlossen ist, erhält deine App ein Purchase mit dem Kauf-Token der obersten Ebene für das neue Abo und dem Status PURCHASED. Eine SubscriptionNotification-Nachricht vom Typ SUBSCRIPTION_PURCHASED wird an deinen RTDN-Client gesendet. Erst dann solltest du das alte Kaufftoken durch das neue Kaufftoken ersetzen und den Zugriff des Nutzers auf die Inhalte aktualisieren. Wenn die Transaktion abläuft oder abgebrochen wird, wird eine SubscriptionNotification-Nachricht vom Typ SUBSCRIPTION_PENDING_PURCHASE_CANCELED an deinen RTDN-Client gesendet. In solchen Fällen sollte der Nutzer weiterhin Zugriff auf die Inhalte des alten Abos haben.