Erstellen Sie ein iOS-Auto-erneuerbares Abonnement

Kopieren Sie einen Einrichtungsbefehl mit den Installationsanweisungen und der vollständigen Markdown-Dokumentation für diesen Plugin.

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

Übersicht

Automatische Abonnementsautomatik verlängern sich automatisch am Ende jeder Abrechnungsperiode, bis die Nutzer abbrechen. Sie sind ideal für:

Premium-Inhalte und -Funktionen
Abonnementfreie Erfahrungen
Cloud-Speicher und -Synchronisation
Streaming-Dienste
Professionelle Werkzeuge und -Utilitäten

Voraussetzungen

Bevor Sie Abonnements erstellen, müssen Sie:

Ein Abonnementgruppe erstellen um Ihre Abonnements zu organisieren
Ein aktives Mitglied der Apple-Entwickler-Programm haben
Gesamte Bank- und Steuerinformationen in App Store Connect

Erstellung einer Abonnement

Navigieren Sie zu Abonnements

Gehen Sie in App Store Connect zu Ihrer App und wählen Sie Monetarisieren > Abonnements.

Wählen Sie Ihr Abonnement-Gruppe oder erstellen Sie eine neue, wenn erforderlich.
Erstellen Sie ein neues Abonnement

Klicken Sie auf das + Symbol neben Ihrer Abonnement-Gruppe, um ein neues Abonnement hinzuzufügen.
Geben Sie grundlegende Informationen ein

Bezugsnamen: Beschreibender Name für Ihre interne Verwendung (nicht für Kunden sichtbar)
- Beispiele: “Premium Monatlich”, “Ultimate Jahres”, “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-Namen mit Unterstrichen
- Erforderlich für die Konfiguration des native-purchases-Plugins
Konfigurieren Sie die Laufzeit

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

Klicken Abonnementpreis hinzufügen um die Preise zu konfigurieren:

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

Preis: Die Abonnementgebühr festlegen
- 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 das Abonnement ermöglicht.

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

Aktivieren Sie, wenn:
- Inhalt ist für die ganze Familie geeignet
- Sie möchten den Wert Ihrer Angebote erhöhen
- Ihr Geschäftsmodell unterstützt dies
Aktivieren Sie nicht, wenn:
- Die Abonnement ist nur für den Einzelnen gedacht
- Der Inhalt ist auf den Benutzer zugeschnitten
- Sie möchten die Einnahmen pro Benutzer maximieren
Hinzufügen von Lokalisierungen

Fügen Sie Anzeigeinformationen für Abonnements in allen Sprachen, die Ihre App unterstützt, hinzu:

Abonnement-BezeichnungKundenfassende Bezeichnung (z.B. "Premium Monatlich")

Beschreibung: Kurze Beschreibung dessen, was die Abonnement-Registrierung beinhaltet
- Halten Sie es knapp und fokussieren Sie sich auf Vorteile
- Nennen Sie wichtige Funktionen
- Hervorheben Sie den Wertvorschlag
App Store-Präsentationsbild (Optional)

Hochladen Sie ein Präsentationsbild für dieses Abonnement (312x390 Pixel):
- Zeigt sich auf der Abonnement-Seite im App Store
- Sollte dem Design Ihrer App entsprechen
- Beinhalten Sie den Abonnement-Namen für Klarheit
Während Bilder für die erste Einreichung optional sind, sind sie für die Präsentation im App Store erforderlich. Sie können sie später hinzufügen.
Speichern und Einreichen

Klicken Sie um die Abonnement zu erstellen. Für Erstes Abonnement:

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

Abonnement Status

Ihr Abonnement wird eine dieser Status haben:

Status	Beschreibung	Kann getestet werden?
Fehlende Metadaten	Unvollständige Einrichtung	Ja (Sandbox)
Bereit zum Einreichen	Vollständig, aber nicht eingereicht	Ja (Sandbox)
Wartet auf die Überprüfung	Gesendet an Apple	Ja (Sandbox)
In der Überprüfung	Wird von Apple überprüft	Ja (Sandbox)
Genehmigt	Verfügbar zum Kauf	Ja
Abgelehnt	Bedeutet Änderungen	Ja (Sandbox)

