Create iOS Auto-Renewable Subscription

Eine Einrichtungsvoreinstellung mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin kopieren.

Automatisch wiederkehrende Abonnements bieten wiederkehrenden Zugriff auf Inhalte, Dienste oder Premiumfunktionen in Ihrer iOS-App. Diese Anleitung führt Sie durch die Erstellung von Abonnements in App Store Connect.

Übersicht

Automatisch wiederkehrende Abonnements verlängern sich automatisch am Ende jeder Abrechnungsperiode, bis die Benutzer abbrechen. Sie sind ideal für:

Premium-Inhalte und -Funktionen
Abonnement-freie Erfahrungen
Cloud-Speicher und -Synchronisierung
Streaming-Dienste
Professionelle Werkzeuge und -hilfsmittel

Voraussetzungen

Bevor Sie Abonnements erstellen, müssen Sie:

Eine Abonnement-Gruppe erstellen um Ihre Abonnements zu organisieren
Eine aktive Mitgliedschaft im Apple Developer Programm haben
Bank- und Steuerinformationen in App Store Connect abgeschlossen haben

Ein Abonnement erstellen

Zum Abonnementsbereich navigieren

In App Store Connect, wählen Sie Ihr App und gehen Sie zu Monetize > Abonnements.

Wählen Sie Ihre Abonnementgruppe oder erstellen Sie eine neue, wenn erforderlich.
Neues Abonnement erstellen

Klicken Sie auf das + Symbol neben Ihrer Abonnementgruppe, um ein neues Abonnement hinzuzufügen.
Eingabe von Grundinformationen

Referenzname: Benennung für Ihre interne Verwendung (nicht für Kunden sichtbar)
- Beispiele: „Premium monatlich“, „Ultimate jährlich“, „Basic-Plan“
Produkt-ID: Eindeutige Identifikationsnummer für diese Abonnement (kann später nicht geändert werden)
- Format: com.yourcompany.yourapp.premium_monthly
- Verwenden Sie beschreibende, kleine Buchstaben mit Unterstrichen benannte Namen
- Für die Konfiguration des native-purchases-Plugins erforderlich
Konfiguration der Laufzeit

Wählen Sie die Abonnementdauer aus den verfügbaren Optionen:
- 1 Woche
- 1 Monat
- 2 Monate
- 3 Monate
- 6 Monate
- 1 Jahr
Die Dauer bestimmt, wie oft Benutzer abgerechnet werden.
Preisplan einrichten

Klicken Sie Abonnementpreis hinzufügen Um die Preise zu konfigurieren:

Herkunftsland: Wählen Sie Ihr Hauptmarkt (üblicherweise Ihr Land)

Preis: Setzen Sie den Abonnementpreis
- Apple konvertiert automatisch in andere Währungen
- Wählen Sie aus Apple’s Preisstufen
- Betrachten Sie den wahrgenommenen Wert und die Marktpreise
Familienfreigabe (Optional)

Beschließen Sie, ob die Familienfreigabe aktiviert werden soll, die bis zu 6 Familienmitgliedern Zugriff auf die Abonnement ermöglicht.

Wenn die Familienfreigabe aktiviert wird, kann sie für dieses Produkt nicht mehr deaktiviert werden.

Aktivieren Sie, wenn:
- Der Inhalt ist für die Familienfreigabe geeignet
- Sie möchten den Wertvorschlag erhöhen
- Ihr Geschäftsmodell unterstützt dies
Aktivieren Sie nicht, wenn:
- Abonnement gilt nur für den einzelnen Gebrauch
- Der Inhalt wird dem Benutzer angepasst
- Sie möchten die Einnahmen pro Benutzer maximieren
Hinzufügen von Lokalisierungen

Fügen Sie Informationen zum Abonnement in allen Sprachen ein, die Ihre App unterstützt:

Abonnement-Bezeichnung: Kundenfassende Bezeichnung (z.B. "Premium Monatlich")

Beschreibung: Kurze Beschreibung dessen, was das Abonnement umfasst
- Halten Sie es knapp und fokussieren Sie sich auf Vorteile
- Erwähnen Sie wichtige Funktionen
- Hervorheben Sie den Vorteil
App Store-Präsentationsbild (optional)

Hochladen Sie ein Präsentationsbild für diese Abonnement (312x390 Pixel):
- Zeigt sich auf der App Store-Abonnementseite
- Stimmt mit der Design Ihres Apps überein
- Bezeichnen Sie den Abonnementnamen für Klarheit
Während Bilder optional für die erste Einreichung sind, sind sie für die Präsentation im App Store erforderlich. Sie können sie später hinzufügen.
Speichern und Einreichen

Klicken Speichern um die Abonnement zu erstellen.

Für Erstes Abonnement:
- Muss mit einer neuen App-Version eingereicht werden
- In Ihrer nächsten App-Store-Einreichung enthalten
- Kann nicht unabhängig eingereicht werden
Für nachfolgende Abonnements:
- Kann direkt von der Abonnements-Seite eingereicht werden
- Brauchen keine neue App-Version
- Verfügbar nach Genehmigung des ersten Abonnements

Abonnement-Status

Ihr Abonnement wird eine dieser Status haben:

