Crea abbonamento iOS Auto-Rinnovabile

Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.

Le sottoscrizioni auto-rinnovabili forniscono accesso ricorrente a contenuti, servizi o funzionalità premium nell'app iOS. Questa guida ti guida attraverso la creazione di sottoscrizioni in App Store Connect.

Panoramica

Le sottoscrizioni auto-rinnovabili si rinnovano automaticamente alla fine di ogni periodo di fatturazione fino a quando gli utenti non le cancellano. Sono perfette per:

Contenuti e funzionalità premium
Esperienze senza pubblicità
Archiviazione e sincronizzazione in cloud
Servizi di streaming
Strumenti e utilità professionali

Requisiti

Prima di creare le sottoscrizioni, è necessario:

Creare un gruppo di sottoscrizioni per organizzare le sottoscrizioni
Disporre di un'iscrizione attiva al programma di sviluppatori Apple
Informazioni bancarie e fiscali complete in App Store Connect

Creazione di una sottoscrizione

Naviga alle sottoscrizioni

In App Store Connect, seleziona il tuo app e vai a Monetizza > Sottoscrizioni.

Seleziona il tuo gruppo di sottoscrizioni o crea uno nuovo se necessario.
Crea nuova sottoscrizione

Clicca l'icona + vicina al tuo gruppo di sottoscrizioni per aggiungere una nuova sottoscrizione.
Inserisci informazioni base

Nome di Riferimento: Nome descrittivo per il tuo utilizzo interno (non visualizzato ai clienti)
- Esempi: “Abbonamento Mensile Premium”, “Piano Annuale Ultimo”, “Piano Base”
ID del Prodotto: Identificatore univoco per questa sottoscrizione (non può essere modificato in seguito)
- Formato: com.yourcompany.yourapp.premium_monthly
- Usa nomi descrittivi, in minuscolo, con underscore
- Richiesto per la configurazione del plugin native-purchases
Configura Durata

Seleziona la durata della sottoscrizione dalle opzioni disponibili:
- 1 settimana
- 1 mese
- 2 mesi
- 3 mesi
- 6 mesi
- 1 anno
La durata determina con quale frequenza gli utenti vengono fatturati.
Impostazione del prezzo

Clicca Aggiungi prezzo di abbonamento per configurare il prezzo:

Territorio base: Seleziona il tuo mercato principale (di solito il tuo paese)

Prezzo: Imposta il prezzo della sottoscrizione
- Apple converte automaticamente in altre valute
- Scegli da una delle classi di prezzo di Apple
- Considera il valore percepito e i tassi di mercato
Condivisione della famiglia (Facoltativa)

Decidi se abilitare la condivisione della famiglia, che consente fino a 6 membri della famiglia di accedere alla sottoscrizione.

Una volta abilitata la condivisione della famiglia, non può essere disabilitata per questo prodotto.

Abilita se:
- Il contenuto è adatto per l'uso familiare
- Vuoi aumentare la proposta di valore
- Il tuo modello di business lo supporta
Non abilitare se:
- La sottoscrizione è destinata all'uso individuale solo
- Il contenuto è personalizzato per l'utente
- Vuoi massimizzare il reddito per utente
Aggiungi Localizzazioni

Aggiungi informazioni di visualizzazione della sottoscrizione in tutte le lingue che il tuo app supporta:

Nome della Sottoscrizione: Nome visibile dall'utente (ad esempio, “Premium Mensile”)

Descrizione: Descrizione breve di cosa include la sottoscrizione
- Tieni le cose concise e focalizzate sul beneficio
- Menziona le principali caratteristiche
- Sottolinea la proposta di valore
Immagine promozionale per l'App Store (Facoltativa)

