Fidelizza gli abbonati con offerte di fidelizzazione

Le offerte di fidelizzazione ti aiutano a ridurre l'abbandono volontario mostrando uno sconto agli abbonati nel momento in cui tentano di annullare l'abbonamento in Google Play.

Quando un abbonato idoneo inizia ad annullare l'abbonamento, Google Play gli mostra un'offerta di fidelizzazione che hai configurato, ad esempio "Mantieni l'abbonamento e ricevi uno sconto del 50% per i prossimi 2 mesi". Se l'abbonato accetta l'offerta, l'abbonamento non viene annullato. Il prezzo scontato viene applicato a partire dalla data di fatturazione successiva.

Questa pagina spiega come funzionano le offerte di fidelizzazione, come configurarle, come gestire gli eventi risultanti nel tuo backend e come testarle.

Prima di iniziare

Prima di configurare le offerte di fidelizzazione, assicurati di aver eseguito le seguenti operazioni:

Poiché Google Play mostra le offerte di fidelizzazione al di fuori della tua app, non è necessario modificare l'app o aggiornare l'integrazione della Libreria Fatturazione Google Play per utilizzarle. Tutto il lavoro di integrazione avviene in Google Play Console e nel tuo backend.

Come funzionano le offerte di fidelizzazione

Le offerte per la fidelizzazione vengono visualizzate solo nella gestione degli abbonamenti di Google Play: l'app Google Play Store e Google Play sul web. Non vengono visualizzate all'interno dell'app. La Libreria Fatturazione Google Play non restituisce offerte di fidelizzazione nei risultati di queryProductDetailsAsync(), pertanto non sono incluse in ProductDetails.getSubscriptionOfferDetails() e non puoi venderle tramite launchBillingFlow(). Se la tua app utilizza deep link per indirizzare gli abbonati al Centro abbonamenti di Google Play o a un abbonamento specifico in modo che possano gestirlo o annullarlo, questi abbonati possono visualizzare la tua offerta di fidelizzazione quando iniziano ad annullare l'abbonamento.

I passaggi seguenti descrivono cosa succede quando un abbonato tenta di annullare l'abbonamento:

  1. L'abbonato apre il suo abbonamento in Google Play e inizia ad annullarlo.
  2. Google Play verifica se l'abbonato è idoneo a una delle tue offerte di fidelizzazione, in base alle regole di idoneità che hai impostato per l'offerta o in base al fatto che tu abbia indirizzato l'offerta a quell'abbonato.

  3. Se l'abbonato è idoneo, Google Play potrebbe mostrare l'offerta di fidelizzazione come alternativa all'annullamento. La soddisfazione dei criteri di idoneità non garantisce la visualizzazione dell'offerta, perché Google Play esegue anche controlli aggiuntivi a livello di piattaforma, ad esempio i requisiti di conformità regionali. Se Google Play mostra l'offerta, l'abbonato può eseguire una delle seguenti operazioni:

    • Accettare l'offerta: l'abbonato accetta con un solo tocco. L'abbonamento rimane attivo e si rinnova automaticamente. All'abbonato non viene addebitato alcun importo immediatamente. Il prezzo scontato viene applicato a partire dal periodo di fatturazione successivo.
    • Continua con l'annullamento: l'abbonato rifiuta l'offerta e completa il flusso di annullamento standard. Ricevi la solita notifica di SUBSCRIPTION_CANCELED. Per maggiori dettagli, consulta Annullamenti.

Se l'abbonato abbandona il flusso di annullamento senza accettare l'offerta o annullare l'abbonamento, quest'ultimo non cambia. Questo vale sia per l'app Google Play Store sia per Google Play sul web. La visualizzazione di un'offerta di fidelizzazione senza accettarla non viene conteggiata ai fini del limite di utilizzo dell'offerta né avvia il periodo di attesa tra le offerte. Google Play controlla il limite di utilizzo quando mostra l'offerta e di nuovo quando l'abbonato la accetta. Un'offerta accettata viene conteggiata ai fini del limite di utilizzo quando l'abbonamento viene rinnovato al prezzo scontato. Il periodo di attesa tra le offerte inizia al termine del periodo di sconto dell'offerta di fidelizzazione precedente sullo stesso piano base. L'abbonato potrebbe visualizzare di nuovo l'offerta la prossima volta che tenta di annullare l'abbonamento, a condizione che sia ancora idoneo.

