Abonnenten mit Angeboten zur Kundenbindung halten

Mit Angeboten zur Kundenbindung kannst du die freiwillige Abwanderung reduzieren, indem du Abonnenten einen Rabatt anbietest, wenn sie versuchen, ihr Abo bei Google Play zu kündigen.

Wenn ein berechtigter Abonnent mit der Kündigung beginnt, wird ihm in Google Play ein von dir konfiguriertes Angebot angezeigt, z. B. „Behalte dein Abo und erhalte 50 % Rabatt für die nächsten 2 Monate“. Wenn der Abonnent das Angebot annimmt, wird sein Abo nicht gekündigt. Der ermäßigte Preis gilt ab dem nächsten Abrechnungsdatum.

Auf dieser Seite wird erläutert, wie Angebote zur Kundenbindung funktionieren, wie sie konfiguriert werden, wie die resultierenden Ereignisse im Backend verarbeitet werden und wie sie getestet werden.

Hinweis

Bevor Sie Angebote zur Kundenbindung einrichten, müssen Sie Folgendes tun:

Da Google Play Angebote zur Kundenbindung außerhalb deiner App anzeigt, musst du deine App nicht ändern oder deine Google Play Billing Library-Integration aktualisieren, um sie zu verwenden. Die gesamte Integration erfolgt in der Google Play Console und in deinem Backend.

Funktionsweise von Angeboten zur Kundenbindung

Angebote zur Kundenbindung werden nur in der Google Play-Aboverwaltung angezeigt: in der Google Play Store App und in Google Play im Web. Sie werden nicht in deiner App angezeigt. Die Google Play Billing Library gibt keine Angebote zur Kundenbindung in queryProductDetailsAsync()-Ergebnissen zurück. Sie sind also nicht in ProductDetails.getSubscriptionOfferDetails() enthalten und du kannst sie nicht über launchBillingFlow() verkaufen. Wenn deine App Deeplinks verwendet, um Abonnenten zum Google Play-Abocenter oder zu einem bestimmten Abo weiterzuleiten, damit sie es verwalten oder kündigen können, sehen diese Abonnenten dein Angebot zur Kundenbindung, wenn sie dort mit der Kündigung beginnen.

In den folgenden Schritten wird beschrieben, was passiert, wenn ein Abonnent versucht, ein Abo zu kündigen:

  1. Der Abonnent öffnet sein Abo in Google Play und beginnt mit der Kündigung.
  2. Google Play prüft, ob der Abonnent die Voraussetzungen für eines deiner Angebote zur Kundenbindung erfüllt, die du für das Angebot festgelegt hast, oder ob du das Angebot auf diesen Abonnenten ausgerichtet hast.

  3. Wenn der Abonnent die Voraussetzungen erfüllt, kann Google Play das Angebot zur Kundenbindung als Alternative zur Kündigung anzeigen. Auch wenn Ihre Teilnahmevoraussetzungen erfüllt sind, ist nicht garantiert, dass das Angebot angezeigt wird, da Google Play zusätzliche Prüfungen auf Plattformebene durchführt, z. B. ob regionale Compliance-Anforderungen erfüllt sind. Wenn Google Play das Angebot anzeigt, hat der Abonnent folgende Möglichkeiten:

    • Angebot annehmen: Der Abonnent nimmt das Angebot mit einem einzigen Tippen an. Das Abo bleibt aktiv und wird automatisch verlängert. Dem Abonnenten wird der Betrag nicht sofort in Rechnung gestellt. Der ermäßigte Preis gilt ab dem nächsten Abrechnungszeitraum.
    • Kündigung fortsetzen: Der Abonnent lehnt das Angebot ab und schließt den Standardkündigungsvorgang ab. Sie erhalten die übliche SUBSCRIPTION_CANCELED-Benachrichtigung. Weitere Informationen finden Sie unter Stornierungen.

Wenn der Abonnent den Kündigungsvorgang verlässt, ohne das Angebot anzunehmen oder zu kündigen, ändert sich sein Abo nicht. Dies gilt sowohl für die Google Play Store App als auch für Google Play im Web. Wenn du dir ein Angebot zur Kundenbindung ansiehst, ohne es anzunehmen, wird es nicht auf das Einlöselimit des Angebots angerechnet und die Wartezeit zwischen Angeboten beginnt nicht. Google Play prüft das Einlöselimit, wenn das Angebot angezeigt wird, und noch einmal, wenn der Abonnent es annimmt. Ein angenommenes Angebot wird auf das Einlöselimit angerechnet, wenn das Abo zum ermäßigten Preis verlängert wird. Die Wartezeit zwischen Angeboten beginnt, wenn der Rabattzeitraum des vorherigen Kundenbindungsangebots für dasselbe Basis-Abo endet. Der Abonnent sieht das Angebot möglicherweise wieder, wenn er das nächste Mal versucht, das Abo zu kündigen, sofern er noch berechtigt ist.

Geplanter Tarifwechsel