Status	Beschreibung	Kann getestet werden?
Mangelnde Metadaten	Unvollständige Einrichtung	Ja (Sandbox)
Bereit zum Einreichen	Vollständig, aber nicht eingereicht	Ja (Sandbox)
Wartet auf die Überprüfung	Eingereicht bei Apple	Ja (Sandbox)
In Review	Von Apple geprüft	Ja (Sandbox)
Genehmigt	Verfügbar zum Kauf	Ja
Abgelehnt	Änderungen erforderlich	Ja (Sandbox)

In Ihrer App verwenden

Nach der Erstellung verweisen Sie auf die Abonnement in Ihrer App mit der Produkt-ID:

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

Monatlich mit 12-Monats-Zusagen

Wenn Ihr App Store Connect-Abonnement mit einem monatlichen Abrechnungsplan und einer 12-monatigen Zusage konfiguriert ist, kann StoreKit zusätzliche Preisbegriffe für das Produkt zurückgeben. Verwenden Sie diese Begriffe, um die monatliche Gebühr, die Gesamtkommitmentpreis und die volle Kommitmentdauer vor dem Kauf anzuzeigen.

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

Für die vollständige Paywall- und Berechtigungsablauf, sehen Sie iOS-Monatskommitment-Abrechnungspläne.

Gute Praktiken

Preisstrategie

MonatspläneGeringere Eingangsbarriere, Bildung von Gewohnheiten
JahrespläneBessere Wertigkeit, höhere Kundenwert, geringere Abwanderung
MehrfachstufenGrund, Premium, Ultimate für verschiedene Nutzersegmente
WettbewerbsanalyseForschung ähnlicher Apps zur Preisgestaltung

Produkt-IDs

Benutze konsistente Namensgebung: company.app.tier_duration
Fügen Sie Stufe und Dauer in die ID ein: premium_monthly, ultimate_annual
Ändern Sie die Produkt-IDs nicht (sie sind dauerhaft)
Dokumentieren Sie alle Produkt-IDs für Ihr Team

Aktivieren Sie für familienorientierte Apps (Spiel, Bildung, Unterhaltung)
Berücksichtigen Sie den Einfluss auf den Umsatz
Testen Sie das Teilen von Verhalten gründlich
Kommunizieren Sie die Teilerfähigkeit in der Werbung

Lokalisierung

Übersetzen Sie alle Abonnementnamen und Beschreibungen
Berücksichtigen Sie regionale Preisunterschiede
Testen Sie die Anzeige in allen unterstützten Sprachen
Verwenden Sie marktorientierte Werbebotschaften

Vorabdrucke

Halten Sie einen konsistenten visuellen Stil
Inkludieren Sie den Abonnementnamen und das Hauptvorteil
Aktualisieren Sie für saisonale Aktionen
Passen Sie sich an die Gesamtdesignsprache der App an

Gemeinsame Abonnementmuster

Ein-Tier (Freemium)

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

Mehrbändiger (Gut, Besser, Bestes)

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

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

Verbrauchbar + Abonnement-Hybrid

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

Fehlersuche

Abonnement wird in der App nicht geladen:

Überprüfen Sie, ob der Produkt-ID genau (fallweise) übereinstimmt
Überprüfen Sie, ob die Abonnementgruppe in der Abonnementsgruppe ist
Stellen Sie sicher, dass die Bundle-Identifikationsnummer der App Store Connect entspricht
Warten Sie 2-3 Stunden nach der Erstellung des Produkts

Kann kein Abonnement einreichen:

Füllen Sie alle erforderlichen Felder (Name, Beschreibung, Preis) aus
Fügen Sie mindestens eine Lokalisierung hinzu
Überprüfen Sie, ob die Bank-/Steuerinformationen genehmigt sind
Überprüfen Sie, ob das erste Abonnement (erfordert App-Version) vorhanden ist

Familienfreigabe-Toggle deaktiviert:

Bereits aktiviert (kann nicht deaktiviert werden)
Überprüfen Sie die Abonnementdetails
Kontaktieren Sie den Apple-Support, wenn Sie stecken bleiben

Preisstufe nicht verfügbar:

Kann in einigen Gebieten eingeschränkt sein
Wählen Sie eine alternative Stufe
Kontaktieren Sie Apple für Fragen zu den Preisen

“Fehler bei der Produkt-ID”:

Must be reverse domain format
Kann nicht Leerzeichen oder Sonderzeichen enthalten
Überprüfen Sie auf Tippfehler
Überprüfen Sie die Eindeutigkeit in allen Produkten

Zukünftige Schritte

Einführungsbasisangebot erstellen um neue Abonnenten anzuziehen
Monatsverpflichtung für Warenlieferungen für unterstützte Jahresabonnementangebote
Sandbox-Testkonfiguration um Ihre Abonnements zu testen
Wiedergewinn- und Verbleibsbasisangebote einrichten
Abonnement-Analyse-Tracking implementieren

Zusätzliche Ressourcen

Zur weiteren Information wenden Sie sich an die offizielle Apple-Dokumentation zu automatisch wiederholbaren Abonnements.

Bleiben Sie bei der Erstellung von iOS Auto-Renewable Abonnements

Wenn Sie Erstellung von iOS Auto-Renewable Abonnements für die Planung der Genehmigung 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-review für die Implementierungsdetails in @capgo/capacitor-in-app-review, Mit @capgo/capacitor-in-app-review für die native Fähigkeit in Mit @capgo/capacitor-in-app-review, @capgo/capacitor-native-market 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.