Transizione del piano pianificata

Quando un abbonato accetta un'offerta di fidelizzazione, Google Play la modella come una transizione del piano programmata sull'acquisto esistente dell'abbonato. Questo differisce da una sostituzione differita, che richiede un nuovo flusso di acquisto e crea un nuovo token di acquisto. Con un'offerta di fidelizzazione, l'abbonato mantiene lo stesso purchaseToken e cambiano solo i termini di fatturazione futuri.

Quando l'abbonato accetta l'offerta, Google Play esegue le seguenti operazioni:

  • Invia una RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) al tuo backend.
  • Aggiunge un oggetto planTransitionDetails al campo autoRenewingPlan dell'elemento pubblicitario interessato nella risorsa SubscriptionPurchaseV2.

Per maggiori dettagli sulla gestione di questi eventi, consulta Gestisci gli eventi delle offerte di fidelizzazione nel tuo backend.

Requisiti di idoneità

Un abbonamento può ricevere un'offerta di fidelizzazione in qualsiasi momento prima del rinnovo successivo, a condizione che siano soddisfatte tutte le seguenti condizioni:

  • L'abbonamento è attivo e si rinnova automaticamente. Gli abbonamenti in un periodo di tolleranza, con sospensione dell'account o in pausa non possono ricevere offerte di fidelizzazione.
  • L'abbonamento è un abbonamento singolo. Le offerte di fidelizzazione non sono supportate per gli abbonamenti con componenti aggiuntivi.
  • L'abbonamento non utilizza un piano base di installazioni attive. I piani base a rate non sono idonei per le offerte di fidelizzazione.
  • Il pagamento successivo sarà al prezzo base ricorrente standard del piano. Se l'abbonato è in una fase di prova senza costi o di prezzo di lancio, l'offerta è disponibile solo durante l'ultimo periodo di fatturazione di quella fase, quando il rinnovo imminente è al prezzo normale.
  • L'abbonato non si trova in un periodo di fatturazione scontato di un'offerta di fidelizzazione accettata in precedenza. Un abbonato che si trova nella fase scontata di un'offerta di fidelizzazione non può richiedere un'altra offerta di fidelizzazione finché l'abbonamento non viene rinnovato al prezzo del piano base standard.
  • L'abbonamento non ha una transizione del piano programmata in attesa. Un abbonamento può avere al massimo una transizione del piano programmata in attesa, ovvero un oggetto planTransitionDetails nello stato IN_PROGRESS. Ad esempio, un abbonato che ha già accettato un'offerta di fidelizzazione non ancora entrata in vigore non può riceverne un'altra.
  • L'abbonamento non ha variazioni di prezzo non confermate.
  • Il prezzo scontato dell'offerta di fidelizzazione è inferiore o uguale al prezzo del rinnovo successivo del piano base dell'abbonato.
  • L'abbonato soddisfa le regole di idoneità che hai configurato per l'offerta. Per un'offerta di fidelizzazione utenti, hai attivato il targeting per l'abbonamento con il metodo activateOfferTargeting.

Configura le offerte di fidelizzazione

Puoi creare offerte di fidelizzazione in Google Play Console o utilizzando l'API Google Play Developer. Ogni offerta di fidelizzazione utilizza una delle seguenti modalità di targeting:

  • Targeting basato su regole: Google Play decide quali abbonati sono idonei in base alle regole di idoneità che hai impostato, ad esempio una durata minima dell'abbonamento a pagamento.
  • Targeting per utente: il tuo backend decide quali abbonati possono visualizzare l'offerta indirizzandola ad abbonamenti specifici.

