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:
- Aver creato un abbonamento con almeno un piano base con rinnovo automatico. Le offerte di fidelizzazione possono essere aggiunte solo ai piani base con rinnovo automatico.
- Configurato le notifiche in tempo reale per lo sviluppatore (RTDN) e configurato il tuo backend per chiamare il metodo
purchases.subscriptionsv2.get. Il tuo backend li utilizza per rilevare quando un abbonato accetta un'offerta di fidelizzazione.
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:
- L'abbonato apre il suo abbonamento in Google Play e inizia ad annullarlo.
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.
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
planTransitionDetailsal campoautoRenewingPlandell'elemento pubblicitario interessato nella risorsaSubscriptionPurchaseV2.
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
planTransitionDetailsnello statoIN_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:
- 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. - 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.
- Prezzo scontato: se le offerte hanno la stessa percentuale di sconto, Google Play mostra l'offerta con il prezzo scontato più basso.
- 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:
- Vai a Monetizza con Google Play > Prodotti > Abbonamenti.
- Seleziona un abbonamento, quindi il piano base a cui vuoi aggiungere l'offerta.
- Aggiungi un'offerta per gli abbonati esistenti che tentano di annullare l'abbonamento.
- 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: impostaretentionRulesu un oggettoRetentionTargetingRuleche 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, impostaretentionPerUserRule. 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. SerecurrenceCountè maggiore di 1, la fasedurationdeve corrispondere al periodo di fatturazione del piano base.regionalConfigs[]: impostarelativeDiscountsullo sconto come frazione maggiore di 0 e minore di 1. Ad esempio, utilizza0.5per uno sconto del 50%. Le offerte di fidelizzazione supportano solorelativeDiscount. 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 astartTime.
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, daP0DaP1826D. Ad esempio, utilizzaP90Dper 90 giorni. Per non richiedere un periodo minimo di abbonamento a pagamento, imposta questo campo suP0D.allowMultipleClaims: (Facoltativo) Se un abbonato può usufruire dell'offerta più di una volta. Sefalse, un abbonato che ha già utilizzato questa offerta non potrà più usufruirne. Setrue, un abbonato può tornare idoneo dopo che è trascorso il tempo indicato inminOfferCooldownDurationdalla fine del periodo di sconto dell'offerta di fidelizzazione precedente. Il valore predefinito èfalse.minOfferCooldownDuration: obbligatorio seallowMultipleClaimsè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, daP1DaP1826D. Ad esempio, utilizzaP180Dper 180 giorni. Non impostare questo campo seallowMultipleClaimsèfalseo 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:
Crea un'offerta di fidelizzazione utenti per utente. Quando chiami il metodo
monetization.subscriptions.basePlans.offers.create,monetization.subscriptions.basePlans.offers.patchomonetization.subscriptions.basePlans.offers.batchUpdate, impostatargetingsu un oggettoretentionPerUserRuleanziché su un oggettoretentionRule. L'oggettoRetentionPerUserTargetingRulenon ha campi. Un'offerta può utilizzareretentionRuleoretentionPerUserRule, ma non entrambi.{ "offerId": "retention-peruser-30off", "targeting": { "retentionPerUserRule": {} } }Attiva l'offerta prima di scegliere come target gli abbonati. Se chiami il metodo
activateOfferTargetingper un'offerta che non è mai stata attivata, la chiamata non va a buon fine e restituisce un codice di stato HTTP400 Bad Requeste uno stato di erroreINVALID_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.Scegli come target dell'offerta un abbonamento. Chiama il metodo
purchases.subscriptionsv2.activateOfferTargetingcon il nome del pacchetto della tua app, l'IDpurchaseTokendell'abbonamento e l'IDofferIddell'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 Contentsenza 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 unretentionRule. 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
activateOfferTargetinguna 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 valoreactivateTimedell'offerta all'ora dell'ultima richiesta.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.deactivateOfferTargetingcon lo stesso nome del pacchetto,purchaseTokeneofferId. Una chiamata riuscita restituisce un codice di stato HTTP204 No Contentsenza 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_PROGRESSmentre 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,offerPhasecambia 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 ilofferPhasedell'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.defermentre 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 laexpiryTimedell'elemento pubblicitario. - Cambio di piano prima della transizione: un'offerta di fidelizzazione si applica solo alla
purchaseTokendell'abbonamento in cui l'abbonato l'ha accettata. Se l'abbonato passa a un altro piano base o abbonamento prima del giornoexpectedTransitionTime, Google Play genera un nuovo token di acquisto, annulla la transizione programmata e cancellaplanTransitionDetails. 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
transitionStaterimaneIN_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_PROGRESSricevono 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:
- Testa un'offerta di fidelizzazione utenti per utente su un piano base di produzione, senza mostrare l'offerta agli abbonati reali.
- Testa un'offerta di fidelizzazione basata su regole in un'app di test o in un piano base di test a cui gli utenti di produzione non possono accedere.
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:
- 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
targetingsu un oggettoretentionPerUserRule. Per maggiori dettagli, consulta Scegli come target delle offerte di fidelizzazione abbonati specifici. - 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.
- Sul dispositivo di test, accedi con l'account del tester delle licenze, quindi acquista il piano base nella tua app.
- Dal tuo backend, chiama il metodo
purchases.subscriptionsv2.activateOfferTargetingcon il nome del pacchetto della tua app, l'indirizzopurchaseTokendel tester di licenze e l'IDofferIddell'offerta di fidelizzazione. - 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.
- Accetta l'offerta, quindi verifica che il tuo backend riceva la RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDe 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:
- Nella tua app di test o nel tuo piano base di test, crea un'offerta di fidelizzazione basata su regole e imposta
minDurationsuP0D(0 giorni). In Google Play Console, scegli Offerta di fidelizzazione a livello di coorte. Con l'API Google Play Developer, impostatargetingsu un oggettoretentionRule. Per maggiori dettagli, vedi Imposta le regole di idoneità alla conservazione. - Attiva l'offerta, attendi 10-15 minuti per consentire la propagazione della modifica, quindi svuota la cache dell'app Google Play Store.
- Sul dispositivo di test, accedi con l'account del tester delle licenze, quindi acquista il piano base di test.
- 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.
- Accetta l'offerta e poi verifica che il tuo backend riceva la RTDN
SUBSCRIPTION_PLAN_TRANSITION_UPDATEDe 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
startTimeeendTime, se li hai impostati. - Per un'offerta di fidelizzazione utenti, il campo
developerTargetedOffersnella rispostapurchases.subscriptionsv2.getper ilpurchaseTokendel 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.