Wenn ein Abonnent ein Angebot zur Kundenbindung annimmt, wird dies von Google Play als geplanter Tarifwechsel für den bestehenden Kauf des Abonnenten modelliert. Dies unterscheidet sich von einem aufgeschobenen Ersatz, der einen neuen Kaufvorgang erfordert und ein neues Kaufftoken erstellt. Bei einem Kundenbindungsangebot behält der Abonnent dieselbe purchaseToken bei und nur die zukünftigen Abrechnungsbedingungen ändern sich.

Wenn der Abonnent das Angebot annimmt, führt Google Play die folgenden Schritte aus:

  • Sendet eine RTDN vom Typ SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) an Ihr Backend.
  • Fügt dem Feld autoRenewingPlan der betroffenen Werbebuchung in der Ressource SubscriptionPurchaseV2 ein planTransitionDetails-Objekt hinzu.

Weitere Informationen zum Umgang mit diesen Ereignissen finden Sie unter Ereignisse im Zusammenhang mit Angeboten zur Kundenbindung im Backend verarbeiten.

Teilnahmevoraussetzungen

Ein Abo kann jederzeit vor der nächsten Verlängerung ein Angebot zur Kundenbindung erhalten, sofern alle der folgenden Bedingungen erfüllt sind:

  • Das Abo ist aktiv und wird automatisch verlängert. Abos, die sich im Kulanzzeitraum befinden, sich in der Kontosperre befinden oder pausiert sind, können keine Angebote zur Kundenbindung erhalten.
  • Das Abo ist ein Einzelabo. Angebote zur Kundenbindung werden für Abos mit Add-ons nicht unterstützt.
  • Für das Abo wird kein Basis-Abo mit Ratenzahlung verwendet. Für Basis-Abos mit Ratenzahlung können keine Angebote zur Kundenbindung erstellt werden.
  • Die nächste Zahlung erfolgt zum regulären Preis des Basis-Abos mit wiederkehrender Zahlung. Wenn sich der Abonnent in einem kostenlosen Testzeitraum oder einer Einführungsphase befindet, ist das Angebot nur während des letzten Abrechnungszeitraums dieser Phase verfügbar, wenn die anstehende Verlängerung zum regulären Preis erfolgt.
  • Der Abonnent befindet sich nicht in einem Abrechnungszeitraum mit Rabatt eines zuvor akzeptierten Angebots zur Kundenbindung. Ein Abonnent, der sich in der Rabattphase eines Kundenbindungsangebots befindet, kann erst dann ein weiteres Kundenbindungsangebot in Anspruch nehmen, wenn das Abo zum regulären Preis des Basis-Abos verlängert wird.
  • Für das Abo ist keine geplante Tarifumstellung ausstehend. Ein Abo kann maximal eine ausstehende geplante Tarifumstellung haben. Das ist ein planTransitionDetails-Objekt im Status IN_PROGRESS. Beispiel: Ein Abonnent, der bereits ein Angebot zur Kundenbindung angenommen hat, das noch nicht in Kraft getreten ist, kann kein weiteres Angebot erhalten.
  • Für das Abo gibt es keine unbestätigte Preisänderung.
  • Der ermäßigte Preis des Kundenbindungsangebots ist kleiner oder gleich dem nächsten Verlängerungspreis des Basis-Abos des Abonnenten.
  • Der Abonnent erfüllt die von Ihnen für das Angebot konfigurierten Teilnahmevoraussetzungen. Bei einem Angebot zur Nutzerbindung haben Sie das Targeting für das Abo mit der Methode activateOfferTargeting aktiviert.

Angebote zur Kundenbindung konfigurieren

Du kannst Angebote zur Kundenbindung in der Google Play Console oder mithilfe der Google Play Developer API erstellen. Für jedes Kundenbindungsangebot wird einer der folgenden Targeting-Modi verwendet:

  • Regelbasiertes Targeting: Google Play entscheidet anhand der von Ihnen festgelegten Berechtigungsregeln, welche Abonnenten berechtigt sind, z. B. anhand einer Mindestdauer des kostenpflichtigen Abos.
  • Nutzerbezogenes Targeting: Dein Backend entscheidet, welche Abonnenten das Angebot sehen können, indem es auf bestimmte Abos ausgerichtet wird.

Ein Basis-Abo kann mehrere aktive Angebote zur Kundenbindung im selben Land oder in derselben Region haben. Wenn ein Abonnent Anspruch auf mehr als ein Angebot hat, zeigt Google Play im Kündigungsvorgang höchstens ein Angebot zur Kundenbindung an. Google Play wählt das Angebot in der folgenden Reihenfolge aus:

  1. Targeting-Modus: Ein auf einzelne Nutzer ausgerichtetes Angebot (retentionPerUserRule) hat immer Vorrang vor einem regelbasierten Angebot (retentionRule), auch wenn das regelbasierte Angebot einen höheren Rabattprozentsatz hat.
  2. Rabattprozentsatz: Bei berechtigten Angeboten mit demselben Targeting-Modus zeigt Google Play das Angebot mit dem höchsten angezeigten Rabattprozentsatz an.
  3. Rabattpreis: Wenn Angebote denselben Rabattprozentsatz haben, zeigt Google Play das Angebot mit dem niedrigsten Rabattpreis an.
  4. Angebots-ID: Wenn Angebote immer noch gleichrangig sind, zeigt Google Play das Angebot an, dessen offerId in alphabetischer Reihenfolge zuletzt kommt.