Un piano base può avere più di un'offerta di fidelizzazione attiva nello stesso paese o nella stessa regione. Quando un abbonato è idoneo a più di un'offerta, Google Play mostra al massimo un'offerta di fidelizzazione nel flusso di annullamento. Google Play sceglie l'offerta nel seguente ordine:

  1. Modalità di targeting: un'offerta con targeting per utente (retentionPerUserRule) ha sempre la precedenza su un'offerta basata su regole (retentionRule), anche se quest'ultima ha una percentuale di sconto più elevata.
  2. Percentuale di sconto: tra le offerte idonee che utilizzano la stessa modalità di targeting, Google Play mostra l'offerta con la percentuale di sconto visualizzata più alta.
  3. Prezzo scontato: se le offerte hanno la stessa percentuale di sconto, Google Play mostra l'offerta con il prezzo scontato più basso.
  4. ID offerta: se le offerte sono ancora in parità, Google Play mostra l'offerta il cui offerId è l'ultimo in ordine alfabetico.

Crea un'offerta di fidelizzazione in Play Console

Per creare un'offerta di fidelizzazione in Google Play Console, segui questi passaggi:

  1. Vai a Monetizza con Google Play > Prodotti > Abbonamenti.
  2. Seleziona un abbonamento, quindi il piano base a cui vuoi aggiungere l'offerta.
  3. Aggiungi un'offerta per gli abbonati esistenti che tentano di annullare l'abbonamento.
  4. Scegli Offerta di fidelizzazione a livello di coorte o Offerta di fidelizzazione a livello di utente.

Crea un'offerta di fidelizzazione con l'API Play Developer

Puoi anche creare e aggiornare le offerte di fidelizzazione in modo programmatico. Per creare un'offerta, chiama il metodo monetization.subscriptions.basePlans.offers.create. Per aggiornare le offerte esistenti, chiama il metodo monetization.subscriptions.basePlans.offers.patch o monetization.subscriptions.basePlans.offers.batchUpdate. Tutti e tre i metodi supportano i campi retentionRule, retentionPerUserRule, startTime e endTime. Nell'oggetto SubscriptionOffer, imposta i seguenti campi:

  • offerId: l'ID offerta di fidelizzazione univoco.
  • targeting: imposta retentionRule su un oggetto RetentionTargetingRule che definisce chi è idoneo per l'offerta. Per i campi disponibili, consulta Imposta le regole di idoneità alla conservazione. Per scegliere gli abbonati idonei dal tuo backend, imposta retentionPerUserRule. Per maggiori dettagli, consulta Scegli come target delle offerte di fidelizzazione abbonati specifici.
  • phases[]: un'offerta di fidelizzazione supporta una sola fase di prezzo. In questa fase, imposta i seguenti campi:
    • recurrenceCount: il numero di periodi di fatturazione per i quali è valido lo sconto, da 1 a 52. Se recurrenceCount è maggiore di 1, la fase duration deve corrispondere al periodo di fatturazione del piano base.
    • regionalConfigs[]: imposta relativeDiscount sullo sconto come frazione maggiore di 0 e minore di 1. Ad esempio, utilizza 0.5 per uno sconto del 50%. Le offerte di fidelizzazione supportano solo relativeDiscount. Le fasi a prezzo fisso (price), sconto assoluto (absoluteDiscount) e senza costi (free) non sono supportate.
  • startTime: (Facoltativo) L'ora in cui l'offerta di fidelizzazione diventa disponibile per gli abbonati idonei, come timestamp RFC 3339. L'impostazione di questo campo non attiva l'offerta. Se non imposti questo campo, l'offerta diventa disponibile in base al suo stato.
  • endTime: (Facoltativo) L'ora in cui l'offerta di fidelizzazione non è più disponibile, come timestamp RFC 3339, indipendentemente dallo stato dell'offerta. Se non imposti questo campo, l'offerta non ha una data di fine. Se imposti questo campo, deve essere nel futuro e successivo a startTime.

Il metodo monetization.subscriptions.basePlans.offers.create crea sempre l'offerta nello stato DRAFT, anche se imposti startTime. Per attivare l'offerta, chiama il metodo monetization.subscriptions.basePlans.offers.activate.

Imposta le regole di idoneità alla conservazione

