KappS Wissensdatenbank · Blog

Google Play Abo-Basispläne und Angebote

Blog Tutorial

Zwei Fragen entscheiden, was ein Google Play-Abonnent tatsächlich zahlt, und sie werden an zwei verschiedenen Stellen beantwortet. Der Basisplan beantwortet „welcher Abrechnungszeitraum, zu welchem Preis, automatisch verlängernd oder Prepaid?“ Das Angebot beantwortet „wer qualifiziert sich für einen günstigeren Einstieg, und für wie lange?“ Modellieren Sie Abo-Angebote falsch, wird aus jeder Marketing-Anfrage nach einer kostenlosen Testphase ein brandneues Abo-Produkt – das fragmentiert Ihren Katalog, verteilt Ihr Reporting über Produkte, die sich nie löschen lassen, sobald jemand sie gekauft hat, und hinterlässt beim Kunden eine Kauf-Logik, die niemand anzufassen wagt.

Dieses Tutorial folgt der Reihenfolge, die Play Console und die Billing Library tatsächlich vorgeben: das Produkt anlegen, Basispläne konfigurieren, Angebote mit Berechtigung hinzufügen, die Angebots-Tokens im Client auslesen, Planwechsel mit dem richtigen Ersetzungsmodus handhaben und dann den Anspruch auf Ihrem Server verifizieren. Drei Dinge bringen Teams dabei immer wieder ins Stolpern – das Angebots-Token, das der Client explizit übergeben muss, der bei einem Upgrade gewählte Prorationsmodus und die Serverprüfung, die entscheidet, ob eine kostenlose Testphase echt ist. Die letzten Abschnitte behandeln die Fallstricke, die erst nach dem Launch auftauchen: regionale Preislücken, Angebote, die nie angezeigt werden können, und eine Preisänderung, die stillschweigend zu einem zweiten Basisplan wird.


1. Das Drei-Ebenen-Modell: Produkt, Basisplan, Angebot

Ein Google Play-Abo besteht aus drei Ebenen, und ihre Laufzeiten sind völlig unterschiedlich. Das entscheidet darüber, ob die heutige Entscheidung in zwei Jahren noch geändert werden kann.

  • Produkt — der Katalogeintrag, identifiziert durch eine Produkt-ID. Die ID kann nach der Erstellung nicht geändert werden, und ein Produkt, das jemand gekauft hat, kann nicht gelöscht werden, sondern nur deaktiviert. Benennen Sie es am ersten Tag nach dem, was es ist, nicht nach der Aktion, die gerade in diesem Quartal läuft: „first_month_half_price" ist eine dauerhafte ID für eine temporäre Idee.
  • Basisplan – die Ebene, die tatsächlich die Ökonomie festlegt: Abrechnungszeitraum (wöchentlich, monatlich, 3 Monate, 6 Monate, jährlich), Verlängerungstyp (automatisch verlängernd oder Prepaid), Preis pro Land sowie Karenzzeit und Verhalten bei Kontosperrung. Ein Produkt kann mehrere Basispläne tragen – genau so verkaufen Sie monatlich und jährlich nebeneinander, ohne ein zweites Produkt.
  • Angebot — eine Preisgestaltung, die an einen Basisplan geknüpft ist: eine kostenlose Testphase, ein Einführungspreis, ein Rückgewinnungsrabatt. Jedes Angebot trägt eine Berechtigungsbedingung, und nur berechtigte Nutzer sehen es überhaupt.

Eine technische Konsequenz sollten Sie sich merken: Der offerToken, den der Client zum Kauf verwendet, ist die Berechtigung für ein bestimmtes Paar aus „Basisplan + Angebot“. Sobald ein Produkt mehr als einen Basisplan oder überhaupt ein Angebot hat, muss der Token explizit übergeben werden – es gibt keinen Standard. Abschnitt 5 ist der Punkt, an dem diese Regel von einer Randnotiz zu einer Erklärung echter Abstürze wird.

2. Schritt 1 — das Abo-Produkt erstellen

Gehen Sie in der Play Console zu Mit Play monetarisieren → Produkte → Abos und erstellen Sie ein Abo. Dieser Schritt bewirkt vier Dinge, und jedes davon ist entweder irreversibel oder später teuer.

  1. Produkt-ID — Kleinbuchstaben, Ziffern und Unterstriche, innerhalb der App eindeutig, unveränderlich und selbst nach dem Löschen nie wiederverwendbar. Eine Umbenennung bedeutet, ein neues Produkt zu erstellen, also eine neue ID und einen neuen Kaufpfad.
  2. Name — damit Sie die Zeile in der Konsole wiedererkennen. Was der Käufer auf dem Kaufblatt sieht, generiert Play aus dem Basisplan und dem Angebot.
  3. Beschreibung und Vorteile – was das Abo umfasst. Dieser Text erscheint in einigen Store-Ansichten, und der Support wird ihn Ihnen gegenüber zitieren.
  4. Speichern — Sie haben einen Entwurf gespeichert. Das Produkt wird erst kaufbar, wenn mindestens ein Basisplan existiert und aktiv ist.

