Creazione di una Sottoscrizione Auto-Rinnovabile per Android
Copia una riga di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Le sottoscrizioni rinnovabili automatiche forniscono accesso a contenuti, servizi o funzionalità premium nell'applicazione in modo continuativo. Questa guida ti aiuterà a creare e configurare le sottoscrizioni nel Console di Google Play.
Panoramica
Sezione intitolata “Panoramica”Le sottoscrizioni si rinnovano automaticamente alla fine di ogni periodo di fatturazione fino a quando l'utente non annulla. Sono ideali per:
- Accesso a contenuti premium
- Esperienze senza pubblicità
- Archiviazione in cloud
- Servizi in corso
Creare una Sottoscrizione
Sezione intitolata “Creare una Sottoscrizione”-
Naviga alle Sottoscrizioni
In Google Play Console, seleziona la tua app e scegli Monetizza > Sottoscrizioni dalla menu a sinistra.
Clicca il Crea abbonamento Clicca per iniziare.

-
Inserisci informazioni base
Inserisci un nome di abbonamento e un ID prodotto. L'ID prodotto è richiesto per la configurazione nell'app e non può essere modificato in seguito.

-
Crea piano base
Google Play richiede esattamente un piano base per abbonamento. Il plugin native-purchases supporta solo un piano base per mantenere la compatibilità con iOS.
Clicca Aggiungi piano base Per continuare.

-
Configura dettagli del piano base
Inserisci:
- ID del piano base: Identificatore univoco per questo piano
- Periodo di fatturazione: Quante volte gli utenti vengono addebitati (settimanale, mensile, annuale, ecc.)
- Periodo di grazia: Intervallo di tempo durante il quale Google mantiene l'abbonamento mentre riprova il pagamento prima della cancellazione

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

-
Configura Prezzo
Imposta il tuo prezzo base nella tua valuta principale. Google Play converte automaticamente questo prezzo nelle valute locali.

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

-
Salva Configurazione
Salva la tua configurazione dei prezzi.

-
Attiva Abbonamento
Clicca il Attiva tasto per rendere il prodotto di abbonamento attivo e disponibile per l'acquisto.

Considerazioni importanti
Sezione intitolata “Considerazioni importanti”Limitazione del piano base
Sezione intitolata “Limitazione del piano base”Il plugin native-purchases richiede esattamente un piano base per abbonamento per garantire la consistenza con la gestione delle sottoscrizioni di iOS. Non sono supportati più piani base.
Periodo di grazia
Sezione intitolata “Periodo di grazia”Il periodo di grazia consente a Google Play di riprovare i pagamenti falliti mantenendo l'accesso dell'utente alla sottoscrizione. I periodi di grazia comuni sono:
- 3 giorni per le sottoscrizioni mensili
- 7 giorni per le sottoscrizioni più lunghe
Stato della Sottoscrizione
Sezione intitolata “Stato della Sottoscrizione”Dopo la creazione, lo stato della sottoscrizione sarà “Bozza” fino a quando non sarà attivato. È possibile testare le sottoscrizioni bozza in modalità sandbox.
Utilizzo nel Tuo App
Sezione intitolata “Utilizzo nel Tuo App”Una volta creata, si riferisca alla sottoscrizione nel tuo app utilizzando l'ID del prodotto:
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
// Load subscription infoconst { 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 stateconst { 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}Passaggi Successivi
Sezione intitolata “Passaggi Successivi”- Crea un'offerta introduttiva per attirare nuovi sottoscrittori
- Configura il testing in modalità sandbox To verificare le tue sottoscrizioni
- Configura la validazione delle ricevute backend per la sicurezza
Risoluzione dei problemi
Sottosezione intitolata “Risoluzione dei problemi”La sottoscrizione non compare nell'app:
- Verifica che l'ID del prodotto corrisponda esattamente
- Assicurati che la sottoscrizione sia attivata
- Controlla che la tua app abbia il nome del pacchetto corretto
- Aspetta 2-3 ore dopo l'attivazione affinché le modifiche si propaghino
Errori del piano base:
- Assicurati di avere esattamente un piano base
- Verifica che tutti i campi richiesti siano compilati
- Verifica che il periodo di fatturazione è valido
Problemi di prezzo:
- Conferma di aver selezionato almeno un paese
- Verifica che il prezzo base sia maggiore del minimo consentito
- Verifica che i tassi di conversione valuta siano accettabili
Continua da Crea sottoscrizione Android Auto-Rinnovabile
Sezione intitolata “Continua da Crea sottoscrizione Android Auto-Rinnovabile”Se stai utilizzando Crea sottoscrizione Android Auto-Rinnovabile per pianificare l'approvazione e la distribuzione della tua app, connettila con Utilizza @capgo/native-purchases per la capacità nativa in Utilizza @capgo/native-purchases, @capgo/capacitor-recensione all'interno dell'app per i dettagli di implementazione in @capgo/capacitor-recensione all'interno dell'app, Utilizzo di @capgo/capacitor-recensione all'interno dell'app per i dettagli di implementazione in Utilizzo di @capgo/capacitor-recensione all'interno dell'app, @capgo/capacitor-mercato nativo per i dettagli di implementazione in @capgo/capacitor-mercato nativo, e Utilizzo di @capgo/capacitor-mercato nativo per i dettagli di implementazione in Utilizzo di @capgo/capacitor-mercato nativo.