Vai al contenuto

Linee guida di revisione dell'App Store iOS per IAP

GitHub

Ottenere l'approvazione della tua app sull'App Store richiede un'attenzione scrupolosa alle linee guida di Apple, soprattutto quando si implementano acquisti in-app e abbonamenti. Questa guida copre tutto ciò che devi sapere per superare la revisione al primo invio.

Processo di revisione dell'App Store iOS

Prima che Apple revisioni il tuo flusso di acquisto, assicurati che la scheda dell'app sia completa:

  • Aggiungi un URL della Privacy Policy in App Store Connect
  • Aggiungi un URL di supporto che rimandi a informazioni di contatto reali per gli utenti
  • Completa la age rating questionario per rendere l'app pubblicabile
  • Aggiungi Contatti per la revisione dell'app e note chiare per i revisori
  • Se è richiesto il login, fornisci un account demo che non scade durante la revisione
Metadati della scheda App Store con link a policy e supporto
  • Usa gli screenshot attuali della build reale in fase di revisione
  • Per iPhone, 1290 x 2796 (6.7 pollici) è la dimensione predefinita più semplice
  • Se la tua app gira su iPad, carica anche gli screenshot per iPad
  • Le dimensioni iPad più grandi attualmente accettate includono 2064 x 2752 (13 pollici) e 2048 x 2732 (12.9 pollici)
  • Non allargare gli screenshot dell’iPhone per simulare il supporto iPad

Esegui esattamente il percorso che Apple seguirà su un dispositivo reale:

  • Installa l’ultima build da TestFlight
  • Accedi con l’account di revisione che prevedi di fornire
  • Raggiungi il paywall senza gesti nascosti o menu di debug
  • Completa i flussi di acquisto, ripristino e gestione dell’abbonamento
  • Verifica che l’app si comporti correttamente se i permessi vengono negati

Apple richiede una chiara informativa sui prezzi prima di qualsiasi acquisto:

Elementi obbligatori:

  • Mostra il prezzo esatto prima del pulsante di acquisto
  • Indica la frequenza di fatturazione (es. “9,99 €/mese”)
  • Specifica chiaramente cosa ottengono gli utenti per il loro denaro
  • Indica quando avverranno gli addebiti

Rifiuto comune:

“I prezzi dell’abbonamento devono essere chiari e trasparenti.”

:::caution Coerenza dei prezzi Tutti i prezzi devono corrispondere tra:

  • Metadati dell’elenco su App Store
  • Schermate di acquisto in-app
  • Schermate di gestione abbonamenti

Anche una discrepanza di soli 1 $ tra la scheda dello store ($4,99) e l'app ($5,99) causerà il rifiuto automatico.

Informativa obbligatoria:

  • Tutti i livelli di abbonamento disponibili mostrati insieme
  • Confronto chiaro delle feature per ogni livello
  • Nessuna preselezione automatica dei piani premium tramite trucchi di UI
  • Istruzioni di cancellazione facili da trovare

Cosa fare e non fare nel design della UI

Paywall con ripristino acquisti e link legali

Esempio di UI conforme:

import { NativePurchases } from '@capgo/native-purchases';
function SubscriptionScreen() {
return (
<div>
<h2>Choose Your Plan</h2>
{/* Show all tiers equally */}
<PlanCard
title="Basic"
price="$4.99/month"
features={['Feature A', 'Feature B']}
/>
<PlanCard
title="Premium"
price="$9.99/month"
features={['All Basic', 'Feature C', 'Feature D']}
highlighted={false} // Don't force premium
/>
{/* Clear cancellation info */}
<Text>
Cancel anytime in Settings > Subscriptions.
No refunds for partial periods.
</Text>
</div>
);
}

Implementazione obbligatoria:

Ogni app con IAP deve offrire un modo per ripristinare gli acquisti precedenti senza contattare il supporto.