In der Play Console ein Angebot zur Kundenbindung erstellen

So erstellen Sie ein Angebot zur Kundenbindung in der Google Play Console:

  1. Gehen Sie zu Mit Google Play monetarisieren > Produkte > Abos.
  2. Wählen Sie ein Abo und dann das Basis-Abo aus, dem Sie das Angebot hinzufügen möchten.
  3. Fügen Sie ein Angebot für Bestehende Abonnenten, die kündigen möchten hinzu.
  4. Wählen Sie entweder Kundenbindungsangebot auf Kohortenebene oder Kundenbindungsangebot auf Nutzerebene aus.

Mit der Play Developer API ein Angebot zur Kundenbindung erstellen

Sie können Angebote zur Kundenbindung auch programmatisch erstellen und aktualisieren. Rufen Sie zum Erstellen eines Angebots die Methode monetization.subscriptions.basePlans.offers.create auf. Rufen Sie die Methode monetization.subscriptions.basePlans.offers.patch oder monetization.subscriptions.basePlans.offers.batchUpdate auf, um vorhandene Angebote zu aktualisieren. Alle drei Methoden unterstützen die Felder retentionRule, retentionPerUserRule, startTime und endTime. Legen Sie im Objekt SubscriptionOffer die folgenden Felder fest:

  • offerId: Ihre eindeutige ID für das Angebot zur Kundenbindung.
  • targeting: Setzen Sie retentionRule auf ein RetentionTargetingRule-Objekt, das definiert, wer das Angebot nutzen kann. Informationen zu den verfügbaren Feldern finden Sie unter Regeln für die Aufbewahrungsberechtigung festlegen. Wenn Sie stattdessen berechtigte Abonnenten aus Ihrem Backend auswählen möchten, legen Sie retentionPerUserRule fest. Weitere Informationen finden Sie unter Angebote zur Kundenbindung auf bestimmte Abonnenten ausrichten.
  • phases[]: Ein Angebot zur Kundenbindung unterstützt nur eine einzige Preisphase. Legen Sie in dieser Phase die folgenden Felder fest:
    • recurrenceCount: Die Anzahl der Abrechnungszeiträume, für die der Rabatt gilt, von 1 bis 52. Wenn recurrenceCount größer als 1 ist, muss die Phase duration dem Abrechnungszeitraum des Basis-Abos entsprechen.
    • regionalConfigs[]: Legen Sie relativeDiscount auf den Rabatt als Bruchzahl größer als 0 und kleiner als 1 fest. Verwenden Sie beispielsweise 0.5 für 50 % Rabatt. Angebote zur Kundenbindung unterstützen nur relativeDiscount. Phasen mit Festpreis (price), Gesamtrabatt (absoluteDiscount) und kostenloser Nutzung (free) werden nicht unterstützt.
  • startTime: Optional. Der Zeitpunkt, zu dem das Angebot zur Kundenbindung für berechtigte Abonnenten verfügbar wird, als RFC 3339-Zeitstempel. Durch Festlegen dieses Felds wird das Angebot nicht aktiviert. Wenn Sie dieses Feld nicht festlegen, wird das Angebot basierend auf seinem Status verfügbar.
  • endTime: Optional. Der Zeitpunkt, an dem das Angebot zur Kundenbindung nicht mehr verfügbar ist, als RFC 3339-Zeitstempel, unabhängig vom Status des Angebots. Wenn Sie dieses Feld nicht festlegen, hat das Angebot kein Enddatum. Wenn Sie dieses Feld festlegen, muss es in der Zukunft und nach startTime liegen.

Mit der Methode monetization.subscriptions.basePlans.offers.create wird das Angebot immer im Status DRAFT erstellt, auch wenn Sie startTime festlegen. Rufen Sie die Methode monetization.subscriptions.basePlans.offers.activate auf, um das Angebot zu aktivieren.

Regeln für die Aufbewahrung festlegen