Der häufigste strukturelle Fehler ist, separate Produkte für Monatlich und Jährlich anzulegen. Dann pflegen Sie zwei Kaufabläufe, zwei Zustandssätze, zwei Kündigungspfade – obwohl Play dafür ausgelegt ist, beides als Basispläne unter einem Produkt zu führen. Ein späterer Umzug ist mühsam, machen Sie es also gleich richtig.

3. Schritt 2 — die Basispläne konfigurieren

In den Basisplänen steckt die Ökonomie des Abos. Jedes Produkt braucht mindestens einen; die meisten brauchen zwei (monatlich und jährlich).

Wählen Sie zuerst den Verlängerungstyp. Ein automatisch verlängernder Basisplan berechnet am Ende jeder Periode erneut – das brauchen die meisten Abos für Inhalte und Utility-Apps. Ein Prepaid-Basisplan verkauft eine feste Periode im Voraus und erfordert, dass der Nutzer am Ende erneut auflädt – passend für preissensible Märkte und für Nutzer, die keine wiederkehrende Belastung wünschen. Beides lässt sich nicht mischen: Ein Prepaid-Plan hat keinen Verlängerungszyklus, kein Konzept einer Karenzzeit und kann keine kostenlose Testphase tragen. Wenn Testphasen Teil Ihres Wachstumsplans sind, muss der primäre Plan automatisch verlängern.

Legen Sie dann den Zeitraum und die Preise fest. Der Zeitraum bestimmt den Abrechnungsrhythmus; Preise werden pro Land und Region eingegeben. Dies ist die zuverlässigste Quelle für Support-Tickets: Play lässt Sie nur einige Länder bepreisen, und ein Land ohne Preis ist schlicht nicht kaufbar. Käufer dort sehen „Artikel in Ihrem Land nicht verfügbar“, was für sie wie ein Fehler aussieht und in Ihrer Console nach gar nichts. Füllen Sie vor dem Launch jeden Zielmarkt aus und prüfen Sie, ob der angezeigte Preis die lokalen Regeln zur steuerlichen Vertretung erfüllt.

Zum Schluss die Lebenszyklus-Einstellungen – diese entscheiden, was passiert, wenn eine Zahlung fehlschlägt, nicht wenn sie gelingt:

  • Karenzzeit — ein Zeitfenster nach einer fehlgeschlagenen Abbuchung, in dem der Nutzer seinen Anspruch behält und Zeit hat, die Zahlungsmethode zu korrigieren.
  • Kontosperre — endet die Karenzzeit unbezahlt, wird die Berechtigung ausgesetzt, der Abo-Datensatz bleibt jedoch erhalten, sodass eine spätere Zahlung sie wiederherstellt.
  • Resubscribe — ermöglicht einem Nutzer, der gekündigt hat, mit demselben Plan zurückzukehren, statt den Kaufablauf erneut zu durchlaufen.

Die Standardeinstellungen sind hier nicht automatisch richtig. Utility-Apps wollen in der Regel eine Karenzzeit und ein Kontoinnehaben; Content-Apps bevorzugen möglicherweise ein schnelleres Downgrade. Welche Variante Sie auch wählen: Die serverseitige Zuordnung muss dazu passen, denn die Subscription-State-API unterscheidet Karenzzeit von Kontoinnehaben — beide zu „gültig" zusammenzufassen, verwirft diese Information.

4. Schritt 3 — Angebote und Berechtigungen hinzufügen

Angebote sind der Konversionshebel und die Ebene, die am häufigsten falsch konfiguriert wird. Jedes Angebot trägt drei Dinge: eine Angebots-ID, eine oder mehrere Phasen und eine Berechtigungsbedingung.

Phasen legen fest, wie sich das Angebot zeitlich entfaltet. Eine Phase ist entweder eine kostenlose Testphase (Preis null, eine bestimmte Anzahl Tage) oder ein rabattierter Preis (eine Anzahl Perioden zu einem festgelegten Betrag). Phasen lassen sich kombinieren, zum Beispiel „7 Tage kostenlos, dann 50 % Rabatt auf den ersten Monat“ – die Reihenfolge der Phasen entspricht jedoch der Reihenfolge, in der Nutzer tatsächlich zahlen. Kehren Sie sie um, berechnen Sie zuerst und verschenken erst danach, was sowohl Support-Tickets als auch Rückfragen in der App-Prüfung nach sich zieht.