Verwendung in Ihrer App

Nach der Erstellung verweisen Sie auf das 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 Abonnement bei App Store Connect mit einem monatlichen Zahlungsplan und einer 12-monatigen Verpflichtung konfiguriert ist, kann StoreKit zusätzliche Preisbedingungen für das Produkt zurückgeben. Verwenden Sie diese Bedingungen, um die monatliche Gebühr, die Gesamtkommitmentpreise und die gesamte 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 Berechtigungsablaufanzeige siehe iOS-Monatsverpflichtungszahlungspläne.

Gute Praktiken

Preisstrategie

Monatspläne: Geringere Einstiegshürde, Bildung von Gewohnheiten
Jahrespläne: Bessere Wertigkeit, höherer LTV, geringere Kündigungsrate
Mehrere Ebenen: Grund, Premium, Ultimate für verschiedene Benutzersegmente
Wettbewerbsanalyse: Forschung zu Preisen ähnlicher Apps

Produkt IDs

Benutze konsistente Namen: company.app.tier_duration
Führe Tiers und Dauer in der ID ein: premium_monthly, ultimate_annual
Vermeide Änderungen an Produkt IDs (sie sind dauerhaft)
Dokumentiere alle Produkt IDs für dein Team

Aktiviere für apps mit familienorientierten Inhalten (Spiel, Bildung, Unterhaltung)
Überlege dir den Einfluss auf den Umsatz
Testen Sie das Teilen sorgfältig
Kommunizieren Sie die Fähigkeit zum Teilen in der Werbung

Lokalisierung

Übersetzen Sie alle Namen und Beschreibungen von Abonnements
Berücksichtigen Sie regionale Preisunterschiede
Testen Sie die Anzeige in allen unterstützten Sprachen
Verwenden Sie eine marktorientierte Werbesprache

Werbebilder

Halten Sie einen konsistenten visuellen Stil aufrecht
Inkludieren Sie den Namen des Abonnements und den Hauptvorteil
Aktualisierung für Saisonangebote
Übereinstimmung mit der Gesamtdesignsprache der App

Gemeinsame Abonnementmuster

Ein-Tier-Modell (Freemium)

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

Multi-Tier-Modell (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

Verbrauchbares + Abonnement-Hybridmodell

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

Fehlersuche

Abonnement lädt sich nicht in der App:

Überprüfen Sie, ob Produkt-ID genau (fallunterscheidend) übereinstimmt
Überprüfen Sie, ob Abonnement sich in Abonnementgruppe befindet
Stellen Sie sicher, dass Bundle-Identifier mit App Store Connect übereinstimmt
Warten Sie 2-3 Stunden nach 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 Bank-/Steuerinformationen genehmigt sind
Überprüfen Sie die erste Abonnement (erfordert App-Version)

Familienfreigabe-Toggle deaktiviert:

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

Preisstufe nicht verfügbar:

Möglicherweise in einigen Gebieten eingeschränkt
Wählen Sie eine alternative Stufe
Kontaktieren Sie Apple für Fragen zu Preisen

“Ungültige Produkt-ID”-Fehler:

Muss im umgekehrten Domänenformat sein
Kann nicht Leerzeichen oder Sonderzeichen enthalten
Tippsuche durchführen
Eindeutigkeit über alle Produkte überprüfen

Nächste Schritte

Einführungsgeschäft erstellen zum Anwerben neuer Abonnenten
Monatliche Verpflichtungsentgelte für Merchandise bereitstellen für unterstützte Jahresabonnementangebote
Sandbox-Testkonfiguration einrichten Ihre Abonnements zu testen
Gewinnrückgewinn- und Retentionsangebote einrichten
Abonnement-Analyse-Tracking implementieren

Zusätzliche Ressourcen

Für weitere Details, beziehen Sie sich auf die __CAPGO_KEEP_0__ offizielle Apple-Dokumentation zu automatischen wiederkehrenden Abonnements.