Vai al contenuto

Crea un abbonamento Android a rinnovo automatico

GitHub

Gli abbonamenti con rinnovo automatico offrono accesso continuo a contenuti, servizi o funzionalità premium nella tua app. Questa guida ti aiuterà a creare e configurare gli abbonamenti su Google Play Console.

Gli abbonamenti si rinnovano automaticamente alla fine di ogni periodo di fatturazione, finché l'utente non li annulla. Sono ideali per:

  • Accesso a contenuti premium
  • Esperienze senza pubblicità
  • Archiviazione cloud
  • Servizi ricorrenti
  1. Vai su Subscriptions

    In Google Play Console, seleziona la tua app e scegli Monetizzazione > Abbonamenti dal menu a sinistra.

    Clicca sul Crea abbonamento per iniziare.

    Vai agli abbonamenti

  2. Inserisci le informazioni di base

    Fornisci un nome per l'abbonamento e un product ID. Il product ID è obbligatorio per la configurazione nell'app e non può essere modificato in seguito.

    Inserisci i dettagli dell'abbonamento

  3. Crea piano base

    Google Play richiede esattamente un piano base per ogni abbonamento. Il plugin native-purchases supporta un solo piano base per garantire la compatibilità con iOS.

    Clicca su Aggiungi piano base per continuare.

    Crea piano base

  4. Configura i dettagli del piano base

    Inserisci:

    • ID piano base: Identificativo univoco per questo piano
    • Periodo di fatturazione: Frequenza con cui gli utenti vengono addebitati (settimanale, mensile, annuale, ecc.)
    • Periodo di grazia: Finestra temporale in cui Google mantiene l'abbonamento mentre riprova il pagamento prima dell'annullamento

    Configura piano base

  5. Configura il prezzo

    Accedi alla sezione prezzi e seleziona tutti i paesi/regioni in cui desideri offrire l'abbonamento.

    Seleziona regioni

  6. Configura prezzo

    Imposta il prezzo base nella tua valuta principale. Google Play lo converte automaticamente nelle valute locali.

    Imposta prezzo

  7. Verifica prezzi regionali

    Verifica i prezzi convertiti automaticamente per ogni paese. Puoi regolare i prezzi individuali se necessario.

    Verifica prezzi

  8. Salva configurazione

    Salva la configurazione dei prezzi.

    Salva prezzi

  9. Attiva abbonamento

    Clicca sul Attiva pulsante per rendere il tuo prodotto di abbonamento attivo e disponibile all'acquisto.

    Attiva abbonamento

Il plugin native-purchases richiede esattamente un piano base per ogni abbonamento per garantire la coerenza con la gestione degli abbonamenti su iOS. Non sono supportati più piani base.

Il periodo di grazia consente a Google Play di riprovare i pagamenti falliti mantenendo attivo l'accesso all'abbonamento dell'utente. I periodi di grazia comuni sono:

  • 3 giorni per abbonamenti mensili
  • 7 giorni per abbonamenti più lunghi

Dopo la creazione, l'abbonamento sarà in stato “Bozza” fino all'attivazione. Puoi testare gli abbonamenti in bozza in modalità sandbox.

Una volta creata, fai riferimento all'abbonamento nella tua app usando il product ID:

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Load subscription info
const { products } = await NativePurchases.getProducts({
productIdentifiers: ['com.example.premium.monthly'],
productType: PURCHASE_TYPE.SUBS,
});
const product = products[0];
console.log(`${product.title} — ${product.priceString}`);
// Purchase (planIdentifier = Base Plan ID from Google Play Console)
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: 'com.example.premium.monthly',
planIdentifier: 'monthly-plan', // REQUIRED on Android, ignored on iOS
productType: PURCHASE_TYPE.SUBS,
});
console.log('Transaction ID', transaction.transactionId);
// Later, check purchase state
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const subscription = purchases.find(
(purchase) => purchase.productIdentifier === 'com.example.premium.monthly',
);
if (subscription && subscription.purchaseState === 'PURCHASED' && subscription.isAcknowledged) {
console.log('Subscription active locally');
// For expiration/cancellation, validate purchaseToken through your backend
}

L'abbonamento non appare nell'app:

  • Verifica che l'ID prodotto corrisponda esattamente
  • Assicurati che l'abbonamento sia attivo
  • Controlla che l'app abbia il package name corretto
  • Attendi 2-3 ore dopo l'attivazione perché le modifiche si propaghino

Errori del base plan:

  • Assicurati di avere esattamente un base plan
  • Verifica che tutti i campi obbligatori siano compilati
  • Controlla che il periodo di fatturazione sia valido

Problemi di pricing:

  • Conferma che sia selezionato almeno un paese
  • Verifica che il prezzo base sia superiore al minimo consentito
  • Controlla che i tassi di cambio siano accettabili

Continua da Crea abbonamento Android con rinnovo automatico

Sezione intitolata “Continua da Create Android Auto-Renewable Subscription”

Se stai usando Crea un abbonamento Android a rinnovo automatico per pianificare l'approvazione e la distribuzione negli store, collegalo a Utilizzo di @capgo/native-purchases per la funzionalità nativa in Utilizzo di @capgo/native-purchases, @capgo/capacitor-in-app-review per i dettagli di implementazione in @capgo/capacitor-in-app-review, Utilizzo di @capgo/capacitor-in-app-review per la funzionalità nativa in Utilizzo di @capgo/capacitor-in-app-review, @capgo/capacitor-native-market per i dettagli di implementazione in @capgo/capacitor-native-market, e Utilizzo di @capgo/capacitor-native-market per la funzionalità nativa in Utilizzo di @capgo/capacitor-native-market.