L'oggetto RetentionTargetingRule contiene i seguenti campi:

  • scope: obbligatorio. Gli abbonamenti presi in considerazione dalla regola. Per le offerte di fidelizzazione, l'unico valore supportato è thisSubscription, ovvero l'abbonamento in cui è definita l'offerta. Imposta questo campo su {"thisSubscription": {}}.
  • minDuration: obbligatorio. Il periodo di tempo minimo durante il quale un utente deve essere stato un abbonato a pagamento per essere idoneo, come durata ISO 8601 in giorni, da P0D a P1826D. Ad esempio, utilizza P90D per 90 giorni. Per non richiedere un periodo minimo di abbonamento a pagamento, imposta questo campo su P0D.
  • allowMultipleClaims: (Facoltativo) Se un abbonato può usufruire dell'offerta più di una volta. Se false, un abbonato che ha già utilizzato questa offerta non potrà più usufruirne. Se true, un abbonato può tornare idoneo dopo che è trascorso il tempo indicato in minOfferCooldownDuration dalla fine del periodo di sconto dell'offerta di fidelizzazione precedente. Il valore predefinito è false.
  • minOfferCooldownDuration: obbligatorio se allowMultipleClaims è true. Il tempo minimo che deve trascorrere dalla fine del periodo di sconto dell'offerta di fidelizzazione precedente prima che l'abbonato sia nuovamente idoneo, come durata ISO 8601 in giorni, da P1D a P1826D. Ad esempio, utilizza P180D per 180 giorni. Non impostare questo campo se allowMultipleClaims è false o non è impostato.

L'esempio seguente mostra i campi startTime, endTime e targeting di un oggetto SubscriptionOffer per un'offerta di fidelizzazione disponibile per gli abbonati che hanno pagato per almeno 90 giorni e che possono richiedere nuovamente 180 giorni dopo la fine dello sconto di fidelizzazione precedente:

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

Scegli come target delle offerte di fidelizzazione abbonati specifici

Anziché lasciare che sia Google Play a decidere l'idoneità con un RetentionTargetingRule, puoi rendere disponibile un'offerta di fidelizzazione solo per gli abbonati scelti dal tuo backend. Ad esempio, potresti indirizzare un'offerta agli abbonati che il tuo modello di previsione del tasso di abbandono segnala come a rischio o agli abbonati che iniziano un percorso di annullamento nella tua app.

Gli abbonati vedono un'offerta di fidelizzazione per utente nello stesso flusso di annullamento di Google Play di qualsiasi altra offerta di fidelizzazione e tu gestisci l'accettazione nello stesso modo. Per maggiori dettagli, consulta Gestisci gli eventi delle offerte di fidelizzazione nel tuo backend.