Eligibility ist der Schalter, der entscheidet, wer das Angebot überhaupt zu sehen bekommt. Play nennt Ihnen drei Bedingungen:

  • Neuer Abonnent — hat dieses Produkt noch nie abonniert. Die übliche Voraussetzung für eine kostenlose Testphase.
  • Upgrade — enthält derzeit ein anderes Abo, das als Upgrade-Ziel infrage kommt.
  • Rückgewinnung — früher abonniert, dann gekündigt oder abgelaufen. Deutlich präziser als ein pauschaler Gutschein, und er verfälscht nicht den Preis, den neue Nutzer sehen.

Angebots-Tags sind kein Beiwerk. Sie werden mit dem Kauf übertragen und sind die einzige saubere Möglichkeit, Testabschlüsse später in Ihrem eigenen Reporting und Ihrer Server-Logik von Vollpreiskäufen zu trennen. Lassen Sie sie weg, können Sie nach drei Monaten nicht mehr beantworten, ob Testphasen überhaupt zu Retention geführt haben.

Ein Angebot wirkt sich nur auf neue Käufe aus. Das Bearbeiten oder Deaktivieren ändert die Abrechnung für Abonnenten, die sich bereits darin befinden, nicht. Um bestehenden Abonnenten umgekehrt einen neuen Preis zu geben, benötigen Sie den Preisänderungsablauf — nicht ein weiteres Angebot.

Zwei Grenzen lohnt es sich festzuhalten. Jeder Basisplan kann nur eine begrenzte Anzahl von Angeboten tragen, daher sollten Aktionen wiederverwendet statt endlos neu erstellt werden. Und wenn ein Basisplan selbst inaktiv ist, ist jedes Angebot darunter unverkäuflich: Wenn ein Angebot „nicht angezeigt wird", prüfen Sie zuerst den Status des Basisplans, dann die Berechtigung und zuletzt den Client-Code.

5. Schritt 4 — das richtige Angebots-Token im Client auslesen

Produktdetails liefern eine list, keinen einzelnen Preis. Eine Abfrage eines Abos ergibt subscriptionOfferDetails, wobei jeder Eintrag eine Kombination aus „Basisplan + Angebot" ist und eine basePlanId, eine offerId (die leer sein kann, was den regulären Vollpreispfad des Basisplans bedeutet) sowie ein offerToken enthält.

Kaufen bedeutet, dem Abrechnungsablauf ausdrücklich einen Eintrag aus dieser Liste zu übergeben: Erstellen Sie die ProductDetailsParams für den Kauf und setzen Sie den ausgewählten offerToken darauf. Die Regel ist einfach, und der Preis für ihre Verletzung ist sofort spürbar:

  • Ein Basisplan und keine Angebote — das Token kann entfallen, wobei die explizite Übergabe über Bibliotheksversionen hinweg sicherer ist.
  • Mehrere Basispläne oder ein beliebiges Angebot — fehlt das Token, schlägt der Kauf fehl. Das ist die Ursache hinter dem klassischen „monatlich funktioniert, jährlich wirft einen Fehler“.
  • Der in der UI angezeigte Preis muss aus dem von Ihnen ausgewählten Eintrag stammen, niemals aus dem ersten Element der Liste. $4.99 anzuzeigen und $49.99 zu berechnen, ist der teuerste Fehler in diesem Artikel.

Schreiben Sie die Auswahlregel ausdrücklich hin, statt sich auf die Reihenfolge der Liste zu verlassen: Finden Sie den Basisplan anhand der basePlanId, die Sie erkennen, wählen Sie dann das Angebot mit der höchsten Priorität innerhalb dieses Basisplans, das die zurückgegebene Liste tatsächlich enthält, und greifen Sie auf den Eintrag des Basisplans zum Vollpreis zurück, wenn kein Angebot verfügbar ist. Die Berechtigungsprüfung ist Aufgabe von Play – die Liste, die Sie erhalten, ist bereits „was dieser Nutzer gerade kaufen kann", also implementieren Sie die Berechtigungsregeln nicht lokal neu und raten Sie nicht.

Verwenden Sie beim Testen ein Lizenz-Testkonto und beachten Sie, dass die Berechtigung auch für Tester gilt: Ein Konto, das bereits abonniert hat, sieht kein Angebot für Neuabonnenten. Das ist erwartetes Verhalten, kein fehlerhafter Code. Um zu prüfen, ob eine Testphase korrekt dargestellt wird, ist ein frisches Konto der schnellste Weg.