Carica un'immagine promozionale per questa sottoscrizione (312x390 pixel):
- Si visualizza nella pagina della sottoscrizione dell'App Store
- Deve corrispondere al design dell'app
- Includi il nome della sottoscrizione per chiarezza
Sebbene le immagini siano facoltative per la sottoscrizione iniziale, sono richieste per la visualizzazione promozionale nella App Store. Puoi aggiungerle in seguito.
Salva e Invia

Clicca Salva per creare la sottoscrizione.

Per la Prima Sottoscrizione:
- Deve essere inviato con una nuova versione dell'app
- Includi nella tua prossima sottoscrizione nella App Store
- Non può essere inviato indipendentemente
Per Sottoscrizioni successive:
- Può essere inviato direttamente dalla pagina delle Sottoscrizioni
- Non richiede una nuova versione dell'app
- Disponibile dopo l'approvazione della prima sottoscrizione

Stato della Sottoscrizione

La tua sottoscrizione avrà uno dei seguenti stati:

Stato	Descrizione	Puoi Testare?
Dati mancanti	Setup incompleto	Sì (sandbox)
Pronto per la Sottoscrizione	Completo ma non inviato	Sì (sandbox)
In attesa di revisione	Invia a Apple	Sì (sandbox)
In revisione	In esame da Apple	Sì (sandbox)
Approvato	Disponibile per l'acquisto	Sì
Rifiutato	Richiede modifiche	Sì (sandbox)

Utilizzo nel tuo App

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

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';

// Fetch subscription products direct from StoreKit
const { products } = await NativePurchases.getProducts({
  productIdentifiers: [
    'com.yourcompany.yourapp.premium_monthly',
    'com.yourcompany.yourapp.premium_annual',
  ],
  productType: PURCHASE_TYPE.SUBS,
});

products.forEach((product) => {
  console.log(`${product.title}: ${product.priceString}`);
  console.log(`Duration: ${product.subscriptionPeriod}`);
  console.log(`Description: ${product.description}`);
});

// Purchase a subscription (StoreKit 2 automatically handles intro pricing and offers)
try {
  const transaction = await NativePurchases.purchaseProduct({
    productIdentifier: 'com.yourcompany.yourapp.premium_monthly',
    productType: PURCHASE_TYPE.SUBS,
  });

  console.log('Transaction ID:', transaction.transactionId);

  // StoreKit receipts are included on iOS for server-side validation
  await sendReceiptToBackend(transaction.receipt);
} catch (error) {
  console.error('Purchase failed:', error);
}

// Check subscription status using the store's data
const { purchases } = await NativePurchases.getPurchases({
  productType: PURCHASE_TYPE.SUBS,
});

const premium = purchases.find(
  (purchase) => purchase.productIdentifier === 'com.yourcompany.yourapp.premium_monthly',
);

if (premium?.isActive) {
  console.log('Expires:', premium.expirationDate);
  console.log('Will renew:', premium.willCancel === false);
  console.log('Store state:', premium.subscriptionState);
  unlockPremiumFeatures();
} else {
  showPaywall();
}

Mensile con piani di impegno di 12 mesi

Se la tua sottoscrizione di App Store Connect è configurata con un piano di fatturazione mensile e un impegno di 12 mesi, StoreKit può restituire termini di prezzo aggiuntivi per quel prodotto. Utilizza quei termini per mostrare il carico mensile, il prezzo di impegno totale e il periodo di impegno completo prima dell'acquisto.

const yearlyProduct = products.find(
  (product) => product.identifier === 'com.yourcompany.yourapp.premium_annual',
);

const monthlyCommitment = yearlyProduct?.pricingTerms?.find(
  (term) => term.billingPlanType === 'monthly',
);

if (yearlyProduct && monthlyCommitment) {
  console.log('Monthly charge:', monthlyCommitment.billingDisplayPrice);
  console.log('Total commitment:', monthlyCommitment.commitmentInfo?.priceString);

  await NativePurchases.purchaseProduct({
    productIdentifier: yearlyProduct.identifier,
    productType: PURCHASE_TYPE.SUBS,
    billingPlanType: 'monthly',
  });
}