import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function restorePurchases() {
try {
await NativePurchases.restorePurchases();
const { purchases } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.SUBS,
});
const activeSub = purchases.find(
(purchase) => purchase.isActive && purchase.expirationDate,
);
if (activeSub) {
unlockPremiumFeatures();
showMessage('Purchases restored successfully!');
return;
}
const { purchases: iaps } = await NativePurchases.getPurchases({
productType: PURCHASE_TYPE.INAPP,
});
const hasIap = iaps.some((purchase) => purchase.productIdentifier === 'premium_unlock');
showMessage(
hasIap ? 'Premium purchase restored!' : 'No previous purchases found.',
);
} catch (error) {
showError('Failed to restore purchases. Please try again.');
}
}
// Add a visible "Restore Purchases" button
<Button onClick={restorePurchases}>
Restore Purchases
</Button>

1. Crash dell'app o funzionalità non funzionanti

Sezione intitolata “1. Crash dell'app o funzionalità interrotte”

Perché viene rifiutato:

  • L'app va in crash all'avvio
  • Il flusso di acquisto non si completa
  • Le funzionalità mostrate negli screenshot non funzionano

Prevenzione:

  • Testa su dispositivi reali (non solo simulatori)
  • Testa tutti i flussi di abbonamento end-to-end
  • Verifica che la validazione dei receipt funzioni
  • Controlla la gestione degli errori di rete

Perché viene rifiutato:

  • Gli screenshot mostrano funzionalità non presenti nella build attuale
  • La descrizione menziona funzionalità che non esistono
  • Il prezzo nei metadati non corrisponde a quello in-app

Checklist dei metadati

Prevenzione:

// Document exactly what's in each tier
const SUBSCRIPTION_FEATURES = {
basic: ['Ad-free', 'Cloud sync', 'Basic themes'],
premium: ['Ad-free', 'Cloud sync', 'All themes', 'Priority support']
};
// Use these in both your app AND App Store description

Perché viene rifiutato:

  • Richiedere fotocamera/posizione/salute senza spiegazione
  • Richieste di permessi nascoste dopo varie schermate
  • Descrizioni dei permessi vaghe o generiche

Prevenzione:

Aggiorna il tuo Info.plist con spiegazioni chiare:

Testo dei permessi troppo vago per la revisione Testo dei permessi con spiegazioni più chiare
<key>NSCameraUsageDescription</key>
<string>Camera access is needed to scan product barcodes for quick subscription upgrades.</string>
<key>NSLocationWhenInUseUsageDescription</key>
<string>Location helps us show relevant local content in your Premium subscription.</string>

Perché viene rifiutato:

  • Affermazioni come “#1 app al mondo” senza prove
  • Funzionalità “illimitate” con limiti nascosti
  • Tattiche di falsa urgenza (“Solo 2 posti rimasti!”)

Linee guida Descrizione Esempi

Linee guida aggiuntive per la descrizione

Prevenzione:

  • Sii specifico e fattuale nelle descrizioni
  • Evita superlativi senza prove
  • Non esercitare pressioni con scarsità fittizia

Perché viene rifiutato:

  • Nessun riferimento a come annullare
  • Pulsante di annullamento nascosto o oscurato
  • Processo di annullamento multipasso senza il flusso nativo di Apple

Prevenzione:

// Always inform users about cancellation
function SubscriptionInfo() {
return (
<div>
<h3>How to Cancel</h3>
<ol>
<li>Open iPhone Settings</li>
<li>Tap your name at the top</li>
<li>Tap Subscriptions</li>
<li>Select this app and tap Cancel</li>
</ol>
<p>Or manage directly in the App Store app.</p>
<Button onClick={openSubscriptionManagement}>
Manage Subscription in Settings
</Button>
</div>
);
}
async function openSubscriptionManagement() {
// Direct link to iOS subscription management
await NativePurchases.showManageSubscriptions();
}

Apple ha notevolmente inasprito i requisiti di privacy nel 2025.

