Saltare al contenuto

Crea Sottoscrizione Android Auto-Rinnovabile

GitHub

Gli abbonamenti auto-rinnovabili forniscono accesso a contenuti, servizi o funzionalità premium nell'applicazione in modo continuativo. Questa guida vi aiuterà a creare e configurare gli abbonamenti nel Console di Google Play.

Gli abbonamenti 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

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

    Clicca sul Crea sottoscrizione bottone 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 Piano Base

    Inserisci:

    • ID piano base: Identificatore univoco per questo piano
    • Periodo di fatturazionecontext: Pagina/Area: Pagina di fatturazione o calcolatore di piano UI. Ruolo: Etichetta di navigazione breve o elemento UI. Visualizzato in: componente pricing/PricingCalculator.astro. Chiave di messaggio `pricing_calculator_billing_period` (Periodo di fatturazione del Calcolatore di Prezzi).
    • : Quante volte gli utenti sono addebitati (settimanali, mensili, annuali, ecc.)Periodo di grazia

    : Intervallo di tempo durante il quale Google mantiene la sottoscrizione mentre riprova il pagamento prima della cancellazione

  5. Configura piano base

    Configura il prezzo

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

  6. Seleziona regioni

    Configura prezzo

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

  7. Valuta Prezzi Regionali

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

    Valuta prezzi

  8. Salva Configurazione

    Salva la tua configurazione dei prezzi.

    Salva prezzi

  9. Attiva Abbonamento

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

    Attiva abbonamento

Il plugin native-purchases richiede esattamente un piano base per abbonamento per garantire la coerenza 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 a quando non sarà attivato. 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 il nome del pacchetto dell'app sia 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

Problemi 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 valuta siano accettabili

Se stai utilizzando Crea abbonamento Android Auto-Rinnovabile per pianificare l'approvazione della store e la distribuzione, connettilo con Utilizzando @capgo/native-purchases per la capacità nativa in Utilizzando @capgo/native-purchases @capgo/capacitor-recensione-in-app per il dettaglio di implementazione in @capgo/capacitor-recensione-in-app Utilizzando @capgo/capacitor-recensione-in-app 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.