Das Objekt RetentionTargetingRule enthält die folgenden Felder:

  • scope: erforderlich. Die Abos, die von der Regel berücksichtigt werden. Bei Angeboten zur Kundenbindung wird nur der unterstützte Wert thisSubscription unterstützt, also das Abo, für das das Angebot definiert ist. Legen Sie für dieses Feld {"thisSubscription": {}} fest.
  • minDuration: erforderlich. Die Mindestzeit, die ein Nutzer ein zahlender Abonnent gewesen sein muss, um berechtigt zu sein, als ISO 8601-Dauer in Tagen, von P0D bis P1826D. Verwenden Sie beispielsweise P90D für 90 Tage. Wenn keine Mindestlaufzeit für das kostenpflichtige Abo erforderlich sein soll, legen Sie dieses Feld auf P0D fest.
  • allowMultipleClaims: Optional. Ob ein Abonnent das Angebot mehr als einmal in Anspruch nehmen kann. Wenn false, kann ein Abonnent, der dieses Angebot schon einmal in Anspruch genommen hat, es nicht noch einmal nutzen. Wenn true, kann ein Abonnent wieder berechtigt sein, nachdem die Zeit in minOfferCooldownDuration seit dem Ende des Rabattzeitraums des vorherigen Kundenbindungsangebots vergangen ist. Die Standardeinstellung ist false.
  • minOfferCooldownDuration: Erforderlich, wenn allowMultipleClaims true ist. Die Mindestzeit, die nach dem Ende des Rabattzeitraums des vorherigen Angebots zur Kundenbindung vergehen muss, bevor der Abonnent wieder berechtigt ist, als ISO 8601-Dauer in Tagen, von P1D bis P1826D. Verwenden Sie beispielsweise P180D für 180 Tage. Legen Sie dieses Feld nicht fest, wenn allowMultipleClaims false ist oder nicht festgelegt wurde.

Das folgende Beispiel zeigt die Felder startTime, endTime und targeting eines SubscriptionOffer-Objekts für ein Angebot zur Kundenbindung, das Abonnenten zur Verfügung steht, die mindestens 90 Tage lang bezahlt haben. Sie können es 180 Tage nach Ablauf des vorherigen Rabatts zur Kundenbindung noch einmal in Anspruch nehmen:

{
  "offerId": "retention-50off-2m",
  "startTime": "2026-12-01T00:00:00Z",
  "endTime": "2027-03-01T00:00:00Z",
  "targeting": {
    "retentionRule": {
      "scope": {
        "thisSubscription": {}
      },
      "minDuration": "P90D",
      "allowMultipleClaims": true,
      "minOfferCooldownDuration": "P180D"
    }
  }
}

Angebote zur Kundenbindung auf bestimmte Abonnenten ausrichten

Anstatt Google Play die Berechtigung mit einem RetentionTargetingRule entscheiden zu lassen, kannst du ein Angebot zur Kundenbindung nur den Abonnenten zur Verfügung stellen, die dein Backend auswählt. Du kannst beispielsweise ein Angebot an Abonnenten richten, die dein Modell zur Vorhersage der Abwanderung als gefährdet einstuft, oder an Abonnenten, die in deiner App mit der Kündigung beginnen.

Abonnenten sehen ein Angebot zur Nutzerbindung pro Nutzer im selben Google Play-Kündigungsvorgang wie jedes andere Angebot zur Nutzerbindung. Die Annahme wird auf dieselbe Weise verarbeitet. Weitere Informationen finden Sie unter Ereignisse für Kundenbindungsangebote im Backend verarbeiten.

