Abonnements und Berichterstellung in Xamarin.iOS

Informationen zu abonnements, die nicht verlängert werden

Nicht verlängerte Abonnements sind für Produkte vorgesehen, die den Verkauf eines Diensts mit einer Zeitbeschränkung darstellen (z. B. zugriff auf eine Navigationsanwendung oder zeitlich begrenzter Zugriff auf ein Datenarchiv).

Wichtige Unterschiede zwischen nicht verlängernden Abonnements und anderen Produkttypen:

• Die Produktdefinition in iTunes Connect enthält den Begriff nicht. Der Anwendungscode muss in der Lage sein, den Gültigkeitszeitraum aus der Produkt-ID abzuleiten.
• Sie können mehrmals erworben werden (z. B. ein Verbrauchsprodukt). Anwendungen sind erforderlich, um die Abonnementlaufzeit/-ablauf und die Verlängerung zu verwalten und zu verhindern, dass der Benutzer überlappende Abonnements kauft.
• Die Käufe werden von der Funktion StoreKit Restore nicht unterstützt. Wenn das Abonnement auf allen Geräten eines Benutzers verfügbar sein soll, muss die Anwendung dieses Feature in Verbindung mit einem Remoteserver entwerfen und implementieren. Anwendungen sind auch für die Sicherung des Abonnements status für Fälle verantwortlich, in denen ein Gerät gesichert und dann von der Sicherung wiederhergestellt wird.
• Übersicht über die Implementierung
• Abonnements, die sich nicht verlängern, sollten normalerweise mithilfe des Server-Delivered-Workflows implementiert und wie Verbrauchsartikel verwaltet werden.

Informationen zu kostenlosen Abonnements

Kostenlose Abonnements ermöglichen Es Entwicklern, kostenlose Inhalte in Kiosk-Apps zu platzieren (sie können nicht in Nicht-Kiosk-Apps verwendet werden). Sobald ein kostenloses Abonnement gestartet wurde, steht es auf allen Geräten des Benutzers zur Verfügung. Kostenlose Abonnements laufen nie ab; Sie enden nur, wenn die Anwendung deinstalliert wird.

Übersicht über die Implementierung

Kostenlose Abonnements verhalten sich ähnlich wie automatisch erneuerbare Abonnements. Die Anwendung muss über ein Kostenloses Abonnementprodukt verfügen, das in iTunes Connect zum "Kauf" verfügbar ist. Beim Erwerb durch den Benutzer sollte der kostenlose Abonnementkauf wie ein automatisch erneuerbares Abonnementprodukt überprüft werden. Kostenlose Abonnementtransaktionen können wiederhergestellt werden.

Informationen zu automatisch erneuerbaren Abonnements

Auto-Erneuerbare Abonnements werden hauptsächlich in Kiosk-Anwendungen verwendet. Sie stellen ein Produkt dar, das dem Benutzer für einen bestimmten Zeitraum Zugriff auf dynamische Inhalte gewährt, der in iTunes Connect konfiguriert ist (festgelegte Zeiträume von 7 Tagen bis 1 Jahr). Abonnements werden automatisch verlängert, wobei die Apple-ID des Benutzers am Ende jedes Abonnementzeitraums abgeladen wird, es sei denn, der Benutzer optiert ab. Dieser Produkttyp eignet sich gut für Zeitschriften- oder Nachrichtenabonnements, bei denen der Benutzer Zugriff auf jede veröffentlichte Ausgabe erhält, während sein Abonnement gültig ist.

Übersicht über die Implementierung

Automatisch erneuerbare Abonnements sollten mithilfe des Workflows Server-Delivered Products implementiert werden (weitere Informationen finden Sie im Abschnitt Belegüberprüfung und Server-Delivered Produkte ).

Gemeinsamer geheimer Schlüssel

Der In-App Gemeinsames Geheimnis kaufen muss in der JSON-Anforderung verwendet werden, wenn Abonnements mit automatischer Verlängerung auf Ihrem Server überprüft werden. Das freigegebene Geheimnis wird über iTunes Connect erstellt/aufgerufen.

Wählen Sie auf der iTunes Connect-Startseite Meine Apps aus:

Wählen Sie eine Anwendung aus, und klicken Sie auf die Registerkarte In-App-Käufe :

Wählen Sie unten auf der Seite Die Option Anzeigen oder Generieren eines freigegebenen Geheimnisses aus:

Um das freigegebene Geheimnis zu verwenden, schließen Sie es wie folgt in die JSON-Nutzlast ein, die an die Apple-Server gesendet wird, wenn Sie einen In-App-Kaufbeleg für ein automatisch verlängerbares Abonnement überprüfen:

{
   "receipt-data" : "(receipt bytes here)",
   "password"     : "(shared secret bytes here)"
}

Das status Feld der Antwort ist null, wenn der Kauf gültig ist, wie bei anderen Produkttypen.

Herunterladen von Elementen nach der anfänglichen Abonnementlaufzeit

Im Rahmen der Bereitstellung von Abonnementprodukten sollte der Code häufig die neueste bekannte Bestätigung für die Apple-Server überprüfen. Wenn ein Abonnement seit der letzten Überprüfung automatisch verlängert wurde, enthält die JSON-Antwort zusätzliche Felder, die die Anwendung über die aufgetretene Transaktion benachrichtigen (wodurch die Gültigkeit der Abonnements verlängert werden sollte). Die JSON-Antwort enthält Folgendes:

{
   "status" : 0,
   "receipt" : { (receipt here) },
   "latest_receipt" : "(base-64 encoded receipt here)",
   "latest_receipt_info" : { (latest receipt info here) }
}

Wenn der status null ist, ist das Abonnement weiterhin gültig, und die anderen Felder enthalten gültige Daten. Wenn der status 21006 ist, ist das Abonnement abgelaufen. Weitere Fehlercodes finden Sie in der Dokumentation Überprüfen eines automatisch verlängerbaren Abonnementbelegs .

Wiederherstellen automatisch erneuerbarer Abonnements

Sie erhalten mehrere Transaktionen zurück – die ursprüngliche Kauftransaktion sowie eine separate Transaktion für jeden Zeitraum, in dem das Abonnement verlängert wurde. Sie müssen die Anfangstermine und -begriffe nachverfolgen, um den Gültigkeitszeitraum zu verstehen.

Das SKPaymentTransaction-Objekt enthält NICHT den Abonnementbegriff. Sie sollten für jeden Begriff eine andere Produkt-ID verwenden und Code schreiben, der den Abonnementzeitraum ab dem Kaufdatum der Transaktion extrapolieren kann.

Testen der automatischen Verlängerung

Um das Testen von Abonnements zu vereinfachen, werden deren Dauer beim Testen in der Sandbox komprimiert. 1-Wochen-Abonnements werden alle 3 Minuten verlängert, Abonnements werden stündlich um 1 Jahr verlängert. Abonnements werden beim Testen in der Sandbox maximal sechs Mal automatisch verlängert.

Berichterstellung

iTunes Connect ( itunesconnect.apple.com) bietet Folgendes:

Verkäufe und Trends : Zeigt Details zu App-Downloads, Updates und In-App-Käufen an.

Zahlungen und Finanzberichte – Enthält informationen zu den Einnahmen, die Mit Ihren Apps erzielt wurden, sowie die Ihnen geleisteten Zahlungen und deren Schulden.

Ein Beispiel für den Bericht "Sales and Trends" (Umsatz und Trends) ist unten dargestellt:

Es gibt auch eine ITC Connect Mobile iOS-App . iPhone-Screenshots für einige der verfügbaren Statistiken werden hier gezeigt: