Utrzymywanie subskrybentów dzięki ofertom na utrzymanie

Oferty na utrzymanie pomagają zmniejszyć liczbę dobrowolnych rezygnacji, wyświetlając rabat subskrybentom, gdy próbują anulować subskrypcję w Google Play.

Gdy kwalifikujący się subskrybent rozpocznie proces anulowania, Google Play wyświetli mu skonfigurowaną przez Ciebie ofertę utrzymania, np. „Zachowaj subskrypcję i uzyskaj 50% zniżki przez kolejne 2 miesiące”. Jeśli subskrybent zaakceptuje ofertę, jego subskrypcja nie zostanie anulowana. Obniżona cena zacznie obowiązywać od następnej daty rozliczenia.

Na tej stronie wyjaśniamy, jak działają oferty na utrzymanie, jak je skonfigurować, jak obsługiwać wynikające z nich zdarzenia w backendzie i jak je testować.

Zanim zaczniesz

Zanim skonfigurujesz oferty na utrzymanie, wykonaj te czynności:

Ponieważ Google Play wyświetla oferty na utrzymanie poza aplikacją, nie musisz zmieniać aplikacji ani aktualizować integracji z Biblioteką płatności w Google Play, aby z nich korzystać. Cała integracja odbywa się w Konsoli Google Play i w Twoim backendzie.

Jak działają oferty dla obecnych subskrybentów

Oferty na utrzymanie użytkowników są widoczne tylko w zarządzaniu subskrypcjami w Google Play: w aplikacji Sklep Google Play i w Google Play w internecie. Nie pojawiają się w aplikacji. Biblioteka płatności w Google Play nie zwraca ofert na utrzymanie w wynikach queryProductDetailsAsync(), więc nie są one uwzględniane w ProductDetails.getSubscriptionOfferDetails() i nie można ich sprzedawać przez launchBillingFlow(). Jeśli Twoja aplikacja używa precyzyjnych linków do kierowania subskrybentów do centrum subskrypcji Google Play lub do konkretnej subskrypcji, aby mogli nią zarządzać lub ją anulować, subskrybenci mogą zobaczyć Twoją ofertę utrzymania, gdy zaczną anulować subskrypcję.

Poniżej opisujemy, co się dzieje, gdy subskrybent próbuje anulować subskrypcję:

  1. Subskrybent otwiera swoją subskrypcję w Google Play i rozpoczyna proces jej anulowania.
  2. Google Play sprawdza, czy subskrybent kwalifikuje się do skorzystania z jednej z Twoich ofert utrzymania na podstawie reguł kwalifikacji, które zostały przez Ciebie ustawione dla tej oferty, lub na podstawie tego, czy oferta została skierowana do tego subskrybenta.

  3. Jeśli subskrybent spełnia wymagania, Google Play może wyświetlić ofertę utrzymania jako alternatywę dla anulowania. Spełnienie kryteriów kwalifikacji nie gwarantuje, że oferta się pojawi, ponieważ Google Play przeprowadza też dodatkowe kontrole na poziomie platformy, np. pod kątem zgodności z wymaganiami regionalnymi. Jeśli Google Play wyświetli ofertę, subskrybent może wykonać jedną z tych czynności:

    • Zaakceptowanie oferty: subskrybent akceptuje ofertę jednym kliknięciem. Subskrypcja pozostanie aktywna i będzie automatycznie odnawiana. Subskrybent nie zostanie obciążony od razu. Obniżona cena będzie obowiązywać od następnego okresu rozliczeniowego.
    • Kontynuuj anulowanie: subskrybent odrzuca ofertę i kończy standardowy proces anulowania. Otrzymasz zwykłe powiadomienie SUBSCRIPTION_CANCELED. Więcej informacji znajdziesz w artykule Anulowanie.

Jeśli subskrybent opuści proces anulowania bez zaakceptowania oferty lub anulowania, jego subskrypcja nie ulegnie zmianie. Dotyczy to zarówno aplikacji Sklep Google Play, jak i Google Play w przeglądarce. Wyświetlenie oferty utrzymania bez jej zaakceptowania nie wlicza się do limitu wykorzystania oferty ani nie rozpoczyna okresu oczekiwania między ofertami. Google Play sprawdza limit wykorzystania, gdy wyświetla ofertę, i ponownie, gdy subskrybent ją akceptuje. Zaakceptowana oferta jest wliczana do limitu wykorzystania, gdy subskrypcja zostanie odnowiona po obniżonej cenie. Okres oczekiwania między ofertami rozpoczyna się po zakończeniu okresu rabatu poprzedniej oferty na utrzymanie w ramach tego samego abonamentu podstawowego. Subskrybent może zobaczyć ofertę ponownie, gdy spróbuje anulować subskrypcję, o ile nadal będzie się do niej kwalifikować.

Zaplanowane przejście na inny abonament

Gdy subskrybent zaakceptuje ofertę na utrzymanie, Google Play modeluje ją jako zaplanowane przejście na inny abonament w ramach dotychczasowego zakupu subskrybenta. Różni się to od odroczonego zastąpienia, które wymaga nowego procesu zakupu i tworzy nowy token zakupu. W przypadku oferty utrzymania subskrybent zachowuje ten sam purchaseToken, a zmieniają się tylko przyszłe warunki płatności.

Gdy subskrybent zaakceptuje ofertę, Google Play:

  • Wysyła do Twojego backendu powiadomienie RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21).
  • Dodaje obiekt planTransitionDetails do pola autoRenewingPlan elementu zamówienia, którego dotyczy problem, w zasobie SubscriptionPurchaseV2.

Szczegółowe informacje o obsłudze tych zdarzeń znajdziesz w artykule Obsługa zdarzeń ofert na utrzymanie w backendzie.

Wymagania

Subskrypcja może zostać objęta ofertą utrzymania w dowolnym momencie przed kolejnym odnowieniem, o ile spełnione są wszystkie te warunki:

  • Subskrypcja jest aktywna i automatycznie odnawiana. Subskrypcje w okresie prolongaty, zawieszeniu konta lub wstrzymane nie mogą otrzymywać ofert utrzymania.
  • Subskrypcja jest subskrypcją pojedynczą. Oferty na utrzymanie nie są obsługiwane w przypadku subskrypcji z dodatkami.
  • Subskrypcja nie korzysta z abonamentu podstawowego liczby instalacji. Abonamenty podstawowe na raty nie kwalifikują się do ofert utrzymania klientów.
  • Kolejna płatność będzie naliczana według standardowej ceny cyklicznej abonamentu podstawowego. Jeśli subskrybent korzysta z bezpłatnego okresu próbnego lub ceny dla nowych użytkowników, oferta jest dostępna tylko w ostatnim okresie rozliczeniowym tej fazy, gdy nadchodzące odnowienie jest w cenie standardowej.
  • Subskrybent nie jest w okresie rozliczeniowym ze zniżką w ramach wcześniej zaakceptowanej oferty utrzymania. Subskrybent, który korzysta z rabatu w ramach oferty na utrzymanie, nie może skorzystać z kolejnej oferty na utrzymanie, dopóki subskrypcja nie zostanie odnowiona w standardowej cenie abonamentu podstawowego.
  • Subskrypcja nie ma oczekującej zaplanowanej zmiany abonamentu. Subskrypcja może mieć maksymalnie 1 oczekujące zaplanowane przejście na inny abonament, które jest obiektem planTransitionDetails w stanie IN_PROGRESS. Na przykład subskrybent, który zaakceptował już ofertę utrzymania, która jeszcze nie weszła w życie, nie może otrzymać kolejnej.
  • Subskrypcja nie ma niepotwierdzonej zmiany ceny.
  • Cena promocyjna oferty na utrzymanie jest niższa lub równa cenie kolejnego odnowienia abonamentu podstawowego subskrybenta.
  • Subskrybent spełnia reguły kwalifikacji skonfigurowane dla oferty. W przypadku oferty na utrzymanie użytkowników aktywujesz kierowanie na subskrypcję za pomocą metody activateOfferTargeting.

Konfigurowanie ofert na utrzymanie subskrypcji

Oferty na utrzymanie możesz tworzyć w Konsoli Google Play lub za pomocą interfejsu Google Play Developer API. Każda oferta utrzymania korzysta z jednego z tych trybów kierowania:

  • Kierowanie na podstawie reguł: Google Play decyduje, którzy subskrybenci kwalifikują się do oferty, na podstawie ustawionych przez Ciebie reguł kwalifikacji, takich jak minimalny czas trwania płatnej subskrypcji.
  • Kierowanie na użytkownika: Twój backend decyduje, którzy subskrybenci mogą zobaczyć ofertę, kierując ją na konkretne subskrypcje.

Abonament podstawowy może mieć więcej niż 1 aktywną ofertę na utrzymanie w tym samym kraju lub regionie. Jeśli subskrybent kwalifikuje się do skorzystania z więcej niż 1 oferty, Google Play wyświetla w procesie anulowania maksymalnie 1 ofertę utrzymania. Google Play wybiera ofertę w tej kolejności:

  1. Tryb kierowania: oferta kierowana na użytkownika (retentionPerUserRule) zawsze ma pierwszeństwo przed ofertą opartą na regułach (retentionRule), nawet jeśli oferta oparta na regułach ma wyższy procent rabatu.
  2. Wartość procentowa rabatu: spośród kwalifikujących się ofert, które korzystają z tego samego trybu kierowania, Google Play wyświetla ofertę z najwyższą wartością procentową rabatu.
  3. Cena po rabacie: jeśli oferty mają ten sam procent rabatu, Google Play wyświetla ofertę z najniższą ceną po rabacie.
  4. Identyfikator oferty: jeśli oferty nadal są powiązane, Google Play wyświetla ofertę, której offerId jest ostatni w porządku alfabetycznym.

Tworzenie oferty na utrzymanie w Konsoli Play

Aby utworzyć ofertę na utrzymanie w Konsoli Google Play:

  1. Kliknij Zarabianie w Google Play > Produkty > Subskrypcje.
  2. Wybierz subskrypcję, a następnie abonament podstawowy, do którego chcesz dodać ofertę.
  3. Dodaj ofertę dla obecnych subskrybentów próbujących anulować subskrypcję.
  4. Wybierz Oferta utrzymania klientów na poziomie kohorty lub Oferta utrzymania klientów na poziomie użytkownika.

Tworzenie oferty na utrzymanie za pomocą interfejsu Play Developer API

Możesz też tworzyć i aktualizować oferty na utrzymanie klientów automatycznie. Aby utworzyć ofertę, wywołaj metodę monetization.subscriptions.basePlans.offers.create. Aby zaktualizować istniejące oferty, wywołaj metodę monetization.subscriptions.basePlans.offers.patch lub monetization.subscriptions.basePlans.offers.batchUpdate. Wszystkie 3 metody obsługują pola retentionRule, retentionPerUserRule, startTime i endTime. W obiekcie SubscriptionOffer ustaw te pola:

  • offerId: unikalny identyfikator oferty utrzymania.
  • targeting: ustaw retentionRule na obiekt RetentionTargetingRule, który określa, kto kwalifikuje się do skorzystania z oferty. Dostępne pola znajdziesz w artykule Ustawianie reguł kwalifikowania do przechowywania. Aby zamiast tego wybrać kwalifikujących się subskrybentów z backendu, ustaw retentionPerUserRule. Więcej informacji znajdziesz w artykule Kierowanie ofert utrzymania do konkretnych subskrybentów.
  • phases[]: oferta na utrzymanie obsługuje tylko 1 etap cenowy. W tej fazie ustaw te pola:
    • recurrenceCount: liczba okresów rozliczeniowych, przez które obowiązuje rabat (od 1 do 52). Jeśli wartość recurrenceCount jest większa niż 1, faza duration musi być równa okresowi rozliczeniowemu abonamentu podstawowego.
    • regionalConfigs[]: ustaw relativeDiscount na rabat jako ułamek większy niż 0 i mniejszy niż 1. Na przykład użyj 0.5, aby uzyskać 50% zniżki. Oferty na utrzymanie obsługują tylko relativeDiscount. Etapy ze stałą ceną (price), rabatem bezwarunkowym (absoluteDiscount) i bezpłatne (free) nie są obsługiwane.
  • startTime: opcjonalny. Czas, kiedy oferta na utrzymanie subskrypcji staje się dostępna dla kwalifikujących się subskrybentów, jako sygnatura czasowa RFC 3339. Ustawienie tego pola nie aktywuje oferty. Jeśli nie ustawisz tego pola, oferta będzie dostępna na podstawie jej stanu.
  • endTime: opcjonalny. Czas, kiedy oferta utrzymania przestaje być dostępna, jako sygnatura czasowa RFC 3339, niezależnie od stanu oferty. Jeśli nie ustawisz tego pola, oferta nie będzie miała daty zakończenia. Jeśli ustawisz to pole, musi ono zawierać datę w przyszłości i późniejszą niż startTime.

Metoda monetization.subscriptions.basePlans.offers.create zawsze tworzy ofertę w stanie DRAFT, nawet jeśli ustawisz startTime. Aby aktywować ofertę, wywołaj metodę monetization.subscriptions.basePlans.offers.activate.

Ustawianie reguł kwalifikacji do przechowywania

Obiekt RetentionTargetingRule zawiera te pola:

  • scope: wymagane. Subskrypcje, które uwzględnia reguła. W przypadku ofert na utrzymanie jedyną obsługiwaną wartością jest thisSubscription, czyli subskrypcja, w której zdefiniowano ofertę. Ustaw w tym polu wartość {"thisSubscription": {}}.
  • minDuration: wymagane. Minimalny czas, przez jaki użytkownik musi być użytkownikiem płatnej subskrypcji, aby się kwalifikować, podany w dniach w formacie ISO 8601, od P0D do P1826D. Na przykład użyj P90D, aby ustawić 90 dni. Aby nie wymagać minimalnego okresu płatnej subskrypcji, ustaw w tym polu wartość P0D.
  • allowMultipleClaims: opcjonalny. Czy subskrybent może skorzystać z oferty więcej niż raz. Jeśli false, subskrybent, który kiedykolwiek skorzystał z tej oferty, nie będzie mógł już nigdy więcej z niej skorzystać. Jeśli true, subskrybent może ponownie kwalifikować się do oferty po upływie czasu określonego w polu minOfferCooldownDuration od zakończenia okresu rabatu poprzedniej oferty na utrzymanie. Domyślna wartość to false.
  • minOfferCooldownDuration: wymagany, jeśli allowMultipleClaims to true. Minimalny czas, który musi upłynąć od zakończenia okresu rabatu poprzedniej oferty na utrzymanie, zanim subskrybent będzie mógł ponownie skorzystać z oferty. Jest on podawany w dniach w formacie ISO 8601 i wynosi od P1D do P1826D. Na przykład wpisz P180D, aby ustawić 180 dni. Nie ustawiaj tego pola, jeśli allowMultipleClaims ma wartość false lub nie jest ustawione.

W przykładzie poniżej pokazano pola startTime, endTime i targeting obiektu SubscriptionOffer w przypadku oferty na utrzymanie dostępnej dla subskrybentów, którzy płacą za subskrypcję od co najmniej 90 dni. Mogą oni ponownie skorzystać z tej oferty po upływie 180 dni od zakończenia poprzedniego rabatu na utrzymanie:

{
  "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"
    }
  }
}

Kierowanie ofert utrzymania do konkretnych subskrybentów

Zamiast pozwalać Google Play na decydowanie o kwalifikowaniu się za pomocą RetentionTargetingRule, możesz udostępnić ofertę utrzymania tylko subskrybentom wybranym przez Twój backend. Możesz na przykład skierować ofertę do subskrybentów, których Twój model prognozowania rezygnacji oznaczy jako zagrożonych, lub do subskrybentów, którzy rozpoczynają proces anulowania subskrypcji w Twojej aplikacji.

Subskrybenci widzą ofertę na utrzymanie użytkownika w tym samym procesie anulowania w Google Play co każdą inną ofertę na utrzymanie, a Ty obsługujesz akceptację w ten sam sposób. Więcej informacji znajdziesz w sekcji Obsługa zdarzeń związanych z ofertami na utrzymanie użytkowników w backendzie.