Per scegliere come target delle offerte di fidelizzazione abbonati specifici:

  1. Crea un'offerta di fidelizzazione utenti per utente. Quando chiami il metodo monetization.subscriptions.basePlans.offers.create, monetization.subscriptions.basePlans.offers.patch o monetization.subscriptions.basePlans.offers.batchUpdate, imposta targeting su un oggetto retentionPerUserRule anziché su un oggetto retentionRule. L'oggetto RetentionPerUserTargetingRule non ha campi. Un'offerta può utilizzare retentionRule o retentionPerUserRule, ma non entrambi.

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

    Attiva l'offerta prima di scegliere come target gli abbonati. Se chiami il metodo activateOfferTargeting per un'offerta che non è mai stata attivata, la chiamata non va a buon fine e restituisce un codice di stato HTTP 400 Bad Request e uno stato di errore INVALID_ARGUMENT. Per maggiori dettagli, consulta Gestisci gli errori di targeting. Anche quando l'offerta è attiva, Google Play la mostra solo agli abbonati i cui abbonamenti sono scelti come target nel passaggio successivo.

  2. Scegli come target dell'offerta un abbonamento. Chiama il metodo purchases.subscriptionsv2.activateOfferTargeting con il nome del pacchetto della tua app, l'ID purchaseToken dell'abbonamento e l'ID offerId dell'offerta di fidelizzazione utenti per utente:

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

    Una chiamata riuscita restituisce un codice di stato HTTP 204 No Content senza corpo della risposta. Google Play memorizza il targeting con l'abbonamento, quindi non è necessario chiamare l'API al momento dell'annullamento da parte dell'abbonato. La prossima volta che l'abbonato inizierà la procedura di annullamento su Google Play, Google Play potrà mostrare l'offerta, a condizione che l'abbonamento soddisfi i requisiti di idoneità. Il targeting per utente sostituisce solo le regole di idoneità definite da un retentionRule. Tutti gli altri requisiti di idoneità e i controlli a livello di piattaforma eseguiti da Google Play, come i requisiti di conformità regionali, continuano a essere applicati.

    Puoi scegliere come target più di un'offerta di fidelizzazione utenti per lo stesso abbonamento. Per farlo, chiama il metodo activateOfferTargeting una volta per ogni offerta. Google Play mostra comunque al massimo un'offerta di fidelizzazione nel flusso di annullamento. Per maggiori dettagli su come Google Play sceglie l'offerta, consulta Configura le offerte di fidelizzazione.

    Il metodo activateOfferTargeting è idempotente. Se lo chiami per un'offerta già scelta come target per l'abbonamento, la chiamata va a buon fine e Google Play aggiorna il valore activateTime dell'offerta all'ora dell'ultima richiesta.

  3. Rimuovi il targeting quando necessario. Se non vuoi più che un abbonato riceva l'offerta, ad esempio perché il suo rischio di abbandono è cambiato, chiama il metodo purchases.subscriptionsv2.deactivateOfferTargeting con lo stesso nome del pacchetto, purchaseToken e offerId. Una chiamata riuscita restituisce un codice di stato HTTP 204 No Content senza corpo della risposta.

    Anche il metodo deactivateOfferTargeting è idempotente. Se l'offerta non è destinata all'abbonamento, ad esempio perché non hai mai attivato il targeting, la chiamata va a buon fine e non ha alcun effetto.

Il targeting si applica a un singolo purchaseToken e non scade finché l'abbonamento è attivo e si rinnova automaticamente. Rimane invariato dopo che l'abbonato visualizza, accetta o rifiuta l'offerta. Google Play lo rimuove solo quando chiami il metodo deactivateOfferTargeting o 60 giorni dopo la scadenza dell'abbonamento. Se una modifica del piano o una nuova sottoscrizione crea un nuovo purchaseToken, il targeting non viene trasferito.

Per verificare quali offerte di fidelizzazione utenti sono destinate a un abbonamento, chiama il metodo purchases.subscriptionsv2.get. Il campo developerTargetedOffers di ogni elemento pubblicitario elenca le offerte targettizzate. Ogni voce contiene offerId e activateTime quando hai attivato il targeting:

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

Gestisci gli errori di targeting

Quando una chiamata al metodo activateOfferTargeting o deactivateOfferTargeting non va a buon fine, la risposta contiene un codice di stato HTTP e uno stato di errore che descrive la causa. La tabella seguente elenca i codici di stato HTTP e gli stati di errore che questi metodi possono restituire:

Codice di stato HTTP Stato di errore Metodi Causa
404 Not Found NOT_FOUND Entrambi purchaseToken non esiste.
400 Bad Request INVALID_ARGUMENT activateOfferTargeting offerId non esiste nel piano base attuale dell'abbonamento oppure l'offerta è ancora in stato di bozza e non è mai stata attivata.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting L'attributo targeting dell'offerta non è impostato su retentionPerUserRule.
400 Bad Request FAILED_PRECONDITION activateOfferTargeting L'abbonamento è già scaduto.

Il metodo activateOfferTargeting non verifica se un abbonamento non scaduto è idoneo per l'offerta. Ad esempio, se l'abbonamento viene annullato, ma non è ancora scaduto, la chiamata va a buon fine e Google Play memorizza il targeting. Google Play valuta l'idoneità dell'abbonamento quando l'abbonato accede al flusso di annullamento.

Gestisci gli eventi delle offerte di fidelizzazione nel tuo backend

Quando un abbonato accetta un'offerta di fidelizzazione e, in seguito, quando avviene il rinnovo scontato, Google Play invia RTDN al tuo backend. Dopo aver ricevuto ogni notifica, chiama il metodo purchases.subscriptionsv2.get con il purchaseToken della notifica per ottenere lo stato più recente dell'abbonamento.

