Zum Inhalt springen

iOS App Store Review Guidelines für IAP

GitHub

Um Ihre App im App Store zu genehmigen, ist eine sorgfältige Beachtung der Richtlinien von Apple erforderlich, insbesondere bei der Implementierung von In-App-Käufen und Abonnements. Diese Anleitung deckt alles ab, was Sie wissen müssen, um die Überprüfung auf Ihrem ersten Einreichungsversuch zu bestehen.

iOS App Store-Bewertungsprozess

App Store Connect-Einrichtung abschließen

Abschnitt: App Store Connect-Einrichtung abschließen

Bevor Apple Ihren Kaufprozess überprüft, stellen Sie sicher, dass das App-Record selbst vollständig ist:

  • Hinzufügen von Datenschutzrichtlinien-URL in App Store Connect
  • Hinzufügen von Support-URL die auf reale Kontaktinformationen für Benutzer führt
  • Abschluss des Altersangaben-Fragebogens damit die App veröffentlicht werden kann
  • Hinzufügen Kontaktinformationen für App-Bewertungen und klare Notizen für den Rezensenten
  • Wenn ein Login erforderlich ist, stellen Sie ein __CAPGO_KEEP_0__ Konto bereit, das während der Überprüfung nicht abläuft
App Store-Liste mit Richtlinien und Support-Links
  • Verwenden Sie aktuelle Bildschirmfotos aus dem tatsächlichen Build, der zur Überprüfung steht
  • Für iPhone 1290 x 2796 ist die einfachste Standardgröße
  • Wenn Ihre App auf iPad läuft, laden Sie auch iPad-Bildschirme hoch
  • Aktuell akzeptierte große iPad-Größen umfassen 2064 x 2752 und 2048 x 2732 12,9 Zoll
  • Stretchen Sie iPhone-Bildschirme nie, um eine iPad-Unterstützung vorzutäuschen

Durchführen Sie einen Trockentest der Rezensionsreise in TestFlight

Abschnitt mit dem Titel „Durchführen Sie einen Trockentest der Rezensionsreise in TestFlight“

Folgen Sie dem genauen Weg, den Apple auf einem realen Gerät verfolgt:

  • Installieren Sie die neueste Version aus TestFlight
  • Melden Sie sich mit dem Rezensionskonto an, das Sie bereitstellen möchten
  • Den Paywall ohne versteckte Gesten oder Debug-Menüs erreichen
  • Kaufabwicklung, Wiederherstellung und Verwaltung von Abonnement-Flüssen
  • Überprüfen, ob die App korrekt verhält, wenn die Berechtigungen verweigert werden

Apple erfordert eine klare Preisoffenlegung vor jedem Kauf:

Pflichtelemente:

  • Den genauen Preis vor dem Kaufbutton anzeigen
  • Die Abrechnungsperiode (z.B. „$9,99/Monat“) anzeigen
  • Was die Benutzer für ihr Geld erhalten, klarstellen
  • Zeitpunkt der Gebührenanforderung angeben

Häufige Ablehnung:

"Die Abonnementpreise müssen klar und vorhersehbar sein."

:::Vorsicht Preis-Konsistenz Alle Preise müssen übereinstimmen in:

  • App Store-Metadaten-Liste
  • Anwendungskaufschirm
  • Abonnementsverwaltungsschirm

Even ein $1-Disparitäten zwischen dem Store-Liste ($4,99) und der App ($5,99) wird automatische Ablehnung auslösen. :::

Zwingende Offenlegungen:

  • Alle verfügbaren Abonnementebenen werden zusammen angezeigt
  • Klare Vergleichbarkeit von Funktionen pro Ebene
  • Keine automatische Umstellung auf Premium-Ebenen durch UI-Tricks
  • Einfach zu lokalisierende Abbestellungsanweisungen

UI-Design-Dos und Don'ts

Paywall mit Wiederherstellung von Kaufleistungen und rechtlichen Links

Beispiel für eine konforme UI:

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>
);
}

Erforderliche Implementierung:

Jedes App mit IAP muss eine Möglichkeit bieten, den Nutzer dabei zu unterstützen, seine vorherigen Kaufleistungen ohne Unterstützung wiederherzustellen.

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>

Warum es scheitert:

  • Die App stürzt beim Start ab
  • Der Kaufprozess schlägt fehl
  • Die in den Screenshots gezeigten Funktionen funktionieren nicht

Verhütung:

  • Testen Sie die App auf echten Geräten (nicht nur auf Simulatoren)
  • Testen Sie alle Abonnement-Flüsse von Anfang bis Ende
  • Überprüfen Sie, ob die Erhaltung von Belegen funktioniert
  • Überprüfung von Netzwerkfehlerbehandlungen