So richten Sie Angebote zur Kundenbindung auf bestimmte Abonnenten aus:

  1. Erstellen Sie ein Angebot zur Nutzerbindung pro Nutzer. Wenn Sie die Methode monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch oder monetization.subscriptions.basePlans.offers.batchUpdate aufrufen, legen Sie für targeting ein retentionPerUserRule-Objekt anstelle eines retentionRule-Objekts fest. Das Objekt RetentionPerUserTargetingRule hat keine Felder. Ein Angebot kann entweder retentionRule oder retentionPerUserRule verwenden, aber nicht beides.

    {
      "offerId": "retention-peruser-30off",
      "targeting": {
        "retentionPerUserRule": {}
      }
    }
    

    Aktiviere das Angebot, bevor du es auf Abonnenten ausrichtest. Wenn Sie die Methode activateOfferTargeting für ein Angebot aufrufen, das noch nie aktiviert wurde, schlägt der Aufruf mit dem HTTP-Statuscode 400 Bad Request und dem Fehlerstatus INVALID_ARGUMENT fehl. Weitere Informationen finden Sie unter Targeting-Fehler beheben. Auch wenn das Angebot aktiv ist, wird es bei Google Play nur Abonnenten angezeigt, deren Abos Sie im nächsten Schritt als Ziel festlegen.

  2. Richten Sie das Angebot auf ein Abo aus. Rufen Sie die Methode purchases.subscriptionsv2.activateOfferTargeting mit dem Paketnamen Ihrer App, der purchaseToken des Abos und der offerId des Angebots zur Nutzerbindung auf:

    POST https://androidpublisher.googleapis.com/androidpublisher/v3/applications/{packageName}/purchases/subscriptionsv2/tokens/{purchaseToken}:activateOfferTargeting
    
    {
      "offerId": "retention-peruser-30off"
    }
    

    Bei einem erfolgreichen Aufruf wird der HTTP-Statuscode 204 No Content ohne Antworttext zurückgegeben. Google Play speichert das Targeting mit dem Abo, sodass du die API nicht aufrufen musst, wenn der Abonnent kündigt. Wenn der Abonnent das nächste Mal versucht, das Abo bei Google Play zu kündigen, kann Google Play das Angebot anzeigen, sofern das Abo die Teilnahmevoraussetzungen erfüllt. Das Targeting pro Nutzer ersetzt nur die Berechtigungsregeln, die von einem retentionRule definiert werden. Alle anderen Teilnahmevoraussetzungen und die von Google Play durchgeführten Prüfungen auf Plattformebene, z. B. regionale Compliance-Anforderungen, gelten weiterhin.

    Du kannst mehrere Angebote zur Nutzerbindung auf dasselbe Abo ausrichten. Rufen Sie dazu die Methode activateOfferTargeting einmal für jedes Angebot auf. Google Play zeigt im Kündigungsvorgang weiterhin höchstens ein Angebot zur Kundenbindung an. Weitere Informationen dazu, wie Google Play das Angebot auswählt, findest du unter Angebote zur Kundenbindung konfigurieren.

    Die Methode activateOfferTargeting ist idempotent. Wenn du sie für ein Angebot aufrufst, das bereits auf das Abo ausgerichtet ist, ist der Aufruf erfolgreich und Google Play aktualisiert die activateTime des Angebots auf den Zeitpunkt der letzten Anfrage.

  3. Targeting bei Bedarf entfernen Wenn ein Abonnent das Angebot nicht mehr erhalten soll, z. B. weil sich sein Abwanderungsrisiko geändert hat, rufen Sie die Methode purchases.subscriptionsv2.deactivateOfferTargeting mit demselben Paketnamen, purchaseToken und offerId auf. Bei einem erfolgreichen Aufruf wird der HTTP-Statuscode 204 No Content ohne Antworttext zurückgegeben.

    Die Methode deactivateOfferTargeting ist ebenfalls idempotent. Wenn das Angebot nicht auf das Abo ausgerichtet ist, z. B. weil Sie das Targeting nie aktiviert haben, ist der Aufruf erfolgreich und hat keine Auswirkungen.

Das Targeting gilt für eine einzelne purchaseToken und läuft nicht ab, solange das Abo aktiv ist und automatisch verlängert wird. Sie bleibt bestehen, nachdem der Abonnent das Angebot gesehen, angenommen oder abgelehnt hat. Google Play entfernt sie nur, wenn Sie die Methode deactivateOfferTargeting aufrufen oder 60 Tage nach Ablauf des Abos. Wenn durch eine Aboänderung oder ein erneutes Abonnieren ein neues purchaseToken erstellt wird, wird das Targeting nicht übernommen.

Wenn du prüfen möchtest, welche nutzerspezifischen Angebote zur Nutzerbindung auf ein Abo ausgerichtet sind, rufe die Methode purchases.subscriptionsv2.get auf. Im Feld developerTargetedOffers jeder Werbebuchung sind die Angebote aufgeführt, auf die das Targeting erfolgt. Jeder Eintrag enthält die offerId und die activateTime, als Sie das Targeting aktiviert haben:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "developerTargetedOffers": [
        {
          "offerId": "retention-peruser-30off",
          "activateTime": "2026-12-03T15:04:05Z"
        }
      ]
    }
  ]
}

Targeting-Fehler beheben

Wenn ein Aufruf der Methode activateOfferTargeting oder deactivateOfferTargeting fehlschlägt, enthält die Antwort einen HTTP-Statuscode und einen Fehlerstatus, der die Ursache beschreibt. In der folgenden Tabelle sind die HTTP-Statuscodes und Fehlerstatus aufgeführt, die diese Methoden zurückgeben können:

HTTP-Statuscode Fehlerstatus Methoden Ursache
404 Not Found NOT_FOUND Beides purchaseToken ist nicht vorhanden.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting Das offerId ist im aktuellen Basis-Abo des Abos nicht vorhanden oder das Angebot befindet sich noch im Entwurfsstatus und wurde noch nie aktiviert.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Der targeting des Angebots ist nicht auf retentionPerUserRule festgelegt.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Das Abo ist bereits abgelaufen.

Mit der Methode activateOfferTargeting wird nicht geprüft, ob ein nicht abgelaufenes Abo für das Angebot infrage kommt. Wenn das Abo beispielsweise gekündigt wurde, aber noch nicht abgelaufen ist, ist der Aufruf erfolgreich und Google Play speichert das Targeting. Google Play prüft die Berechtigung des Abos, wenn der Abonnent den Kündigungsvorgang startet.

Ereignisse im Zusammenhang mit Angeboten zur Kundenbindung im Backend verarbeiten

Wenn ein Abonnent ein Angebot zur Kundenbindung annimmt und später die vergünstigte Verlängerung erfolgt, sendet Google Play RTDNs an dein Backend. Rufe nach Erhalt jeder Benachrichtigung die Methode purchases.subscriptionsv2.get mit dem purchaseToken aus der Benachrichtigung auf, um den aktuellen Abostatus abzurufen.