Aby kierować oferty utrzymania do konkretnych subskrybentów:

  1. Utwórz ofertę na utrzymanie użytkowników. Gdy wywołujesz metodę monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch lub monetization.subscriptions.basePlans.offers.batchUpdate, ustaw targeting na obiekt retentionPerUserRule zamiast obiektu retentionRule. Obiekt RetentionPerUserTargetingRule nie ma pól. Oferta może używać atrybutu retentionRule lub retentionPerUserRule, ale nie obu.

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

    Aktywuj ofertę, zanim skierujesz ją do subskrybentów. Jeśli wywołasz metodę activateOfferTargeting w przypadku oferty, która nigdy nie została aktywowana, wywołanie zakończy się niepowodzeniem z kodem stanu HTTP 400 Bad Request i stanem błędu INVALID_ARGUMENT. Więcej informacji znajdziesz w artykule Postępowanie w przypadku błędów kierowania. Nawet gdy oferta jest aktywna, Google Play wyświetla ją tylko subskrybentom, których subskrypcje wybierzesz w następnym kroku.

  2. Kierowanie oferty na subskrypcję Wywołaj metodę purchases.subscriptionsv2.activateOfferTargeting, podając nazwę pakietu aplikacji, purchaseToken subskrypcji i offerId oferty utrzymania użytkownika:

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

    Pomyślne wywołanie zwraca kod stanu HTTP 204 No Content bez treści odpowiedzi. Sklep Google Play przechowuje kierowanie razem z subskrypcją, więc nie musisz wywoływać interfejsu API w momencie, gdy subskrybent anuluje subskrypcję. Gdy subskrybent następnym razem rozpocznie proces anulowania w Google Play, Google Play może wyświetlić ofertę, o ile subskrypcja spełnia wymagania. Kierowanie na użytkownika zastępuje tylko reguły kwalifikacji zdefiniowane przez retentionRule. Wszystkie inne wymagania i kontrole na poziomie platformy, które przeprowadza Google Play, takie jak wymagania dotyczące zgodności regionalnej, nadal obowiązują.

    Możesz kierować więcej niż 1 ofertę utrzymania użytkowników na tę samą subskrypcję. Aby to zrobić, wywołaj metodę activateOfferTargeting raz dla każdej oferty. Google Play nadal wyświetla maksymalnie 1 ofertę utrzymania w procesie anulowania. Szczegółowe informacje o tym, jak Google Play wybiera ofertę, znajdziesz w artykule Konfigurowanie ofert na utrzymanie.

    Metoda activateOfferTargeting jest idempotentna. Jeśli wywołasz ją w przypadku oferty, która jest już kierowana na subskrypcję, wywołanie się powiedzie, a Google Play zaktualizuje wartość activateTime oferty do czasu ostatniego żądania.

  3. W razie potrzeby usuń kierowanie. Jeśli nie chcesz już, aby subskrybent otrzymywał ofertę, na przykład dlatego, że zmieniło się ryzyko jego rezygnacji, wywołaj metodę purchases.subscriptionsv2.deactivateOfferTargeting z tą samą nazwą pakietu, purchaseToken i offerId. Pomyślne wywołanie zwraca kod stanu HTTP 204 No Content bez treści odpowiedzi.

    Metoda deactivateOfferTargeting jest też idempotentna. Jeśli oferta nie jest kierowana na subskrypcję, na przykład dlatego, że kierowanie nigdy nie zostało aktywowane, wywołanie zakończy się powodzeniem i nie będzie miało żadnego efektu.

Kierowanie dotyczy pojedynczego elementu purchaseToken i nie wygasa, dopóki subskrypcja jest aktywna i automatycznie odnawiana. Pozostaje na miejscu po tym, jak subskrybent zobaczy, zaakceptuje lub odrzuci ofertę. Google Play usunie go tylko wtedy, gdy wywołasz metodę deactivateOfferTargeting, lub po upływie 60 dni od wygaśnięcia subskrypcji. Jeśli zmiana abonamentu lub ponowna subskrypcja spowoduje utworzenie nowego purchaseToken, kierowanie nie zostanie przeniesione.

Aby sprawdzić, które oferty utrzymania użytkowników są kierowane na subskrypcję, wywołaj metodę purchases.subscriptionsv2.get. W polu developerTargetedOffers każdego elementu zamówienia znajdują się oferty, na które jest kierowany. Każdy wpis zawiera offerId i activateTime, kiedy aktywowano kierowanie:

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

Obsługa błędów kierowania

Jeśli wywołanie metody activateOfferTargeting lub deactivateOfferTargeting się nie powiedzie, odpowiedź będzie zawierać kod stanu HTTP i stan błędu, który opisuje przyczynę. W tabeli poniżej znajdziesz kody stanu HTTP i stany błędów, które mogą zwracać te metody:

Kod stanu HTTP Stan błędu Metody Przyczyna
404 Not Found NOT_FOUND Oba purchaseToken nie istnieje.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting Oferta offerId nie istnieje w obecnym abonamencie podstawowym subskrypcji lub jest nadal w wersji roboczej i nigdy nie została aktywowana.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Atrybut targeting oferty nie jest ustawiony na retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting Subskrypcja już wygasła.

Metoda activateOfferTargeting nie sprawdza, czy nieaktualna subskrypcja kwalifikuje się do oferty. Jeśli na przykład subskrypcja została anulowana, ale jeszcze nie wygasła, wywołanie się powiedzie, a Sklep Google Play zapisze kierowanie. Google Play ocenia, czy subskrypcja kwalifikuje się do oferty, gdy subskrybent rozpoczyna proces anulowania.

Obsługa zdarzeń związanych z ofertami na utrzymanie użytkowników w backendzie

Gdy subskrybent zaakceptuje ofertę na utrzymanie, a później, gdy nastąpi odnowienie ze zniżką, Google Play wyśle RTDN do Twojego backendu. Po otrzymaniu każdego powiadomienia wywołaj metodę purchases.subscriptionsv2.get z parametrem purchaseToken z powiadomienia, aby uzyskać najnowszy stan subskrypcji.

Zaakceptowanie oferty utrzymania nie powoduje utworzenia nowego zakupu. purchaseToken pozostaje bez zmian, więc nie musisz ponownie potwierdzać zakupu, a Google Play nie generuje linkedPurchaseToken. Zachowaj dotychczasowe uprawnienia subskrybenta. Przetwórz zamówienie odnowienia ze zniżką w taki sam sposób jak każde inne odnowienie subskrypcji.

Typ powiadomienia Czas wysyłania danych Co zrobić
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Gdy subskrybent zaakceptuje ofertę utrzymania w procesie anulowania. Wywołaj metodę purchases.subscriptionsv2.get i sprawdź planTransitionDetails. Nowa wartość „transitionState” to IN_PROGRESS. Subskrypcja pozostaje aktywna i automatycznie się odnawia, więc nadal przyznawaj dostęp.
SUBSCRIPTION_RENEWED (2) gdy bieżący okres rozliczeniowy się zakończy, a subskrypcja zostanie odnowiona po obniżonej cenie z oferty dla obecnych klientów; Wywołaj metodę purchases.subscriptionsv2.get, potwierdź, że offerDetails.offerId to identyfikator oferty utrzymania, a planTransitionDetails już nie występuje, i wydłuż dostęp subskrybenta do nowego expiryTime.

Obiekt planTransitionDetails zawiera te pola:

  • productId: identyfikator produktu subskrypcji, na którą przechodzi subskrypcja. W przypadku oferty utrzymania jest to ten sam produkt.
  • basePlanId: identyfikator abonamentu podstawowego, na który przechodzi subskrypcja.
  • offerId: identyfikator oferty utrzymania zaakceptowanej przez subskrybenta. Użyj tego pola, aby określić, która oferta utrzymania została wykorzystana.
  • transitionInfo.transitionState: stan przejścia. W przypadku ofert utrzymania stan to IN_PROGRESS, gdy przejście jest oczekujące.
  • transitionInfo.expectedTransitionTime: kiedy warunki oferty utrzymania mają zacząć obowiązywać.

Google Play obejmuje planTransitionDetails tylko wtedy, gdy trwa przejście. Gdy subskrypcja zostanie odnowiona po obniżonej cenie z oferty na utrzymanie, przejście zostanie zakończone, a Google Play usunie planTransitionDetails z odpowiedzi purchases.subscriptionsv2.get. Od tego momentu element zamówienia będzie wyświetlać aktywny rabat na utrzymanie:

  • offerDetails.offerId to identyfikator zaakceptowanej oferty utrzymania.
  • W okresach rozliczeniowych objętych rabatem cena offerPhase wynosi {"introductoryPrice": {}}. Po zakończeniu okresów rozliczeniowych z rabatem i odnowieniu subskrypcji w standardowej cenie abonamentu podstawowego wartość offerPhase zmieni się na {"basePrice": {}}.

Odpowiedź po zaakceptowaniu oferty przez subskrybenta

Gdy subskrybent zaakceptuje ofertę utrzymania, bieżący okres rozliczeniowy będzie kontynuowany bez zmian. Obiekt planTransitionDetails pokazuje zaplanowane przejście z właściwością transitionState o wartości 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"
          }
        }
      }
    }
  ]
}

Odpowiedź po odnowieniu ze zniżką

Po upływie daty odnowienia i obciążeniu subskrybenta obniżoną ceną offerDetails.offerId pokazuje ofertę na utrzymanie subskrypcji, offerPhase pokazuje introductoryPrice, a odpowiedź nie zawiera już 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
        }
      }
    }
  ]
}

Interakcje w cyklu życia