6. Schritt 5 — Upgrades, Downgrades und Ersetzungsmodi

Einen Nutzer von Monatlich auf Jährlich oder von einer Basisstufe auf eine Premium-Stufe zu bewegen, ist eine Ersetzung, kein zweiter Kauf. Wie sich diese Ersetzung verhält, entscheidet der Ersetzungsmodus, und eine falsche Wahl bedeutet entweder eine Doppelbelastung des Nutzers oder einen vollen Zeitraum lang entgangenen Umsatz.

  • Mit zeitlicher Proration – wirkt sofort und rechnet den Restwert des alten Abos gegen das neue auf, sodass der Nutzer die Differenz jetzt zahlt.
  • Anteiligen Preis berechnen — wirkt sofort und berechnet den anteiligen Betrag direkt; wird häufig bei Downgrades eingesetzt, damit der Nutzer nicht erst verbraucht und später abrechnet.
  • Vollen Preis berechnen — tritt sofort zum vollen Preis des neuen Tarifs in Kraft, ohne Gutschrift für den Restbetrag; sinnvoll nur, wenn der Betrag, um den es geht, kleiner ist als die Kosten der anteiligen Abrechnung.
  • Ohne Proration — tritt sofort in Kraft, das neue Abo wird ab dem nächsten Zyklus berechnet, und der Rest des alten Zeitraums läuft einfach aus. Am nutzerfreundlichsten, am wenigsten profitabel für Sie und ein vernünftiger Standard für Downgrades.

In der Billing Library 8 ist der Einstiegspunkt als setSubscriptionReplacementMode vereinheitlicht; die älteren Methodennamen aus früheren Library-Versionen sind veraltet. Wenn Ihr Code sie noch aufruft, ist der Kompilierfehler ein Geschenk — günstiger, als mitten im Rollout festzustellen, dass die Semantik abweicht.

Prepaid-Basispläne nehmen nicht am Wechsel teil: Sie haben keinen Verlängerungszyklus und laufen nach ihrem eigenen Zeitplan ab. Jede Aufforderung „monatlich auf jährlich umstellen“ muss Prepaid-Nutzer ausschließen, sonst zeigen Sie ihnen einen Button, der nie abgeschlossen werden kann.

Eine Bestellregel: Eine Ersatzanforderung schlägt entweder fehl oder tritt in Kraft, nie teilweise. Gewähren Sie die lokale Berechtigung daher nicht auf dem Client, bevor Sie sie senden – warten Sie, bis der Server die neue Kaufberechtigung hält, und schalten Sie dann frei.

7. Schritt 6 — auf Ihrem Server verifizieren und bestätigen

Was der Client zurückgibt, ist nur „der Nutzer sagt, er hat es gekauft“. Über die Berechtigung entscheidet der Server: Rufen Sie die Abo-Abfrage (purchases.subscriptionsv2) mit dem Purchase-Token auf, übernehmen Sie den verbindlichen Status und das Ablaufdatum und schreiben Sie beides in Ihre eigene Berechtigungstabelle.

Das Statusfeld sagt Ihnen, in welchem Segment sich der Nutzer befindet — aktiv, in der Karenzzeit, gesperrt, pausiert, gekündigt, abgelaufen, ausstehend. Diese bilden direkt auf Berechtigungszweige ab: Karenzzeit behält den Zugriff meist bei, Kontosperre schränkt ihn meist ein, Pause sollte den Dienst stoppen, aber die Daten behalten. Wenn Sie die Zuordnung fest auf „gültig oder ungültig" verdrahten, werfen Sie genau die Unterscheidungen weg, die Play bereitstellt.

Dann zwei Aktionen, die leicht vergessen werden. Bestätigen Sie den Kauf innerhalb von drei Tagen, sonst wird er automatisch erstattet; dies vom Server aus zu tun ist zuverlässiger, als sich auf den Client zu verlassen. Und richten Sie Echtzeit-Entwicklerbenachrichtigungen ein, damit Verlängerungen, Kündigungen, Eintritte in die Karenzzeit, Wiederherstellungen und Preisänderungsbestätigungen bei Ihnen ankommen. Eine Benachrichtigung ist ein Signal zum Nachprüfen, nicht der endgültige Zustand: Rufen Sie das vollständige Abo danach ab, deduplizieren Sie anhand der Nachrichten-ID und verarbeiten Sie idempotent.