Wenn Sie ein Angebot zur Kundenbindung annehmen, wird kein neuer Kauf erstellt. Die purchaseToken bleibt gleich, sodass du den Kauf nicht noch einmal bestätigen musst und Google Play keine linkedPurchaseToken generiert. Die bestehende Berechtigung des Abonnenten beibehalten. Verarbeite die Bestellung für die Verlängerung mit Rabatt wie jede andere Aboverlängerung.

Benachrichtigungstyp Wann werden die Daten gesendet? Was muss ich tun?
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Wenn ein Abonnent ein Angebot zur Kundenbindung im Kündigungsablauf annimmt. Rufen Sie die Methode purchases.subscriptionsv2.get auf und prüfen Sie planTransitionDetails. transitionState ist IN_PROGRESS. Das Abo bleibt aktiv und wird automatisch verlängert. Gewähre also weiterhin Zugriff.
SUBSCRIPTION_RENEWED (2) Wenn der aktuelle Abrechnungszeitraum endet und das Abo zum ermäßigten Preis des Kundenbindungsangebots verlängert wird. Rufe die Methode purchases.subscriptionsv2.get auf, bestätige, dass offerDetails.offerId die Angebots-ID zur Kundenbindung ist und dass planTransitionDetails nicht mehr vorhanden ist, und verlängere den Zugriff des Abonnenten auf das neue expiryTime.

Das Objekt planTransitionDetails enthält die folgenden Felder:

  • productId: Die Produkt-ID des Tarifs, zu dem das Abo wechselt. Bei einem Angebot zur Kundenbindung ist dies dasselbe Produkt.
  • basePlanId: Die Basis-Abo-ID des Abos, zu dem das Abo wechselt.
  • offerId: Die ID des Kundenbindungsangebots, das der Abonnent angenommen hat. Anhand dieses Felds können Sie feststellen, welches Angebot zur Kundenbindung eingelöst wurde.
  • transitionInfo.transitionState: Der Status der Umstellung. Bei Angeboten zur Kundenbindung ist der Status IN_PROGRESS, während die Umstellung aussteht.
  • transitionInfo.expectedTransitionTime: Wann die Bedingungen des Kundenbindungsangebots voraussichtlich in Kraft treten.

Google Play enthält planTransitionDetails nur, solange die Umstellung aussteht. Wenn das Abo zum ermäßigten Preis des Kundenbindungsangebots verlängert wird, ist die Umstellung abgeschlossen und Google Play entfernt planTransitionDetails aus der purchases.subscriptionsv2.get-Antwort. Ab diesem Zeitpunkt wird der aktive Rabatt für die Kundenbindung in der Werbebuchung selbst angezeigt:

  • offerDetails.offerId ist die ID des angenommenen Angebots zur Kundenbindung.
  • offerPhase ist {"introductoryPrice": {}} während der Abrechnungszeiträume mit Rabatt. Nach Ablauf der Abrechnungszeiträume mit Rabatt und der Verlängerung des Abos zum regulären Preis des Basis-Abos ändert sich offerPhase zu {"basePrice": {}}.

Antwort, nachdem der Abonnent das Angebot angenommen hat

Nachdem der Abonnent das Angebot zur Kundenbindung angenommen hat, wird der aktuelle Abrechnungszeitraum unverändert fortgesetzt. Das planTransitionDetails-Objekt zeigt die geplante Umstellung mit einem transitionState von IN_PROGRESS:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2026-12-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base"
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "planTransitionDetails": {
          "productId": "premium_monthly_sub",
          "basePlanId": "monthly-base",
          "offerId": "retention-50off-2m",
          "transitionInfo": {
            "transitionState": "IN_PROGRESS",
            "expectedTransitionTime": "2026-12-15T10:00:00Z"
          }
        }
      }
    }
  ]
}

Antwort nach der Verlängerung mit Rabatt

Nachdem das Verlängerungsdatum verstrichen ist und dem Abonnenten der ermäßigte Preis in Rechnung gestellt wurde, wird in offerDetails.offerId das Angebot zur Kundenbindung und in offerPhase introductoryPrice angezeigt. Die Antwort enthält nicht mehr planTransitionDetails:

{
  "lineItems": [
    {
      "productId": "premium_monthly_sub",
      "expiryTime": "2027-01-15T10:00:00Z",
      "offerDetails": {
        "basePlanId": "monthly-base",
        "offerId": "retention-50off-2m"
      },
      "offerPhase": {
        "introductoryPrice": {}
      },
      "autoRenewingPlan": {
        "autoRenewEnabled": true,
        "recurringPrice": {
          "currencyCode": "USD",
          "units": "9",
          "nanos": 990000000
        }
      }
    }
  ]
}

Lebenszyklusinteraktionen

