Saltare al contenuto

Crea Sottoscrizione Auto-Rinnovabile per Android

GitHub

Le sottoscrizioni auto-rinnovabili 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.

Le sottoscrizioni si rinnovano automaticamente alla fine di ogni periodo di fatturazione fino a quando l'utente non annulla. Sono ideali per:

  • L'accesso ai contenuti premium
  • L'esperienza senza pubblicità
  • Storage in cloud
  • Servizi in corso
  1. Naviga alle sottoscrizioni

    In Console di Google Play, seleziona la tua app e scegli Monetizza > Sottoscrizioni dal menu a sinistra.

    Clicca sul Crea sottoscrizione tasto per iniziare.

    Naviga alle sottoscrizioni

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

    Inserisci dettagli di abbonamento

  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.

    Crea piano base

  4. Configura dettagli del piano base

    Inserisci:

    • ID piano base: Identificatore univoco per questo piano
    • Percorso di fatturazione: Periodicità con cui gli utenti sono addebitati (ad esempio settimanale, mensile, annuale, ecc.)
    • Periodo di grazia: Intervallo di tempo durante il quale Google mantiene la sottoscrizione mentre riprova il pagamento prima della cancellazione

    Configura piano base

  5. Configura prezzi

    Accedi alla sezione prezzi e seleziona tutti i paesi/regioni in cui desideri offrire la sottoscrizione.

    Scegli regioni

  6. Configura prezzo

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

    Settare prezzo

  7. Verifica i prezzi regionali

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

    Verifica i prezzi

  8. Salva la configurazione

    Salva la tua configurazione dei prezzi.

    Salva i prezzi

  9. Attiva la sottoscrizione

    Click sul Attiva il pulsante per rendere il tuo prodotto di sottoscrizione attivo e disponibile per l'acquisto.

    Attiva la sottoscrizione

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

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

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

Dopo la creazione, il tuo abbonamento sarà in stato “Bozza” fino all'attivazione. Puoi testare le bozze degli abbonamenti in modalità sandbox.

Una volta creato, si fa riferimento alla sottoscrizione nel tuo app utilizzando l'ID del prodotto:

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
}

La sottoscrizione non compare nell'app:

  • Verifica che l'ID del prodotto corrisponda esattamente
  • Assicurati che la sottoscrizione sia attivata
  • Controlla che l'app abbia il nome del pacchetto corretto
  • Attendi 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
  • Controlla che il periodo di fatturazione sia valido

Issue di prezzo:

  • Conferma di aver selezionato almeno un paese
  • Verifica che il prezzo base sia maggiore del prezzo minimo consentito
  • Controlla le tariffe di conversione della valuta siano accettabili

Se stai utilizzando Crea abbonamento Android Auto-Rinnovabile per pianificare l'approvazione e la distribuzione della tua app, collega Utilizza @capgo/native-purchases per la capacità nativa in Utilizza @capgo/native-purchases Utilizza @capgo/capacitor-in-app-review per il dettaglio di implementazione in Utilizza @capgo/capacitor-in-app-review Utilizza @capgo/capacitor-in-app-review per la capacità nativa in Utilizzare @capgo/capacitor-in-app-review, @capgo/capacitor-native-market per il dettaglio di implementazione in @capgo/capacitor-native-market, e Utilizzare @capgo/capacitor-native-market per la capacità nativa in Utilizzare @capgo/capacitor-native-market.