Wenn diese drei Ebenen stimmen, schließt sich der Kreis: Der Client initiiert, der Server entscheidet, Benachrichtigungen halten alles aktuell.

8. Die Fallstricke, die erst nach dem Launch auftauchen

Diese treten im Test selten auf und kommen mit echtem Traffic alle auf einmal.

  • Regionale Preislücken – ein neuer Markt wird hinzugefügt und die Preistabelle nicht ausgefüllt, sodass Käufer dort „nicht verfügbar“ sehen. Das Kauffenster einmal mit einem Konto in dieser Region durchzugehen, ist besser, als einer Konsolentabelle zu vertrauen.
  • Preisänderung auf dem falschen Weg — beim Bearbeiten eines bestehenden Basisplans startet der Preisänderungsprozess, in dem bestehende Abonnenten bestätigen müssen, bevor der neue Preis gilt. Wenn das Ziel lautet „alte Nutzer behalten den alten Preis, neue Nutzer zahlen den neuen“, ist die übliche Antwort ein neuer Basisplan und eine Änderung dessen, was Sie verkaufen – nicht eine Bearbeitung. Legen Sie vor der Preisänderung fest, welches Ergebnis Sie wollen.
  • Deaktivierung eines Angebots mit aktiven Abonnenten — die Deaktivierung blockiert nur neue Käufe; bestehende Abonnenten behalten das Angebot bis zum Ende des Zeitraums. Kein Fehler, aber ein Support-Skript, das Sie bereithalten sollten.
  • Jede Aktion in ein neues Produkt verwandeln — am Ende haben Sie nicht löschbare Produkte, fragmentiertes Reporting und Client-Logik, die niemand refaktorieren wird.
  • Vergessene Angebots-Tags — ohne sie können Sie Test-Konversionen nicht von Direktkäufen trennen und somit nicht sagen, welche Aktion tatsächlich zur Bindung beigetragen hat.
  • Für Tester sichtbar, für Nutzer unsichtbar — Die Berechtigung gilt auch für Testkonten. Die Prüfung mit einem sauberen Konto ist der schnellste Debugging-Weg, den Sie haben.

9. Wo KappS hineinpasst

Die Abo-Konfiguration ist eine Produktentscheidung, doch sie baut auf Konten auf, die über Jahre compliant bleiben müssen: Zahlungsprofil, Steuerangaben, Verifizierungsstatus des Entwicklers. Wenn eines davon bricht, bricht die Umsatzkette im denkbar ungünstigsten Moment. KappS bereitet compliant Unterlagen vor, reicht sie ein und hält Konten und Veröffentlichungsstatus gesund, damit diese Voraussetzungen keine Variable mehr sind.

  • Konsistenz von Konto und Zahlungen — Entwickleridentität, Zahlungsprofil und tatsächlicher Zahlungsempfänger stimmen überein, damit die Abrechnung nicht an abweichenden Angaben hängen bleibt.
  • Prüfung von Steuer- und regionaler Konfiguration — W-8BEN/W-9, Quellensteuersätze und Zielmärkte vor dem Launch geprüft, nicht erst, wenn eine Auszahlung zu kurz ausfällt.
  • Ein zweites Paar Augen auf die Konfiguration — Basispläne, Angebotsberechtigung und clientseitige Token-Verarbeitung, insbesondere bei Portfolios mit mehreren Produkten, Regionen und Sprachen.

Wir bieten nichts an, das die Plattformregeln umgeht: Preise und Testphasen müssen echt sein, die Berechtigung muss den Definitionen von Play folgen, und jeder Kauf muss die serverseitige Verifizierung bestehen. Das sind sowohl die Regeln als auch die einzige Variante, die dauerhaft funktioniert.

Quellen (Google-Dokumentation): Play Console-Hilfe – Abos, Basispläne, Angebote und Berechtigungen sowie Prepaid-Pläne erstellen und konfigurieren; Android Developers – Play Billing-Integration, Modi zum Ersetzen von Abos, serverseitige Verifizierung, Echtzeit-Entwicklerbenachrichtigungen.

Sie verwalten Entwicklerkonten im großen Stil? Wir übernehmen die operative Seite.

Klicken Sie, um eine Datei auszuwählen · Rechtsklick → Einfügen oder Ctrl/⌘+V drücken, um einen Screenshot einzufügen

Sie können eine Datei auch auf dieses Feld ziehen.

Wir antworten an die von Ihnen angegebene E-Mail-Adresse. Ihre Daten bleiben bei KappS.

✔ Eingereicht

Wir haben Ihre Nachricht erhalten und antworten innerhalb von 24 Stunden.


← Zurück zum Bearbeiten