Beachten Sie beim Umgang mit Angeboten zur Kundenbindung Folgendes:

  • Ende des Rabatts: Nach Ablauf der Abrechnungszeiträume mit Rabatt wird das Abo automatisch zum regulären Preis des Basis-Abos verlängert. Sie erhalten wie bei jeder anderen Verlängerung eine SUBSCRIPTION_RENEWED-Benachrichtigung und der offerPhase der Werbebuchung ändert sich in {"basePrice": {}}. Der Abonnent muss nichts weiter tun.
  • Zahlungswiederherstellung nach dem Rabatt: Wenn die Verlängerung zum regulären Preis des Basis-Abos nach Ablauf des Rabatts abgelehnt wird und das Abo in einen Kulanzzeitraum oder eine Kontosperre übergeht, wird bei der Zahlungswiederherstellung der reguläre Preis des Basis-Abos berechnet. Google Play wendet den Rabatt des abgeschlossenen Kundenbindungsangebots nicht an. Wenn die Zahlung für die erste ermäßigte Verlängerung abgelehnt wird, bleibt die ausstehende Umstellung erhalten und der Preis des Kundenbindungsangebots gilt, wenn die Zahlung wiederhergestellt wird.
  • Verzögerte Abrechnung: Wenn du die Methode purchases.subscriptionsv2.defer aufrufst, während eine Umstellung auf ein Angebot zur Kundenbindung IN_PROGRESS ist, bleibt die ausstehende Umstellung erhalten und wird bei der verzögerten Verlängerung angewendet. Das neue Verlängerungsdatum finden Sie in der expiryTime der Werbebuchung.
  • Aboänderung vor der Umstellung: Ein Angebot zur Kundenbindung gilt nur für die purchaseToken des Abos, für die der Abonnent es akzeptiert hat. Wenn der Abonnent vor dem expectedTransitionTime zu einem anderen Basis-Abo oder Abo wechselt, generiert Google Play ein neues Kaufftoken, bricht die geplante Umstellung ab und löscht planTransitionDetails. Das ausstehende Angebot zur Kundenbindung gilt nicht für das neue Abo.
  • Kündigung und Wiederherstellung: Wenn ein Abonnent das Abo kündigt, nachdem er ein Angebot zur Kundenbindung angenommen hat, bleibt die geplante Umstellung ausstehend und transitionState bleibt IN_PROGRESS. Wenn der Abonnent das Abo vor Ablauf wiederherstellt, gilt der Rabatt des Kundenbindungsangebots weiterhin bei der Verlängerung.
  • Ablauf und erneutes Abonnieren: Wenn das Abo abläuft, ohne wiederhergestellt zu werden, bricht Google Play die ausstehende Umstellung ab. Wenn der Nutzer das Abo später wieder abschließt oder sich neu registriert, erstellt Google Play einen neuen Abokauf und das zuvor akzeptierte Angebot zur Kundenbindung gilt nicht mehr.
  • Angebotsänderungen: Wenn Sie den Rabatt oder die Abrechnungszeiträume eines Angebots zur Kundenbindung ändern, gilt die Änderung nur für zukünftige Einlösungen. Für Abonnenten, die das Angebot bereits angenommen haben, gelten die ursprünglichen Bedingungen.
  • Angebotsdeaktivierung: Wenn du ein Angebot zur Kundenbindung deaktivierst oder das Angebot sein Enddatum erreicht, behalten Abonnenten, die es bereits angenommen haben, die Bedingungen bei, denen sie zugestimmt haben. Abonnenten mit einer IN_PROGRESS-Umstellung erhalten den Rabatt weiterhin bei der nächsten Verlängerung. Abonnenten, die sich bereits in den Abrechnungszeiträumen mit Rabatt befinden, behalten den Rabatt für die gesamte vereinbarte Dauer.
  • Preisänderungen: Preisänderungen für das Basis-Abo gelten weiterhin. Google Play migriert einen Abonnenten nur dann zu einem neuen Preis, wenn der Abonnent den regulären Preis zahlt und keine ausstehende Umstellung auf ein Angebot zur Kundenbindung hat. Weitere Informationen finden Sie unter Abopreise ändern.
  • Erstattungen: Du kannst einem Abonnenten eine Erstattung über die Standard-APIs für Erstattungen und Widerrufe gewähren, z. B. über die Methode purchases.subscriptionsv2.revoke. Dadurch wird die letzte Zahlung erstattet und der Zugriff des Abonnenten beendet.

Angebote zur Kundenbindung testen

Google Play zeigt im Kündigungsvorgang nur aktive Angebote zur Kundenbindung an und wertet die Berechtigungsregeln in Echtzeit aus. Wenn Sie Angebote zur Kundenbindung mit einem Lizenztesterkonto testen möchten, verwenden Sie eine der folgenden Methoden:

Bevor du eine der beiden Methoden verwendest, gehe in der Google Play Console zu Einstellungen > Lizenztest und füge das Google-Testkonto als Lizenztester hinzu.

Nutzerbindungsangebot pro Nutzer testen

