Crea un abbonamento Android a rinnovo automatico

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.

Panoramica

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

Creazione di un abbonamento

1. Vai su Subscriptions

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

   Clicca sul Crea abbonamento per iniziare.

   

2. Inserisci informazioni di base

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

   

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.

   

4. Configura i dettagli del Piano Base

   Inserisci:

   • ID Piano Base: Identificativo univoco per questo piano
   • Periodo di fatturazione: Frequenza di addebito (settimanale, mensile, annuale, ecc.)
   • Periodo di grazia: Finestra temporale in cui Google mantiene l'abbonamento mentre riprova il pagamento prima della cancellazione

   

5. Configura il pricing

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

   

6. Configura il prezzo

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

   

7. Controlla il pricing regionale

   Controlla i prezzi convertiti automaticamente per ogni paese. Puoi regolare i singoli prezzi se necessario.

   

8. Salva configurazione

   Salva la configurazione dei prezzi.

   

9. Attiva abbonamento

   Clicca sul Attiva pulsante per rendere il prodotto in abbonamento attivo e acquistabile.

   

Considerazioni importanti

Limite del piano base

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.

Periodo di tolleranza

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

Stato dell'abbonamento

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

Utilizzo nell'app

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
}

Prossimi passi

• Crea un'offerta introduttiva per attirare nuovi abbonati
• Configura il testing in sandbox per testare i tuoi abbonamenti
• Configura la validazione dei receipt sul backend per la sicurezza

Risoluzione problemi

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

Se stai usando Crea 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.