Create iOS Auto-Renewable Subscription

GitHub

Eine Einrichtungshinweis 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 -Utilitäten

Voraussetzungen

Bevor Sie Abonnements erstellen, müssen Sie:

Einen Abonnement-Gruppen erstellen um Ihre Abonnements zu organisieren
Eine aktive Mitgliedschaft im Apple-Entwicklerprogramm haben
Bank- und Steuerinformationen in App Store Connect abgeschlossen haben

Ein Abonnement erstellen

Zum Abschnitt ‘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 Ihrem Abonnement-Gruppe, um ein neues Abonnement hinzuzufügen.
Grundlegende Informationen eingeben

Referenzname: Beschreibender Name für Ihre interne Verwendung (wird den Kunden nicht angezeigt)
- Beispiele: “Premium Monatlich”, “Ultimatives Jahresabonnement”, “Grundplan”
Produkt-ID: Eindeutiger Identifikator für dieses Abonnement (kann später nicht geändert werden)
- Format: com.yourcompany.yourapp.premium_monthly
- Verwenden Sie beschreibende, kleine Buchstaben mit Unterstrichen
- Für die Konfiguration des native-purchases-Plugins erforderlich
Konfiguration der Laufzeit

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

Klicken Zahlungspreis hinzufügen Zur Preisgestaltung konfigurieren:

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

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

Entscheiden Sie, ob Sie Family Sharing aktivieren möchten, mit dem bis zu 6 Familienmitglieder Zugriff auf die Abonnement haben.

Wenn Family Sharing aktiviert ist, kann sie für dieses Produkt nicht mehr deaktiviert werden.

Aktivieren Sie, wenn:
- Der Inhalt ist für die Familienbenutzung geeignet
- Sie möchten den Wertvorteil erhöhen
- Ihr Geschäftsmodell unterstützt es
Aktivieren Sie nicht, wenn:
- Das Abonnement ist nur für den Einzelnen gedacht
- Der Inhalt ist auf den Benutzer zugeschnitten
- Sie möchten den Umsatz pro Benutzer maximieren
Lokalisierung hinzufügen

Fügen Sie die Anzeigedaten für die Abonnement in allen Sprachen ein, die Ihre App unterstützt:

Abonnement-Display-Name: Kundenzugewandter Name (z.B. "Premium Monatlich")

Beschreibung: Kurze Beschreibung, 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-Bild für Werbung (Optional)

Hochladen Sie ein Bild für diese Abonnement (312x390 Pixel):
- Zeigt auf der App Store-Abonnementseite an
- Sollte sich an der Design Ihres Apps anlehnen
- Fügen Sie den Namen des Abonnements für Klarheit hinzu
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 Sie Speichern Klicken Sie, um das Abonnement zu erstellen.

Für das erste Abonnement:
- Muss mit einer neuen App-Version eingereicht werden
- Mit Ihrer nächsten App-Store-Einsendung einbeziehen
- Kann nicht unabhängig eingereicht werden
Für nachfolgende Abonnements:
- Kann direkt von der Abonnements-Seite eingereicht werden
- Bereitstellung einer neuen App-Version nicht erforderlich
- Verfügbar nach Genehmigung des ersten Abonnements

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	Eingereicht bei Apple	Ja (Sandbox)
In der Überprüfung	Von Apple überprüft	Ja (Sandbox)
Genehmigt	Verfügbar zum Kauf	Ja
Abgelehnt	Wird geändert	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 Ihre 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 den monatlichen Betrag, die Gesamtkommitmentsumme 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 den vollständigen Paywall- und Berechtigungsfluss siehe iOS-Monatskommitment-Abrechnungspläne.

Gute Praxis

Preisstrategie

Monatspläne: Einfacher Zugang, Bildung von Gewohnheiten
Jahrespläne: Bessere Wertigkeit, höherer LTV, geringere Abwanderung
Mehrfachstufen: Grund, Premium, Ultimate für verschiedene Benutzersegmente
Wettbewerbsanalyse: Forschung ähnlicher Apps’ Preisgestaltung