L'accettazione di un'offerta di fidelizzazione non crea un nuovo acquisto. Il valore purchaseToken rimane invariato, quindi non è necessario confermare nuovamente l'acquisto e Google Play non genera un valore linkedPurchaseToken. Mantieni il diritto esistente dell'abbonato. Elabora l'ordine di rinnovo scontato nello stesso modo di qualsiasi altro rinnovo dell'abbonamento.

Tipo di notifica Tempi di invio Cosa fare
SUBSCRIPTION_PLAN_TRANSITION_UPDATED (21) Quando un abbonato accetta un'offerta di fidelizzazione nel flusso di annullamento. Chiama il metodo purchases.subscriptionsv2.get e controlla planTransitionDetails. Il valore transitionState è IN_PROGRESS. L'abbonamento rimane attivo e con rinnovo automatico, quindi continua a concedere l'accesso.
SUBSCRIPTION_RENEWED (2) Quando termina il periodo di fatturazione corrente e l'abbonamento viene rinnovato al prezzo scontato dell'offerta di fidelizzazione. Chiama il metodo purchases.subscriptionsv2.get, verifica che offerDetails.offerId sia l'ID dell'offerta di fidelizzazione e che planTransitionDetails non sia più presente, quindi estendi l'accesso dell'abbonato al nuovo expiryTime.

L'oggetto planTransitionDetails contiene i seguenti campi:

  • productId: l'ID prodotto del piano a cui viene eseguita la transizione dell'abbonamento. Per un'offerta di fidelizzazione, si tratta dello stesso prodotto.
  • basePlanId: l'ID piano base del piano a cui passa l'abbonamento.
  • offerId: l'ID dell'offerta di fidelizzazione accettata dall'abbonato. Utilizza questo campo per identificare l'offerta di fidelizzazione utilizzata.
  • transitionInfo.transitionState: lo stato della transizione. Per le offerte di fidelizzazione, lo stato è IN_PROGRESS mentre la transizione è in attesa.
  • transitionInfo.expectedTransitionTime: la data in cui è prevista l'entrata in vigore dei termini dell'offerta di fidelizzazione.

Google Play include planTransitionDetails solo quando la transizione è in attesa. Quando l'abbonamento viene rinnovato al prezzo scontato dell'offerta di fidelizzazione, la transizione viene completata e Google Play rimuove planTransitionDetails dalla risposta purchases.subscriptionsv2.get. Da quel momento, l'elemento pubblicitario stesso mostra lo sconto per la fidelizzazione attivo:

  • offerDetails.offerId è l'ID dell'offerta di fidelizzazione accettata.
  • offerPhase è {"introductoryPrice": {}} durante i periodi di fatturazione scontati. Al termine dei periodi di fatturazione scontati e quando l'abbonamento viene rinnovato al prezzo del piano base normale, offerPhase cambia in {"basePrice": {}}.

Risposta dopo che l'abbonato accetta l'offerta

Dopo che l'abbonato accetta l'offerta di fidelizzazione, il periodo di fatturazione corrente continua invariato. L'oggetto planTransitionDetails mostra la transizione pianificata con un transitionState di 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"
          }
        }
      }
    }
  ]
}

Risposta dopo il rinnovo scontato

Dopo la data di rinnovo e l'addebito del prezzo scontato all'abbonato, offerDetails.offerId mostra l'offerta di fidelizzazione, offerPhase mostra introductoryPrice e la risposta non include più 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
        }
      }
    }
  ]
}

Interazioni del ciclo di vita