Warum es scheitert:

  • Bildschirme zeigen Funktionen, die nicht im aktuellen Build enthalten sind
  • Beschreibung erwähnt Funktionen, die nicht existieren
  • Preise im Metadaten unterscheiden sich von den in-app-Preisen

Metadaten-Checkliste

Vorbeugung:

// 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

Warum es scheitert:

  • Kamera/Ort/Gesundheitszugriff ohne Erklärung anfordern
  • Zustimmungsanfragen in mehreren Bildschirmen tief
  • Vage oder allgemeine Zustimmungsbeschreibungen

Verhütung:

Aktualisieren Sie Ihren Info.plist mit klaren Erklärungen:

Zustimmungsbeschreibung, die für eine Überprüfung zu vage ist Zustimmungsbeschreibung mit klaren Erklärungen
<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>

Why It Fails:

  • Falsche Behauptungen wie “Nummer 1-App in der Welt” ohne Beweise
  • “Unbegrenzte” Funktionen mit versteckten Grenzen
  • Falsche Dringlichkeitsstrategien (“Nur noch 2 Plätze frei!”)

Beschreibungsleitfaden Beispiele

Zusätzliche Beschreibungsleitfaden

Prävention:

  • Seien Sie spezifisch und faktenbasiert in Beschreibungen
  • Vermeiden Sie Superlativen ohne Beweise
  • Drängen Sie die Benutzer nicht mit falscher Knappheit

Why es scheitert:

  • Keine Anweisung, wie man abbestellt
  • Stornierungs-Button versteckt oder behindert
  • Multi-Schritt-Stornierungsprozess ohne Apple’s nativen Flow

Prävention:

// 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 hat die Datenschutzanforderungen 2025 erheblich verschärft.

Für jede Genehmigung:

  1. Warum Sie es benötigen (spezifischer Einsatzfall)
  2. Wann es verwendet wird
  3. Wie Daten gespeichert/ geteilt werden
  4. Ob es optional oder erforderlich ist
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';
}

Stellen Sie sicher, dass Ihre App-Store-Datenschutzetiketten genau Folgendes widerspiegeln:

  • Sammeln von Kaufhistorien
  • E-Mail-Adressen (für Rechnungen)
  • Geräte-IDs (zur Vorbeugung von Betrugsfällen)
  • Verwendungsdaten (zur Analyse)

Unzutreffende Datenschutzbeschriftungen sind eine häufige Ablehnungsgrund in 2025. Überprüfen Sie Ihre Datenerfassung sorgfältig.

Vorab-Überprüfungsliste

  1. Alle Kaufabläufe testen

    • Jede Abonnementstufe kaufen
    • Freitriale testen
    • Einführungsangebote überprüfen
    • Wiederherstellungen von Kaufs testen
    • Familienfreundliche Funktion (wenn aktiviert) überprüfen
    • Testen auf mehreren Geräten
  2. Überprüfe Preisinkonsistenz

    • Überprüfe, ob App-Store-Metadaten mit den in-app-Preisen übereinstimmen
    • Überprüfe, ob alle Währungen korrekt sind
    • Bestätige, dass die Dauer der kostenlosen Testphase mit den Beschreibungen übereinstimmt
    • Überprüfe, ob die Bedingungen für Einführungsangebote genau sind
  3. Überprüfe alle Texte

    • Entferne Platzhaltertext
    • Überprüfe, ob alle Behauptungen überprüfbar sind
    • Überprüfe Rechtschreibung und Grammatik
    • Stelle sicher, dass Beschreibungen mit der aktuellen Version übereinstimmen
    • Entferne Erwähnungen von Konkurrenten
  4. Test Rechte

    • Verlangen Sie nur notwendige Berechtigungen
    • Zeigen Sie klare Erklärungen vor der Anfrage
    • Testen Sie 'Ablehnen'-Flüsse (die App sollte weiterhin funktionieren)
    • Überprüfen Sie, ob die Beschreibungen in Info.plist klar sind
  5. Vorbereiten Sie ein Testkonto

    • Erstellen Sie ein Rezensionskonto, das während der Rezension gültig bleibt
    • Dokumentieren Sie die Anmeldeinformationen in der App-Bewertungsinformation
    • Überprüfen Sie, ob der Rezensent den Paywall erreichen und den Kaufprozess abschließen kann
    • Beachten Sie in den Anmerkungen zusätzliche Konten oder App-spezifische Schalter, wenn erforderlich
  6. Überprüfen Sie die Metadaten

    • Die Screenshots entsprechen der aktuellen Benutzeroberfläche
    • Support-URL enthält echte Kontaktinformationen
    • Datenschutzrichtlinien-URL ist ausgefüllt
    • Alterseinstufung passt zum Inhalt im Build
    • App-Vorschau-Video (falls vorhanden) zeigt aktuelle Version
    • Beschreibung beschreibt genau die Funktionen
    • Datenschutzrichtlinien sind in der App und im Store-Listing zugänglich
  7. Schriftliche Notizen für detaillierte Bewertungen erstellen

    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.