Podczas obsługi ofert utrzymania pamiętaj o tych kwestiach:

  • Zakończenie rabatu: po zakończeniu okresów rozliczeniowych z rabatem subskrypcja automatycznie odnawia się w standardowej cenie abonamentu podstawowego. Otrzymasz powiadomienie SUBSCRIPTION_RENEWED, tak jak w przypadku każdego innego odnowienia, a offerPhase elementu zamówienia zmieni się na {"basePrice": {}}. Subskrybent nie musi podejmować żadnych działań.
  • Odzyskiwanie płatności po zakończeniu okresu rabatu: jeśli odnowienie po zakończeniu okresu rabatu w standardowej cenie abonamentu podstawowego zostanie odrzucone, a subskrypcja wejdzie w okres prolongaty lub zostanie zawieszona, w ramach odzyskiwania płatności zostanie naliczona standardowa cena abonamentu podstawowego. Google Play nie stosuje rabatu z oferty na utrzymanie, która została już wykorzystana. Jeśli płatność za pierwsze odnowienie ze zniżką zostanie odrzucona, oczekujące przejście zostanie zachowane, a cena z oferty na utrzymanie zostanie zastosowana po przywróceniu płatności.
  • Płatność odroczona: jeśli wywołasz metodę purchases.subscriptionsv2.defer, gdy przejście na ofertę na utrzymanie ma stan IN_PROGRESS, oczekujące przejście zostanie zachowane i zastosowane przy odroczonym odnowieniu. Aby sprawdzić nową datę odnowienia, zobacz expiryTime elementu zamówienia.
  • Zmiana abonamentu przed przejściem: oferta utrzymania dotyczy tylko purchaseToken subskrypcji, w której subskrybent ją zaakceptował. Jeśli subskrybent przejdzie na inny abonament podstawowy lub inną subskrypcję przed expectedTransitionTime, Google Play wygeneruje nowy token zakupu, anuluje zaplanowane przejście i wyczyści planTransitionDetails. Oczekująca oferta utrzymania nie dotyczy nowego abonamentu.
  • Anulowanie i przywracanie: jeśli subskrybent anuluje subskrypcję po zaakceptowaniu oferty utrzymania, zaplanowane przejście pozostanie oczekujące, a  transitionState pozostanie IN_PROGRESS. Jeśli subskrybent przywróci subskrypcję przed jej wygaśnięciem, rabat z oferty utrzymania nadal będzie obowiązywać przy odnowieniu.
  • Wygaśnięcie i ponowna subskrypcja: jeśli subskrypcja wygaśnie i nie zostanie przywrócona, Google Play anuluje oczekujące przejście. Jeśli użytkownik później ponownie zasubskrybuje lub zarejestruje się, Google Play utworzy nowy zakup subskrypcji, a zaakceptowana wcześniej oferta utrzymania nie będzie obowiązywać.
  • Zmiany oferty: jeśli zmienisz rabat lub okresy rozliczeniowe oferty na utrzymanie, zmiana będzie dotyczyć tylko przyszłych wykorzystań. Subskrybenci, którzy już zaakceptowali ofertę, zachowają pierwotne warunki.
  • Dezaktywacja oferty: jeśli dezaktywujesz ofertę na utrzymanie subskrypcji lub upłynie jej data zakończenia, subskrybenci, którzy już ją zaakceptowali, zachowają warunki, na które się zgodzili. Subskrybenci, którzy przeszli na IN_PROGRESS, nadal otrzymają rabat przy następnym odnowieniu, a subskrybenci, którzy są już w okresach rozliczeniowych z rabatem, zachowają rabat przez cały uzgodniony okres.
  • Zmiany cen: zmiany cen abonamentu podstawowego nadal obowiązują. Google Play przenosi subskrybenta na nową cenę tylko wtedy, gdy płaci on cenę standardową i nie ma oczekującej oferty utrzymania klienta. Więcej informacji znajdziesz w artykule Zmiana cen subskrypcji.
  • Zwroty środków: możesz zwrócić środki subskrybentowi za pomocą standardowych interfejsów API do zwrotów i unieważniania, takich jak metoda purchases.subscriptionsv2.revoke. Spowoduje to zwrot środków za ostatnią płatność i zakończenie dostępu subskrybenta.

Testowanie ofert na utrzymanie klientów

Google Play wyświetla tylko aktywne oferty utrzymania w procesie anulowania i ocenia reguły kwalifikacji w czasie rzeczywistym. Aby przetestować oferty na utrzymanie użytkowników za pomocą konta testera licencji, użyj jednej z tych metod:

Zanim użyjesz którejkolwiek z tych metod, otwórz Ustawienia > Testowanie licencji w Konsoli Google Play i dodaj testowe konto Google jako testera licencji.

Testowanie oferty utrzymania użytkowników na poziomie użytkownika