Tieni presente i seguenti comportamenti quando gestisci le offerte di fidelizzazione:

  • Fine dello sconto: al termine dei periodi di fatturazione scontati, l'abbonamento si rinnova automaticamente al prezzo normale del piano base. Riceverai una notifica SUBSCRIPTION_RENEWED, come per qualsiasi altro rinnovo, e il offerPhase dell'elemento pubblicitario cambierà in {"basePrice": {}}. L'abbonato non deve fare nulla.
  • Recupero del pagamento dopo lo sconto: se il rinnovo al prezzo del piano base standard dopo il termine dello sconto viene rifiutato e l'abbonamento entra in un periodo di tolleranza o in uno stato di sospensione dell'account, il recupero del pagamento addebita il prezzo del piano base standard. Google Play non applica lo sconto dell'offerta di fidelizzazione completata. Se il pagamento del primo rinnovo scontato viene rifiutato, la transizione in attesa viene conservata e il prezzo dell'offerta di fidelizzazione viene applicato quando il pagamento viene recuperato.
  • Fatturazione differita: se chiami il metodo purchases.subscriptionsv2.defer mentre una transizione dell'offerta di fidelizzazione è IN_PROGRESS, la transizione in attesa viene conservata e applicata al rinnovo differito. Per ottenere la nuova data di rinnovo, controlla la expiryTime dell'elemento pubblicitario.
  • Cambio di piano prima della transizione: un'offerta di fidelizzazione si applica solo alla purchaseToken dell'abbonamento in cui l'abbonato l'ha accettata. Se l'abbonato passa a un altro piano base o abbonamento prima del giorno expectedTransitionTime, Google Play genera un nuovo token di acquisto, annulla la transizione programmata e cancella planTransitionDetails. L'offerta di fidelizzazione in attesa non si applica al nuovo piano.
  • Annullamento e ripristino: se un abbonato annulla l'abbonamento dopo aver accettato un'offerta di fidelizzazione, la transizione programmata rimane in attesa e transitionState rimane IN_PROGRESS. Se l'abbonato ripristina l'abbonamento prima della scadenza, lo sconto dell'offerta di fidelizzazione viene comunque applicato al rinnovo.
  • Scadenza e nuovo abbonamento: se l'abbonamento scade senza essere ripristinato, Google Play annulla la transizione in attesa. Se l'utente si abbona di nuovo o si registra di nuovo in un secondo momento, Google Play crea un nuovo acquisto di abbonamento e l'offerta di fidelizzazione accettata in precedenza non viene applicata.
  • Modifiche alle offerte: se modifichi lo sconto o i periodi di fatturazione di un'offerta di fidelizzazione, la modifica si applica solo ai futuri utilizzi. Gli abbonati che hanno già accettato l'offerta mantengono i termini originali.
  • Disattivazione dell'offerta: se disattivi un'offerta di fidelizzazione o se l'offerta raggiunge la data di fine, gli abbonati che l'hanno già accettata mantengono i termini che hanno accettato. Gli abbonati con una transizione a IN_PROGRESS ricevono comunque lo sconto al rinnovo successivo, mentre gli abbonati che si trovano già nei periodi di fatturazione scontati mantengono lo sconto per l'intera durata concordata.
  • Variazioni di prezzo: le variazioni di prezzo del piano base continuano a essere applicate. Google Play esegue la migrazione di un abbonato a un nuovo prezzo solo quando l'abbonato paga il prezzo normale e non ha una transizione dell'offerta di fidelizzazione in attesa. Per maggiori informazioni, consulta la sezione Modifica i prezzi degli abbonamenti.
  • Rimborsi: puoi rimborsare un abbonato con le API standard di rimborso e revoca, ad esempio il metodo purchases.subscriptionsv2.revoke. In questo modo, viene rimborsato il pagamento più recente e l'accesso dell'abbonato viene interrotto.

Testa le offerte di fidelizzazione

Google Play mostra solo le offerte di fidelizzazione attive nel flusso di annullamento e valuta le regole di idoneità in tempo reale. Per testare le offerte di fidelizzazione con un account tester delle licenze, utilizza uno dei seguenti metodi:

Prima di utilizzare uno dei due metodi, vai a Impostazioni > Test delle licenze in Google Play Console e aggiungi l'Account Google di test come tester delle licenze.

Testa un'offerta di fidelizzazione utenti