Per ogni autorizzazione:

  1. Perché ti serve (caso d'uso specifico)
  2. Quando verrà utilizzata
  3. Come i dati vengono salvati/condivisi
  4. Se è facoltativa o obbligatoria
async function requestCameraPermission() {
// Show explanation BEFORE requesting
await showDialog({
title: 'Camera Access',
message: 'We need camera access to let you scan barcodes for quick product lookup. Your photos are never uploaded or stored.',
buttons: ['Not Now', 'Allow']
});
// Then request permission
const result = await Camera.requestPermissions();
return result.camera === 'granted';
}

Assicurati che le etichette di privacy di App Store riflettano accuratamente:

  • Raccolta della cronologia acquisti
  • Indirizzi email (per le ricevute)
  • ID dispositivo (per la prevenzione delle frodi)
  • Dati di utilizzo (per l'analisi)

Etichette privacy imprecise sono una delle cause di rifiuto più comuni nel 2025. Verifica attentamente la raccolta dei dati.

Checklist pre-invio

  1. Testa tutti i flussi di acquisto

    • Acquista ogni livello di abbonamento
    • Testa i periodi di prova gratuiti
    • Verify introductory offers apply correctly
    • Testa la funzionalità di ripristino
    • Verifica la Family Sharing (se abilitata)
    • Testa su più dispositivi
  2. Verifica la coerenza dei prezzi

    • Verifica che i metadati dell'App Store corrispondano ai prezzi in-app
    • Verifica che tutte le valute siano corrette
    • Verifica che la durata dei trial gratuiti corrisponda alle descrizioni
    • Verifica che i termini dell'offerta introduttiva siano accurati
  3. Rivedi tutti i testi

    • Rimuovi il testo segnaposto
    • Verifica che le affermazioni siano verificabili
    • Controlla grammatica e ortografia
    • Ensure descriptions match current build
    • Rimuovi i riferimenti ai concorrenti
  4. Testa le autorizzazioni

    • Richiedi solo le autorizzazioni necessarie
    • Mostra spiegazioni chiare prima della richiesta
    • Testa i flussi “Rifiuta” (l'app deve comunque funzionare)
    • Verifica che le descrizioni in Info.plist siano chiare
  5. Prepara un account di test

    • Crea un account di revisione che resti valido durante la revisione
    • Documenta le credenziali di accesso nelle informazioni di App Review
    • Verifica che il revisore possa raggiungere il paywall e completare il flusso di acquisto
    • Includi account aggiuntivi o switch specifici dell'app nel campo Note se necessario
  6. Controlla i metadati

    • Le screenshot corrispondono all'UI attuale
    • L'URL di supporto include informazioni di contatto reali
    • L'URL della privacy policy è compilato
    • La classificazione per età corrisponde ai contenuti del build
    • Il video di anteprima dell'app (se presente) mostra la versione attuale
    • La descrizione descrive accuratamente le funzionalità
    • La policy sulla privacy è accessibile nell'app e dalla scheda dello store
  7. Scrivi note di revisione dettagliate

    Contact:
    Name: Jane Developer
    Email: review@yourapp.com
    Phone: +1 555-0100
    Test Account:
    Email: reviewer@test.com
    Password: TestPass123!
    This account does not expire during review.
    Testing Instructions:
    1. Log in with test account above
    2. Tap "Upgrade to Premium" button
    3. Select "Monthly Premium" subscription
    4. Complete purchase (no charge in sandbox)
    5. Verify premium features unlock
    Note: Subscription pricing is clearly shown before purchase.
    Cancellation instructions are in Settings > Account.

Tempistiche di revisione App Store

Revisione standard: 24-48 ore Periodi di picco: 3-5 giorni (rilasci festivi su App Store) Fine settimana: Nessuna revisione elaborata Revisione accelerata: Disponibile per correzioni di bug critici (richiesta tramite App Store Connect)

Stati comuni che vedrai in App Store Connect:

  • Waiting for Review
  • In Review
  • Pending Developer Release
  • Rejected

1. Chiarezza degli abbonamenti

  • Confronto affiancato dei piani richiesto
  • Nessun “dark pattern” che nasconda opzioni più economiche
  • Percorsi di downgrade/upgrade chiari

2. Accuratezza dei metadati

  • Gli screenshot devono corrispondere alla build in revisione
  • Sono richiesti screenshot per iPad se il supporto iPad è attivo
  • L'URL di supporto e la privacy policy devono essere già online prima dell'invio

3. Qualità della privacy e dei dettagli di revisione

  • Le informative privacy devono corrispondere a ciò che gli SDK raccolgono davvero
  • I contatti e le note per l'App Review devono essere completi già al primo invio
  • Le credenziali demo devono rimanere valide per tutta la durata della revisione

4. Preparazione all'invio

  • Apple aggiorna regolarmente i requisiti minimi di SDK, quindi verifica la scadenza attuale prima di caricare una release build
  • TestFlight è il modo più sicuro per verificare il percorso esatto del revisore prima dell'invio
import { NativePurchases, PURCHASE_TYPE } from '@capgo/native-purchases';
async function handlePurchase(productId: string) {
try {
const transaction = await NativePurchases.purchaseProduct({
productIdentifier: productId,
productType: PURCHASE_TYPE.SUBS,
});
// Success
await validateReceiptOnServer(transaction.receipt);
showSuccess('Subscription activated!');
unlockFeatures();
} catch (error: any) {
// Handle specific error cases
if (error.code === 'USER_CANCELLED') {
// User cancelled - don't show error
console.log('Purchase cancelled by user');
} else if (error.code === 'PAYMENT_PENDING') {
showInfo('Payment is pending. Please check back later.');
} else if (error.code === 'PRODUCT_ALREADY_PURCHASED') {
// Restore instead
await NativePurchases.restorePurchases();
} else {
// Show user-friendly error
showError('Unable to complete purchase. Please try again.');
}
}
}
function PurchaseButton({ productId }: { productId: string }) {
const [loading, setLoading] = useState(false);
const handlePurchase = async () => {
setLoading(true);
try {
await NativePurchases.purchaseProduct({ productIdentifier: productId });
} finally {
setLoading(false);
}
};
return (
<button onClick={handlePurchase} disabled={loading}>
{loading ? 'Processing...' : 'Subscribe Now'}
</button>
);
}
function SubscriptionTerms() {
return (
<div className="terms">
<p>
Subscription automatically renews unless cancelled at least 24 hours
before the end of the current period.
</p>
<p>
Your account will be charged for renewal within 24 hours prior to
the end of the current period.
</p>
<p>
Subscriptions may be managed by the user and auto-renewal may be
turned off in Account Settings after purchase.
</p>
<p>
<a href="/terms">Terms of Service</a> |
<a href="/privacy/">Privacy Policy</a>
</p>
</div>
);
}
  1. Leggi attentamente il rifiuto

    • Annota la specifica linea guida citata (es. 3.1.1, 5.1.1)
    • Comprendi esattamente cosa ha segnalato Apple
  2. Correggi il problema in modo approfondito

    • Non solo patch: risolvilo alla radice
    • Testa la correzione in modo approfondito
    • Documenta ogni modifica apportata
  3. Rispondi nel Resolution Center

    Thank you for your feedback. I have addressed the issue:
    Issue: Subscription pricing not clear upfront
    Fix: Added explicit pricing display on subscription selection
    screen showing "$9.99/month" before purchase button. Also added
    cancellation instructions on the same screen.
    The changes are in this submission and can be tested using the
    provided test account.
  4. Ripresenta subito

    • Le nuove submission vengono riviste più in fretta
    • In genere entro 24 ore

Se ritieni che il rifiuto sia errato:

Procedura di chiarimento App Store

  1. Clicca su “Appeal” in App Store Connect
  2. Fornisci prove chiare:
    • Screenshot che dimostrano la conformità
    • Riferimenti a linee guida specifiche
    • Spiegazione di come soddisfi i requisiti
  3. Sii professionale e concreto
  4. Includi un account di test se la funzionalità è difficile da trovare

Esempio di richiesta di documenti

Se riscontri ancora problemi:

Hai difficoltà con la revisione dell'app o ti serve assistenza personalizzata? Prenota una call di consulenza con il nostro team per un supporto dedicato su:

  • Revisione e ottimizzazione dell'implementazione IAP
  • Preparazione e strategia per la revisione dell'App Store
  • Revisione della checklist di invio
  • Risoluzione dei rifiuti e appelli
  • Test e validazione completi

I nostri esperti hanno aiutato centinaia di app a superare la revisione!

Continua dalle linee guida per la revisione dell'App Store iOS per IAP

Sezione intitolata “Continua dalle linee guida per la revisione dell'App Store iOS per IAP”

Se stai usando Linee guida per la revisione dell'App Store iOS per IAP 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.