Google Play wyświetla ofertę utrzymania użytkowników tylko w przypadku subskrypcji, na które kierujesz reklamy, dzięki czemu możesz przetestować ją w abonamencie podstawowym w wersji produkcyjnej bez udostępniania jej rzeczywistym subskrybentom. Aby przetestować ofertę na utrzymanie użytkownika, wykonaj te czynności:

  1. Utwórz ofertę utrzymania użytkowników w ramach abonamentu podstawowego, a następnie ją aktywuj. W Konsoli Google Play wybierz Oferta na poziomie użytkownika dotycząca utrzymania. W interfejsie Google Play Developer API ustaw targeting na obiekt retentionPerUserRule. Więcej informacji znajdziesz w artykule Kierowanie ofert na utrzymanie do określonych subskrybentów.
  2. Jeśli oferta została właśnie aktywowana, poczekaj 10–15 minut, aż zmiana zostanie zastosowana, a następnie wyczyść pamięć podręczną aplikacji Sklep Google Play.
  3. Na urządzeniu testowym zaloguj się na konto testera licencji, a następnie kup abonament podstawowy w aplikacji.
  4. Z poziomu backendu wywołaj metodę purchases.subscriptionsv2.activateOfferTargeting, podając nazwę pakietu aplikacji, purchaseToken testera licencji i offerId oferty na utrzymanie.
  5. W aplikacji Sklep Google Play kliknij Płatności i subskrypcje > Subskrypcje, wybierz subskrypcję i kliknij Anuluj subskrypcję. Oferta utrzymania pojawia się w procesie anulowania.
  6. Zaakceptuj ofertę, a następnie sprawdź, czy Twój backend otrzymuje powiadomienie RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED i obsługuje odnowienie z rabatem.

Testowanie oferty utrzymania klientów opartej na regułach

Po aktywowaniu oferty utrzymania opartej na regułach Google Play może ją wyświetlać każdemu kwalifikującemu się subskrybentowi abonamentu podstawowego. Aby uniknąć udostępniania oferty użytkownikom wersji produkcyjnej, przetestuj ją w nieprodukcyjnej aplikacji testowej lub w ramach specjalnego abonamentu podstawowego, do którego użytkownicy wersji produkcyjnej nie mają dostępu. Aby przetestować ofertę utrzymania opartą na regułach, wykonaj te czynności:

  1. W aplikacji testowej lub w testowym abonamencie podstawowym utwórz opartą na regułach ofertę utrzymania i ustaw parametr minDuration na P0D (0 dni). W Konsoli Google Play wybierz Oferta na utrzymanie na poziomie kohorty. W interfejsie Google Play Developer API ustaw targeting na obiekt retentionRule. Szczegółowe informacje znajdziesz w artykule Ustawianie reguł kwalifikowania do przechowywania.
  2. Aktywuj ofertę, poczekaj 10–15 minut, aż zmiana zostanie zastosowana, a następnie wyczyść pamięć podręczną aplikacji Sklep Google Play.
  3. Na urządzeniu testowym zaloguj się na konto testera licencji, a następnie kup testowy abonament podstawowy.
  4. W aplikacji Sklep Google Play kliknij Płatności i subskrypcje > Subskrypcje, wybierz subskrypcję i kliknij Anuluj subskrypcję. Ponieważ oferta nie wymaga minimalnego okresu płatnej subskrypcji, możesz rozpocząć proces anulowania zaraz po zakupie. Oferta utrzymania pojawia się w procesie anulowania.
  5. Zaakceptuj ofertę, a następnie sprawdź, czy Twój backend otrzymuje powiadomienie RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED i obsługuje odnowienie z rabatem.

Po zweryfikowaniu integracji utwórz i aktywuj ofertę utrzymania opartą na regułach w produkcyjnym abonamencie podstawowym.

Rozwiązywanie problemów z testowaniem ofert na utrzymanie klientów

Jeśli oferta utrzymania się nie wyświetla, sprawdź te kwestie:

  • Oferta utrzymania jest aktywna, a bieżący czas mieści się między jej datami startTime i endTime, jeśli zostały ustawione.
  • W przypadku oferty utrzymania użytkowników na poziomie użytkownika pole developerTargetedOffers w odpowiedzi purchases.subscriptionsv2.get dla testera licencji purchaseToken zawiera ofertę.
  • Subskrypcja jest pojedyncza, a nie z dodatkami.
  • Subskrypcja nie jest w okresie prolongaty, nie jest objęta zawieszeniem konta ani wstrzymana.
  • Subskrypcja nie ma oczekującej zmiany abonamentu ani ceny.
  • Następne odnowienie nastąpi po standardowej cenie abonamentu podstawowego. W przypadku bezpłatnych okresów próbnych i ofert dla nowych użytkowników oferta na utrzymanie jest dostępna tylko podczas ostatniego okresu rozliczeniowego okresu próbnego lub etapu dla nowych użytkowników.
  • odczekano 10–15 minut po aktywowaniu lub zmianie oferty, wyczyszczono pamięć podręczną aplikacji Sklep Play.