Zeitlinie der Bewertungen

Zeitlinie der App-Store-Bewertungen

Standard-Bewertung:

Review Timeline 24-48 Stunden Hochbetriebszeiten: 3-5 Tage (Veröffentlichungen während der App Store-Holiday-Periode) Wochenenden: Keine Bewertungen verarbeitet Expedierter Review: Verfügbar für kritische Fehlerbehebungen (Anfrage über App Store Connect)

Gemeinsame Status, die Sie in App Store Connect sehen werden:

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

1. Abonnement-Klarheit

  • Seitliche Vergleiche von Tarifen erforderlich
  • Keine “ dunklen Muster” , die günstigere Optionen verbergen
  • Klare Ab- und Aufstiegswege

2. Metadaten-Accurazie

  • Bildschirmfotos müssen dem zu überprüfenden Build entsprechen
  • iPad-Bildschirmfotos sind erforderlich, wenn iPad-Unterstützung aktiviert ist
  • Support-URL und Datenschutzrichtlinie sollten bereits vor der Einreichung live sein

3. Datenschutz und Qualität der Rezensionsdetails

  • Datenübermittlungen müssen den tatsächlich von Ihren SDKs gesammelten Daten entsprechen
  • Kontaktinformationen und Notizen für die App-Überprüfung sollten bei der ersten Einreichung vollständig sein
  • Demo-Anmeldeinformationen müssen während der gesamten Überprüfungszeit gültig bleiben

4. Einreichereife

  • Apple updates minimum SDK requirements regularly, so confirm the current deadline before uploading a release build
  • TestFlight ist der sichere Ort, um den genauen Prüferweg vor der Einreichung zu überprüfen

Best Practices für den Native Purchases Plugin

Erfolgreiche Implementierung von Native Purchases Plugin

Proper Error Handling implementieren

Zur Zwischenablage kopieren
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. Die Ablehnung sorgfältig lesen

    • Die spezifische Richtlinie vermerken (z. B. 3.1.1, 5.1.1)
    • Genau verstehen, was Apple beanstandet
  2. Fixen Sie das Problem gründlich

    • Pflegen Sie nicht nur eine Reparatur - beheben Sie die Ursache
    • Testen Sie die Reparatur umfassend
    • Dokumentieren Sie, was Sie geändert haben
  3. Antworten Sie im 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. Wieder einreichen Sie schnell

    • Wieder einreichen ist in der Regel schneller geprüft
    • In der Regel innerhalb von 24 Stunden

Wenn Sie glauben, dass die Ablehnung falsch ist:

App Store Klarstellungsprozess

  1. Klicken Sie auf „Beschwerde“ in App Store Connect
  2. Bieten Sie klare Beweise:
    • Bildschirmdarstellungen, die die Einhaltung nachweisen
    • Verweise auf spezifische Richtlinien
    • Erklärung, wie Sie die Anforderungen erfüllen
  3. Seien Sie professionell und faktenbasiert
  4. Fügen Sie ein Testkonto hinzu, wenn die Funktion schwer zu finden ist

Beispiel für einen Antrag auf Unterlagen

Wenn Sie weiterhin Probleme haben:

Haben Sie Schwierigkeiten bei der App-Überprüfung oder benötigen Sie persönliche Unterstützung? Buchen Sie einen Beratungstermin mit unserem Team für eine dedizierte Unterstützung mit:

  • Überprüfung und Optimierung der IAP-Implementierung
  • Vorbereitung und Strategie für die App-Store-Überprüfung
  • Überprüfung des Einreichungschecklisten
  • Auflösung von Ablehnungen und Beschwerden
  • Vollständige Testung und Validierung

Unsere Experten haben bereits hunderte von Apps erfolgreich durch die Überprüfung gebracht!

Bleiben Sie bei den iOS App Store Review Richtlinien für IAP

Abschnitt mit dem Titel “Bleiben Sie bei den iOS App Store Review Richtlinien für IAP”

Wenn Sie iOS App Store Review Richtlinien für IAP zur Planung der Veröffentlichung und Verteilung im App Store verwenden, verbinden Sie es mit Mit @capgo/native-purchases für die native Fähigkeit in Mit @capgo/native-purchases, @capgo/capacitor-in-app-Bewertung für die Implementierungsdetail in @capgo/capacitor-in-app-Bewertung, Mit @capgo/capacitor-in-app-Bewertung für die native Fähigkeit in Mit @capgo/capacitor-in-app-Bewertung, @capgo/capacitor-native-Markt für die Implementierungsdetails in @capgo/capacitor-native-market, und Mit @capgo/capacitor-native-market für die native Fähigkeit in Mit @capgo/capacitor-native-market.