Create iOS Auto-Renewable Subscription

GitHub

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

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 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:

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

Ein Abonnement erstellen

Zu den Abonnements 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.
Grundlegende Informationen eingeben

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 Abonnement-Dauer 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 Abonnementpreis hinzufügen Um die Preise zu konfigurieren:

Herkunftsort: 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
- Berücksichtigen 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 Wertangebot erhöhen
- Ihr Geschäftsmodell unterstützt dies
Deaktivieren Sie nicht, wenn:
- Abonnement gilt nur für den einzelnen Benutzer
- Der Inhalt wird dem Benutzer angepasst
- Sie möchten die Einnahmen pro Benutzer maximieren
Hinzufügen von Lokalisierungen

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

Abonnement-Bezeichnung: Kundenzugewandte 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
- 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 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-Referenz 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 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 Verpflichtungszeit 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-Monatszusagen-Abrechnungspläne.

Empfehlungen

Preisstrategie

Monatspläne: Geringere Einstiegshürde, Bildung von Gewohnheiten
Jahrespläne: Bessere Wertigkeit, höherer Kundenwert, geringere Kündigungsrate
Mehrfachstufen: Grund, Premium, Ultimate für verschiedene Nutzersegmente
Wettbewerbsanalyse: Forschung ähnlicher Apps’ Preisstrategie

Produkt-IDs

Einheitliche Namensgebung verwenden: company.app.tier_duration
Stufen und Dauer in der ID enthalten: premium_monthly, ultimate_annual
Produkt-IDs ändern (sie sind dauerhaft):
Alle Produkt-IDs für Ihr Team dokumentieren:

Familienfreundliche Apps (Spiel, Bildung, Unterhaltung) aktivieren:
Einfluss auf den Umsatz berücksichtigen:
Teilnahme an der Familienfreundlichen Nutzung gründlich testen:
Teilnahme an der Familienfreundlichen Nutzung in der Werbung kommunizieren:

Übersetzung

Übersetzen Sie alle Abonnementnamen und -beschreibungen
Berücksichtigen Sie regionale Preisunterschiede
Testen Sie die Anzeige in allen unterstützten Sprachen
Verwenden Sie kulturell angemessene Marketingtexte

Werbebilder

Halten Sie einen konsistenten visuellen Stil ein
Inkludieren Sie den Abonnementnamen und das Hauptvorteil
Aktualisieren Sie für saisonale Aktionen
Passen Sie die App-Designsprache 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ändige (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 Abonnementgruppe 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 (erforderlich für die App-Version) vorhanden ist

Familien-Teilhaben-Toggle deaktiviert:

Bereits aktiviert (kann nicht deaktiviert werden)
Überprüfen Sie die Abonnement-Details
Kontaktieren Sie den 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 den Preisen

“Invalid Product ID”-Fehler:

Muss im umgekehrten Domänenformat sein
Kann nicht Leerzeichen oder Sonderzeichen enthalten
Überprüfen Sie auf Tippfehler
Überprüfen Sie die Eindeutigkeit in allen Produkten

Nächste Schritte

Ermäßigtes Angebot erstellen um neue Abonnenten anzuziehen
Monatliche Verpflichtungsberechnungspläne für Merchandise für unterstützte jährliche Abonnementangebote
Sandbox-Testkonfiguration um Ihre Abonnements zu testen
Gutscheine für Win-Back- und Retentionsangebote einrichten
Abonnement-Analyse-Tracking implementieren

Zusätzliche Ressourcen

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

Weitermachen von Erstellen eines iOS-Automatischen Erneuerbaren Abonnements

Wenn Sie " Erstellen eines iOS-Automatischen Erneuerbaren Abonnements zur 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.