Crea sottoscrizione Android Auto-Rinnovabile

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 Google Play Console.

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

1. Naviga alle Sottoscrizioni

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

   Clicca sul Crea abbonamento button per iniziare.

   

2. Inserisci informazioni base

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

   

3. 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.

   

4. Configura dettagli del piano base

   Inserisci:

   • ID piano base: Identificatore univoco per questo piano
   • Periodo di fatturazione: Quante volte gli utenti sono 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

   

5. Imposta il prezzo

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

   

6. Configura il prezzo

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

   

7. Verifica i prezzi regionali

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

   

8. Salva la configurazione

   Salva la tua configurazione dei prezzi.

   

9. Attiva Abbonamento

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

   

Considerazioni importanti

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

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

• 3 giorni per le sottoscrizioni mensili
• 7 giorni per le sottoscrizioni più lunghe

Stato della Sottoscrizione

Utilizzo nel Tuo App

Una volta creata, riferisci la sottoscrizione nel tuo app utilizzando l'ID del prodotto:

Passaggi Successivi

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
}

__CAPGO_KEEP_0__

• Crea un'offerta introduttiva per attirare nuovi sottoscrittori
• Configura il testing del sandbox per testare le tue sottoscrizioni
• Configura la validazione dei ricevuti di backend per la sicurezza

Risolvere i problemi

La sottoscrizione non appare nell'app:

• Verifica che l'ID del prodotto corrisponda esattamente
• Assicurati che la sottoscrizione sia attivata
• Controlla che il tuo app abbia il nome del pacchetto corretto
• Attendere 2-3 ore dopo l'attivazione per le modifiche a propagarsi

Errori del piano base:

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

Problemi di prezzo:

• Conferma che almeno un paese è selezionato
• Verifica che il prezzo base sia maggiore del minimo consentito
• Controlla che i tassi di conversione della valuta siano accettabili