Google Play mostra un'offerta di fidelizzazione per utente solo agli abbonamenti che hai scelto come target, in modo che tu possa testarla su un piano base di produzione senza esporla agli abbonati reali. Per testare un'offerta di fidelizzazione per utente, segui questi passaggi:

  1. Crea un'offerta di fidelizzazione per utente nel piano base e attivala. In Google Play Console, scegli Offerta di fidelizzazione a livello di utente. Con l'API Google Play Developer, imposta targeting su un oggetto retentionPerUserRule. Per maggiori dettagli, consulta Scegli come target delle offerte di fidelizzazione abbonati specifici.
  2. Se hai appena attivato l'offerta, attendi 10-15 minuti per consentire la propagazione della modifica, quindi svuota la cache dell'app Google Play Store.
  3. Sul dispositivo di test, accedi con l'account del tester delle licenze, quindi acquista il piano base nella tua app.
  4. Dal tuo backend, chiama il metodo purchases.subscriptionsv2.activateOfferTargeting con il nome del pacchetto della tua app, l'indirizzo purchaseToken del tester di licenze e l'ID offerId dell'offerta di fidelizzazione.
  5. Nell'app Google Play Store, vai a Pagamenti e abbonamenti > Abbonamenti, seleziona l'abbonamento e tocca Annulla abbonamento. L'offerta di fidelizzazione viene visualizzata nel flusso di annullamento.
  6. Accetta l'offerta, quindi verifica che il tuo backend riceva la RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED e gestisca il rinnovo scontato.

Testa un'offerta di fidelizzazione basata su regole

Dopo aver attivato un'offerta di fidelizzazione basata su regole, Google Play può mostrarla a qualsiasi abbonato idoneo al piano base. Per evitare di esporre l'offerta agli utenti di produzione, testala in un'app di test non di produzione o in un piano base di test dedicato a cui gli utenti di produzione non possono accedere. Per testare un'offerta di fidelizzazione basata su regole, segui questi passaggi:

  1. Nella tua app di test o nel tuo piano base di test, crea un'offerta di fidelizzazione basata su regole e imposta minDuration su P0D (0 giorni). In Google Play Console, scegli Offerta di fidelizzazione a livello di coorte. Con l'API Google Play Developer, imposta targeting su un oggetto retentionRule. Per maggiori dettagli, vedi Imposta le regole di idoneità alla conservazione.
  2. Attiva l'offerta, attendi 10-15 minuti per consentire la propagazione della modifica, quindi svuota la cache dell'app Google Play Store.
  3. Sul dispositivo di test, accedi con l'account del tester delle licenze, quindi acquista il piano base di test.
  4. Nell'app Google Play Store, vai a Pagamenti e abbonamenti > Abbonamenti, seleziona l'abbonamento e tocca Annulla abbonamento. Poiché l'offerta non richiede una durata minima dell'abbonamento a pagamento, puoi avviare il flusso di annullamento subito dopo l'acquisto. L'offerta di fidelizzazione viene visualizzata nel flusso di annullamento.
  5. Accetta l'offerta e poi verifica che il tuo backend riceva la RTDN SUBSCRIPTION_PLAN_TRANSITION_UPDATED e gestisca il rinnovo scontato.

Dopo aver verificato l'integrazione, crea e attiva l'offerta di fidelizzazione basata su regole nel tuo piano base di produzione.

Risolvi i problemi relativi ai test delle offerte di fidelizzazione

Se l'offerta di fidelizzazione non viene visualizzata, controlla quanto segue:

  • L'offerta di fidelizzazione è attiva e l'ora corrente è compresa tra startTime e endTime, se li hai impostati.
  • Per un'offerta di fidelizzazione utenti, il campo developerTargetedOffers nella risposta purchases.subscriptionsv2.get per il purchaseToken del tester di licenze include l'offerta.
  • L'abbonamento è un abbonamento singolo, non un abbonamento con componenti aggiuntivi.
  • L'abbonamento non è in un periodo di tolleranza, in sospensione dell'account o in pausa.
  • L'abbonamento non ha modifiche al piano o al prezzo in attesa.
  • Il rinnovo successivo sarà al prezzo del piano base standard. Per le prove senza costi e le offerte di lancio, l'offerta di fidelizzazione è disponibile solo durante il periodo di fatturazione finale della fase di prova o di lancio.
  • Hai atteso 10-15 minuti dopo l'attivazione o la modifica dell'offerta e hai svuotato la cache dell'app Play Store.