Produkt IDs

Verwenden Sie konsistente Namen: company.app.tier_duration
Fügen Sie Stufe und Dauer in die ID ein: premium_monthly, ultimate_annual
Vermeiden Sie Änderungen an Produkt IDs (sie sind dauerhaft)
Alle Produkt-IDs für Ihr Team dokumentieren

Aktivieren für Apps mit familienorientierten Inhalten (Spiel, Bildung, Unterhaltung)
Die Auswirkungen auf den Umsatz berücksichtigen
Die Teilenutzung gründlich testen
Die Teilenutzung in der Werbung kommunizieren

Lokalisierung

Alle Abonnementnamen und -beschreibungen übersetzen
Regionale Preisunterschiede berücksichtigen
Die Anzeige in allen unterstützten Sprachen testen
Verwenden Sie kulturell angemessene Werbemitteilungen

Werbebilder

Halten Sie eine konsistente visuelle Gestaltung aufrecht
Fügen Sie den Namen der Abonnement und den Hauptvorteil hinzu
Aktualisieren Sie für saisonale Werbeaktionen
Passen Sie sich der Gesamtdesignsprache der App an

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 (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-Hybrid

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

Schwierigkeiten beheben

Abonnement lädt sich nicht in der App:

Überprüfen Sie, ob das Produkt-ID genau (fallweise) übereinstimmt
Überprüfen Sie, ob das Abonnement sich in einer Abonnement-Gruppe befindet
Stellen Sie sicher, dass die App-Identifikationsnummer mit App Store Connect übereinstimmt
Warte 2-3 Stunden nach Produkt erstellen

Kann keine Abonnementsubmission durchführen:

Erfülle alle erforderlichen Felder (Name, Beschreibung, Preis)
Füge mindestens eine Lokalisierung hinzu
Überprüfe, ob die Bank- und Steuerinformationen genehmigt sind
Überprüfe, ob das erste Abonnement (erfordert App-Version) vorhanden ist

Family Sharing-Toggle deaktiviert:

Bereits aktiviert (kann nicht deaktiviert werden)
Überprüfe in Abonnementdetails
Wende dich an Apple-Support, wenn du steckst

Preistufe nicht verfügbar:

Kann in einigen Gebieten eingeschränkt sein
Alternative-Tarif wählen
Kontaktiere Apple für Preisfragen

“Falsche Produkt-ID”-Fehler:

Must be reverse domain format
Kann keine Leerzeichen oder Sonderzeichen enthalten
Überprüfe auf Tippfehler
Überprüfe die Eindeutigkeit gegenüber allen Produkten

Zukünftige Schritte

Einführungsgeschäft erstellen um neue Abonnenten anzuziehen
Monatliche Verpflichtung zur Warengeschäftsabwicklung für unterstützte jährliche Abonnementangebote
Konfigurieren Sie Sandbox-Testungen um Ihre Abonnements zu testen
Konfigurieren Sie werbewirksame Angebote für Win-Back und -Retention
Implementieren Sie die Analyse der Abonnementverfolgung

Zusätzliche Ressourcen

Zur weiteren Information beziehen Sie sich auf die offizielle Apple-Dokumentation zu automatisch wiederkehrenden Abonnements.

Fortsetzen Sie von Erstellen Sie ein iOS-Automatisch wiederkehrendes Abonnement

Wenn Sie Capgo verwenden iOS-Automatik-Abonnement erstellen um die Genehmigung und Verteilung im App Store zu planen, verbinden Sie es mit Mit @capgo/native-purchases zur nativen Fähigkeit in Mit @capgo/native-purchases, Mit @capgo/capacitor-in-app-review zur Implementierungsdetails in Mit @capgo/capacitor-in-app-review, Mit @capgo/capacitor-in-app-review zur nativen Fähigkeit in Mit @capgo/capacitor-in-app-review, Mit @capgo/capacitor-native-market zur Implementierungsdetails in Mit @capgo/capacitor-native-market, und Mit @capgo/capacitor-native-market zur nativen Fähigkeit in Mit @capgo/capacitor-native-market.