Google Play zeigt ein Angebot zur Nutzerbindung nur für die von dir ausgewählten Abos an. Du kannst es also mit einem Produktions-Basis-Abo testen, ohne dass es echten Abonnenten angezeigt wird. So testen Sie ein Angebot zur Nutzerbindung:

  1. Erstelle ein Angebot zur Nutzerbindung pro Nutzer im Rahmen des Basis-Abos und aktiviere es dann. Wählen Sie in der Google Play Console Angebot zur Nutzerbindung aus. Legen Sie mit der Google Play Developer API targeting auf ein retentionPerUserRule-Objekt fest. Weitere Informationen finden Sie unter Angebote zur Kundenbindung auf bestimmte Abonnenten ausrichten.
  2. Wenn Sie das Angebot gerade erst aktiviert haben, warten Sie 10 bis 15 Minuten, bis die Änderung übernommen wurde, und leeren Sie dann den Cache der Google Play Store App.
  3. Melde dich auf dem Testgerät mit dem Lizenztestkonto an und kaufe dann das Basis-Abo in deiner App.
  4. Rufe von deinem Backend aus die Methode purchases.subscriptionsv2.activateOfferTargeting mit dem Paketnamen deiner App, der purchaseToken des Lizenztesters und der offerId des Kundenbindungsangebots auf.
  5. Gehen Sie in der Google Play Store App zu Zahlungen & Abos > Abos, wählen Sie das Abo aus und tippen Sie auf Abo kündigen. Das Angebot zur Kundenbindung wird im Kündigungsprozess angezeigt.
  6. Nimm das Angebot an und bestätige dann, dass dein Backend die RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED empfängt und die ermäßigte Verlängerung verarbeitet.

Regelbasiertes Kundenbindungsangebot testen

Nachdem du ein regelbasiertes Angebot zur Kundenbindung aktiviert hast, kann Google Play es allen berechtigten Abonnenten des Basis-Abos anzeigen. Damit das Angebot nicht für Produktionsnutzer sichtbar ist, solltest du es in einer Test-App, die nicht für die Produktion bestimmt ist, oder in einem speziellen Test-Basis-Abo testen, auf das Produktionsnutzer keinen Zugriff haben. So testen Sie ein regelbasiertes Angebot zur Kundenbindung:

  1. Erstelle in deiner Test-App oder in deinem Test-Basis-Abo ein regelbasiertes Angebot zur Kundenbindung und setze minDuration auf P0D (0 Tage). Wählen Sie in der Google Play Console Angebot zur Nutzerbindung auf Kohortenebene aus. Setzen Sie mit der Google Play Developer API targeting auf ein retentionRule-Objekt. Weitere Informationen finden Sie unter Regeln für die Berechtigung zur Aufbewahrung festlegen.
  2. Aktivieren Sie das Angebot, warten Sie 10 bis 15 Minuten, bis die Änderung übernommen wurde, und leeren Sie dann den Cache der Google Play Store App.
  3. Melde dich auf dem Testgerät mit dem Lizenztesterkonto an und kaufe dann das Test-Basis-Abo.
  4. Gehen Sie in der Google Play Store App zu Zahlungen & Abos > Abos, wählen Sie das Abo aus und tippen Sie auf Abo kündigen. Da für das Angebot keine Mindestdauer für das kostenpflichtige Abo erforderlich ist, kannst du den Kündigungsvorgang direkt nach dem Kauf starten. Das Angebot zur Kundenbindung wird im Kündigungsvorgang angezeigt.
  5. Nimm das Angebot an und bestätige dann, dass dein Backend die RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED empfängt und die ermäßigte Verlängerung verarbeitet.

Nachdem Sie die Integration überprüft haben, erstellen und aktivieren Sie das regelbasierte Angebot zur Kundenbindung für Ihr Produktions-Basis-Abo.

Fehlerbehebung beim Testen von Kundenbindungsangeboten

Wenn das Angebot zur Kundenbindung nicht angezeigt wird, prüfen Sie Folgendes:

  • Das Aufbewahrungsangebot ist aktiv und die aktuelle Zeit liegt zwischen startTime und endTime, sofern Sie diese festgelegt haben.
  • Bei einem Angebot zur Nutzerbindung pro Nutzer enthält das Feld developerTargetedOffers in der purchases.subscriptionsv2.get-Antwort für die purchaseToken des Lizenztesters das Angebot.
  • Das Abo ist ein einzelnes Abo, kein Abo mit Add-ons.
  • Das Abo befindet sich nicht im Kulanzzeitraum, ist nicht gesperrt und nicht pausiert.
  • Für das Abo steht keine Tarif- oder Preisänderung aus.
  • Die nächste Verlängerung erfolgt zum regulären Preis des Basis-Abos. Bei kostenlosen Testzeiträumen und Einführungsangeboten ist das Kundenbindungsangebot nur während des letzten Abrechnungszeitraums des Testzeitraums oder der Einführungsphase verfügbar.
  • Sie haben nach der Aktivierung oder Änderung des Angebots 10 bis 15 Minuten gewartet und den Cache der Google Play Store App geleert.