Create iOS Auto-Renewable Subscription

GitHub

Ein Setup-Vorschlag kopieren, der die Installationsanweisungen und die vollständige Markdown-Anleitung für diesen Plugin enthält.

Automatisch wiederkehrende 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

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

Premium-Inhalte und -Funktionen
Ad-freie Erfahrungen
Cloudspeicher und -synchronisation
Streaming-Dienste
Professionelle Werkzeuge und -hilfsmittel

Voraussetzungen

Bevor Sie Abonnements erstellen, müssen Sie:

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

Ein Abonnement erstellen

Zu Abonnements navigieren

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

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

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

Bezeichnung als Referenz: Benennung für Ihre internen Zwecke (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 mit Unterstrichen
- : Erforderlich für die Konfiguration des native-purchases-Plugins
: Konfiguration Dauer

: 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.
Preisfestlegung einrichten

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

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

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

Beschließen Sie, ob Sie Familienfreigabe aktivieren möchten, die bis zu 6 Familienmitgliedern ermöglicht, auf das Abonnement zuzugreifen.

Wenn Familienfreigabe aktiviert ist, 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 Wertevermittlung erhöhen
- Ihr Geschäftsmodell unterstützt dies
Deaktivieren Sie, wenn:
- Die Abonnement ist nur für den Einzelgebrauch bestimmt
- 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 das Abonnement in allen von Ihrer App unterstützten Sprachen hinzu:

Abonnement-Bezeichnung: Kundenzugängliche Bezeichnung (z. B. "Premium Monatlich")

: Kurze Beschreibung dessen, was das Abonnement umfasst: 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 Promotional Image (Optional)

Laden Sie ein Werbeprofil für diese Abonnement (312x390 Pixel):
- Zeigt sich auf der Abonnementseite im App Store
- Sollte dem Design Ihrer App entsprechen
- Beinhalten Sie den Namen des Abonnements für Klarheit
Während Bilder optional für die erste Einreichung sind, sind sie für die Werbedarstellung im App Store erforderlich. Sie können sie später hinzufügen.
Speichern und Absenden

Klicken Speichern um die Abonnement zu erstellen.

Für erste 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
- Keine neue App-Version erforderlich
- Verfügbar nach Genehmigung des ersten Abonnements

Abonnementstatus

Ihr Abonnement wird einen der folgenden 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	Eingereicht bei Apple	Ja (Sandbox)
In der Überprüfung	Von Apple überprüft	Ja (Sandbox)
Genehmigt	Verfügbar zum Kauf	Ja
Abgelehnt	Bedeutet Änderungen	Ja (Sandbox)

Verwendung in Ihrer App

Nachdem Sie das Abonnement erstellt haben, referenzieren Sie es 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 Zusage konfiguriert ist, kann StoreKit zusätzliche Preisbedingungen für das Produkt zurückgeben. Verwenden Sie diese Bedingungen, 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 Berechtigungsfunktion, sehen Sie sich das an iOS monatliche Verpflichtung Abrechnungspläne.

Best Practices

Preisstrategie

Monatspläne: Geringere Eingangsbarriere, Bildung von Gewohnheiten
Jahrespläne: Bessere Wertigkeit, höhere Kundenwert, geringere Kündigungsrate
Mehrfachstufen: Grund, Premium, Ultimate für verschiedene Benutzersegmente
Wettbewerbsanalyse: Forschung ähnlicher Apps’ Preise

Produkt IDs

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

Aktiviere für familienfreundliche Apps (Spiel, Bildung, Unterhaltung)
Überlege dir den Einfluss auf den Umsatz
Teste das Teilen sorgfältig
Kommunikation der Teilen-Fähigkeit in der Werbung

Lokalisierung

Übersetzen Sie alle Abonnementsnamen und -beschreibungen
Berücksichtigen Sie regionale Preisunterschiede
Testen Sie die Anzeige in allen unterstützten Sprachen
Verwenden Sie kulturell passende Werbeaussagen

Werbebilder

Halten Sie einen konsistenten visuellen Stil ein
Inkludieren Sie den Abonnementsnamen und das Hauptvorteil
Aktualisieren Sie für saisonale Aktionen
Matchen Sie die 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

Verbrauchbar + Abonnement-Hybrid

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

Fehlersuche

Abonnement lädt sich in der App nicht:

Überprüfen Sie, ob die Produkt-ID genau (fallunsensitiv) übereinstimmt
Überprüfen Sie, ob das Abonnement in einer Abonnementgruppe ist
Stellen Sie sicher, dass die Bundle-Identifizierungsnummer mit App Store Connect übereinstimmt
Warten Sie 2-3 Stunden nach der Erstellung des Produkts

Kann kein Abonnement einreichen:

Alle erforderlichen Felder (Name, Beschreibung, Preis) ausfüllen
Zumindest eine Lokalisierung hinzufügen
Überprüfen Sie, ob die Bank- und Steuerinformationen genehmigt sind
Überprüfen Sie, ob das erste Abonnement (erforderlich für die App-Version) vorhanden ist

Familienfreigabe-Toggle deaktiviert:

Bereits aktiviert (kann nicht deaktiviert werden)
Überprüfe die Abonnement-Daten
Kontaktiere den Apple-Support, wenn du stecken bleibst

Preisstufe nicht verfügbar:

Möglicherweise in einigen Gebieten eingeschränkt
Wähle eine alternative Stufe
Kontaktiere Apple für Fragen zu den Preisen

„Ungültiger Produkt-ID-Fehler“:

Muss im umgekehrten Domänenformat sein
Kann keine Leerzeichen oder Sonderzeichen enthalten
Überprüfe auf Tippfehler
Überprüfen Sie die Eindeutigkeit über alle Produkte hinweg

Nächste Schritte

Eine Einführungsangebot erstellen um neue Abonnenten anzuziehen
Monatliche Verpflichtung zur Abrechnung von Waren für unterstützte jährliche Abonnementangebote
Sandkasten-Testkonfiguration einrichten um Ihre Abonnements zu testen
Werbungsbereitschaft für Win-Back- und Retentionsangebote einrichten
Abonnement-Analyse-Tracking implementieren

Zusätzliche Ressourcen

Weitere Informationen finden Sie in der offiziellen Apple-Dokumentation zu automatisch wiederkehrenden Abonnements.

Weitermachen von Create iOS Auto-Renewable Subscription

Wenn Sie Create iOS Auto-Renewable Subscription zum Planen der Genehmigung und Verteilung in den App Stores verwenden, verbinden Sie es mit Using @capgo/native-purchases für die native Fähigkeit in Using @capgo/native-purchases, für die Implementierungsdetails in @capgo/capacitor-in-app-review, für die Implementierungsdetails in @capgo/capacitor-in-app-review, 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-Markt, und Mit @capgo/capacitor-native-Markt für die native Fähigkeit in Mit @capgo/capacitor-native-Markt