Per la configurazione completa del paywall e del flusso di abbonamento, vedere Piani di fatturazione mensili per iOS.

Pratiche raccomandate

Strategia di prezzo

Piani mensili: Barriera di ingresso più bassa, costruisce abitudine
Piani annuali: Miglior valore, maggiore LTV, minor churn
Più livelli: Base, Premium, Ultimate per diversi segmenti di utenti
Analisi competitiva: Ricerca i prezzi degli app simili

ID dei prodotti

Usa denominazioni coerenti: company.app.tier_duration
Includi livello e durata nell'ID: premium_monthly, ultimate_annual
Evita di modificare gli ID dei prodotti (sono permanenti)
Documenta tutti gli ID dei prodotti per il tuo team

Abilita per app orientate alla famiglia (giochi, educative, intrattenimento)
Considera l'impatto sulle entrate
Testare il comportamento di condivisione attentamente
Comunicare la capacità di condivisione nella promozione

Localizzazione

Traduci tutti i nomi e le descrizioni delle sottoscrizioni
Considerare le differenze di prezzo regionali
Testare la visualizzazione in tutte le lingue supportate
Usare un linguaggio di marketing appropriato per la cultura

Immagini promozionali

Mantieni uno stile visivo coerente
Includi il nome della sottoscrizione e il beneficio chiave
Aggiornamento per promozioni stagionali
Corrispondenza al linguaggio di design dell'app

Modelli di abbonamento comuni

Livello unico (Freemium)

Free App + Premium Subscription
- Basic: Free (limited features)
- Premium Monthly: $4.99
- Premium Annual: $39.99 (save 33%)

Livelli multipli (Buono, Migliore, Miglior)

- Basic Monthly: $4.99
- Premium Monthly: $9.99
- Ultimate Monthly: $19.99

- Basic Annual: $49.99
- Premium Annual: $99.99
- Ultimate Annual: $199.99

Ibrido consumabile + abbonamento

- Credit packs (consumable)
- Monthly subscription (unlimited credits)
- Annual subscription (unlimited + bonus features)

Risoluzione dei problemi

La sottoscrizione non si carica nell'app:

Verifica che l'ID del prodotto corrisponda esattamente (senza distinzione tra maiuscole e minuscole)
Controlla che la sottoscrizione sia nel gruppo delle sottoscrizioni
Assicurati che l'identificatore del pacchetto corrisponda a quello di App Store Connect
Attendi 2-3 ore dopo aver creato il prodotto

Non è possibile inviare la sottoscrizione:

Completa tutti i campi obbligatori (nome, descrizione, prezzo)
Aggiungi almeno una localizzazione
Verifica che le informazioni bancarie/tributarie siano approvate
Verifica la prima sottoscrizione (richiede versione dell'app)

Disabilitato il toggle di condivisione della famiglia:

Già abilitato (non può essere disabilitato)
Verifica i dettagli della sottoscrizione
Contatta il Supporto Apple se rimani bloccato

Livello di prezzo non disponibile:

Potrebbe essere limitato in alcune aree geografiche
Scegli un livello alternativo
Contatta Apple per domande di prezzo

Errore "ID del prodotto non valido":

Deve essere nel formato del dominio inverso
Non può contenere spazi o caratteri speciali
Verifica la presenza di errori di ortografia
Verifica l'unicità su tutti i prodotti

Passaggi successivi

Crea un'offerta introduttiva per attirare nuovi sottscriventi
Configura piani di fatturazione mensili per merce per offerte di abbonamento annuale supportate
Configura il testing del sandbox per testare le tue sottscrizioni
Configura offerte promozionali per il win-back e la retention
Implementa la tracciatura delle analisi delle sottscrizioni

Risorse aggiuntive

Per ulteriori informazioni, si rinvia al documentazione ufficiale di Apple sulle sottoscrizioni auto-rinnovabili.