Create iOS Auto-Renewable Subscription

GitHub

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

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

Übersicht

Automatisch wiederkehrende Abonnements erneuern sich automatisch am Ende jedes Abrechnungszeitraums, bis 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 eine Abonnement erstellen, müssen Sie:

Ein Abonnement erstellen um Ihre Abonnements zu organisieren
Ein aktives Mitglied der Apple Developer Program haben
Bank- und Steuerinformationen in App Store Connect abgeschlossen haben

Ein Abonnement erstellen

Zum Abonnementsbereich navigieren

In App Store Connect, Ihre App auswählen und zu Monetize > Abonnements gehen.

Ihr Abonnement auswählen oder ein neues erstellen, wenn erforderlich.
Erstellen Sie ein neues Abonnement

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

Bezeichnung zum Verweisen: Beschreibender Name für Ihre interne Verwendung (wird den Kunden nicht angezeigt)
- Beispiele: “Premium monatlich”, “Ultimatives jährlich”, “Grundlegender Plan”
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 Plugins native-purchases 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 Laufzeit bestimmt, wie oft Benutzer abgerechnet werden.
Preisgestaltung einrichten

Klicken Preis für Abonnement hinzufügen Zur Konfiguration der Preise:

Grundgebiet: Wählen Sie Ihr Hauptmarkt (in der Regel Ihr Land)

Preis: Legen Sie den Abonnementpreis fest
- 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 Sie Family Sharing aktivieren möchten, mit dem bis zu 6 Familienmitglieder Zugriff auf die Abonnement haben.

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

Aktivieren Sie, wenn:
- Der Inhalt ist für die Familienbenutzung geeignet
- Sie möchten den Wertvorschlag 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 die Einnahmen pro Benutzer maximieren
Lokalisierung hinzufügen

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

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

Beschreibung: Kurze Beschreibung, was das Abonnement umfasst
- Halten Sie es knapp und fokussieren Sie sich auf Vorteile
- Nennen Sie wichtige Funktionen
- Hervorheben Sie den Vorteil
App Store-Bild für Werbung (Optional)

Hochladen Sie ein Werbebild für dieses Abonnement (312x390 Pixel):
- Zeigt auf der Abonnementsseite des App Stores an
- Sollte sich an der Design Ihres Apps anlehnen
- Fügen Sie den Namen des Abonnements hinzu, um Klarheit zu schaffen
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-Einreichung einbeziehen
- Kann nicht unabhängig eingereicht werden
Für weitere Abonnements:
- Kann direkt von der Abonnements-Seite eingereicht werden
- Bereitstellung einer neuen App-Version nicht erforderlich
- Verfügbar nach Genehmigung des ersten Abonnements

Abonnementstatus

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	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 Ihre App Store Connect-Abonnement mit einem monatlichen Abrechnungsplan und einer 12-monatigen Verpflichtung konfiguriert ist, kann StoreKit zusätzliche Preisbegriffe für das Produkt zurückgeben. Verwenden Sie diese Begriffe, 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 Berechtigungsablauf, sehen Sie sich bitte 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 Namensgebung: company.app.tier_duration
Fügen Sie Stufe und Dauer in der ID ein: premium_monthly, ultimate_annual
Vermeiden Sie Änderungen an Produkt-IDs (sie sind dauerhaft)
Dokumentieren Sie alle Produkt-IDs für Ihr Team

Für familienorientierte Apps (Spiel, Bildung, Unterhaltung) aktivieren
Berücksichtigen Sie den Einfluss auf den Umsatz
Testen Sie das Verhalten der Familienfreigabe gründlich
Kommunizieren Sie die Freigabefähigkeit in der Werbung

Übersetzung

Übersetzen Sie alle Namen und Beschreibungen der Abonnements
Berücksichtigen Sie regionale Preisunterschiede
Testen Sie die Anzeige in allen unterstützten Sprachen
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 an die 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)

Fehlersuche

Abonnement lädt sich nicht in der App:

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

Kann keine Abonnement einreichen:

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)

Family Sharing-Toggle deaktiviert:

Bereits aktiviert (kann nicht deaktiviert werden)
Überprüfe in Abonnement-Details
Wende dich bei Problemen an Apple Support

Preistufe nicht verfügbar:

Kann in einigen Gebieten eingeschränkt sein
Alternative Ebene wählen
Kontakt Apple für Preisfragen

“Falsche Produkt-ID”-Fehler:

Muss im umgekehrten Domänenformat sein
Kann keine Leerzeichen oder Sonderzeichen enthalten
Achten Sie auf Tippfehler
Überprüfen Sie die Eindeutigkeit gegenüber allen Produkten

Zukünftige Schritte

Einführung eines Einstiegsangebots erstellen um neue Abonnenten anzuziehen
Monatliche Verpflichtung zur Wareneinkaufsabrechnung für unterstützte jährliche Abonnementangebote
Konfigurieren Sie die Sandbox-Testumgebung um Ihre Abonnements zu testen
Konfigurieren Sie werbliche Angebote für das Wiederbeleben und die Aufrechterhaltung
Implementieren Sie die Analyse der Abonnementverfolgung

Zusätzliche Ressourcen

Zur weiteren Information beziehen Sie sich auf die offizielle Apple-Dokumentation zu den automatisch wiederholbaren Abonnements Fortsetzen Sie von Erstellen Sie ein iOS-Automatisch wiederholbares Abonnement.

Abschnitt mit dem Titel „Fortsetzen Sie von Erstellen Sie ein iOS-Automatisch wiederholbares Abonnement“

__CAPGO_KEEP_0__ iOS-Auto-Renewable-Abonnement erstellen um die Genehmigung und Verteilung im App Store zu planen, verbinden Sie es mit Mit @capgo/native-purchases Für die native Fähigkeit in Mit @capgo/native-purchases, Mit @capgo/capacitor-in-app-Bewertung Für die Implementierungsdetails 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, Mit @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.