Little SwiftUI Tip: Interact with App Store
Zusammenfassung
Kurz
Der Artikel zeigt StoreKit-Wege, um Storefront-Daten und App-Transaktionen abzurufen, App-Store-Nachrichten zu handhaben und Bewertungen anzustoßen. Er nennt wichtige Grenzen: Storefront-Daten dürfen laut Apple nicht zur Profilbildung oder Werbeverfolgung dienen, Authentifizierungsabfragen können auftreten, und Nachrichten sowie In-App-Bewertungsanfragen werden nicht garantiert angezeigt.
Mittel
Der Bericht erklärt anhand von StoreKit-Beispielen, wie SwiftUI-Apps Storefront-Daten abrufen, App-Transaktionsinformationen lesen, App-Store-Nachrichten steuern und Bewertungen anfordern können. `Storefront.current` liefert laut Artikel Länder- oder Regionscode, Währung und Kennung; `Storefront.updates` beobachtet Änderungen. Der Autor erinnert an Apples Vorgabe, diese Daten nicht zur Profilbildung oder Werbeverfolgung zu verwenden.
`AppStore.ageRatingCode` dient der Altersfreigabe, wobei ein fehlender Wert oder `0` auftreten könne. `AppTransaction.shared` stellt unter anderem App-Version, ursprüngliches Kaufdatum und Plattform bereit; bei Fehlern oder nicht verifizierten Ergebnissen nennt der Beitrag `refresh()` als Aktualisierungsmöglichkeit. Da beide Aufrufe eine Authentifizierungsabfrage auslösen können, empfiehlt der Autor, sie an eine bewusste Nutzeraktion zu knüpfen.
StoreKit zeige Nachrichten standardmäßig beim App-Start. Mit `Message.messages` und `displayStoreKitMessage` lasse sich ihre Anzeige gezielter steuern, doch sie sei nicht garantiert und jede eindeutige Nachricht werde nur einmal präsentiert. Für Bewertungen kann `RequestReviewAction` eine In-App-Anfrage auslösen, deren Anzeige begrenzt und nicht garantiert ist; `OpenURLAction` führt stattdessen zur Bewertungsseite im App Store. In-App-Käufe und Abonnements sind ausdrücklich ausgeklammert.
Ausführlich lesen
Der vollständige Bericht von Itsuki stellt mehrere StoreKit-Schnittstellen vor, mit denen SwiftUI-Apps App-Store-Informationen abrufen, Nachrichten anzeigen und Bewertungen anfordern können. Der Beitrag beginnt mit einem praktischen Hinweis: `StoreKit` muss importiert sein; eine fehlende Einbindung könne sich laut Autor durch eine wenig hilfreiche Fehlermeldung bemerkbar machen.
Für Informationen zum App-Store-Schaufenster beschreibt der Artikel `Storefront.current` zum Abruf des aktuellen Storefronts und `Storefront.updates` als asynchrone Folge, um Änderungen zu beobachten. Genannt werden die Kennung, der dreistellige Länder- oder Regionscode und die verwendete Währung. Zugleich hebt der Autor Apples Einschränkung hervor: Storefront-Daten sollen weder zur Erstellung oder Anreicherung von Kundenprofilen noch zur Werbe- oder Marketingverfolgung verwendet werden.
Zum eigenen App-Status nennt der Beitrag `AppStore.ageRatingCode` für die Altersfreigabe. Laut Artikel kann der Wert fehlen, wenn keine Einstufung verfügbar ist; der Wert `0` sei ebenfalls ungültig und könne etwa im Simulator oder bei nicht mit App Store Connect verknüpften Apps auftreten. Für Angaben zu Kauf und Download der App führt der Autor `AppTransaction.shared` an. Das Beispiel unterscheidet verifizierte von nicht verifizierten Ergebnissen und behandelt Fehler. Bei einem Fehler oder einer nicht verifizierten Transaktion könne `refresh()` zum Aktualisieren der Informationen verwendet werden. Als nützliche Felder zählt der Beitrag Bundle- und App-ID, die Version der Transaktion, die ursprünglich gekaufte App-Version, das ursprüngliche Kaufdatum und die ursprüngliche Plattform auf. Eine wichtige Einschränkung: `shared` oder `refresh()` könne eine Systemabfrage zur Authentifizierung mit App-Store-Zugangsdaten auslösen. Der Autor empfiehlt deshalb, dies als Reaktion auf eine bewusste Nutzeraktion und nicht im Hintergrund aufzurufen.
Der Artikel beschreibt außerdem App-Store-Nachrichten, etwa zu Abrechnungsproblemen, Preiserhöhungen bei automatisch verlängerbaren Abos oder Rückgewinnungsangeboten. StoreKit rufe diese laut Beitrag standardmäßig beim App-Start ab und zeige sie an. Wer Zeitpunkt und Auswahl selbst steuern wolle, könne `Message.messages` beobachten und Nachrichten über `displayStoreKitMessage` anzeigen. Das ist nicht garantiert: Ist das Problem bereits behoben, kann die Nachricht ausbleiben; außerdem werde jede eindeutige Nachricht nur einmal präsentiert.
Für Bewertungsanfragen stellt der Autor zwei Wege gegenüber: `RequestReviewAction` zeigt eine Anfrage innerhalb der App, garantiert ihre Anzeige aber nicht. Der Beitrag nennt eine Begrenzung auf höchstens drei Anzeigen innerhalb von 365 Tagen und beschreibt weitere Voraussetzungen im Zusammenhang mit früheren Bewertungen. Beim Testen in Xcode werde die Anfrage laut Artikel jedes Mal angezeigt. Alternativ öffnet `OpenURLAction` die App-Store-Seite mit dem Parameter `action=write-review`, sodass die Person den Store verlässt und dort eine Bewertung schreiben kann. Der Beitrag behandelt In-App-Käufe, Erstattungen und Abonnementverwaltung ausdrücklich nicht; dafür verweist er auf einen anderen, im Text noch nicht verlinkten Artikel.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Vorlage enthält keine Sammelfrage und keine Teilfragen (Einordnung: „keine“), daher wurde keine Einordnung vorgenommen. Die Bewertung bezieht sich auf beide Zusammenfassungen: Die kurze Fassung ist treu, die mittlere Fassung ist sachlich korrekt und lässt nur einzelne Details aus.
Im Bericht, aber nicht in der Zusammenfassung
- Die Bewertungsanfrage wird höchstens dreimal innerhalb von 365 Tagen angezeigt; die mittlere Fassung nennt nur allgemein „begrenzt“.
- Im Xcode-Test wird die Bewertungsanfrage jedes Mal angezeigt.
- Der Import von StoreKit wird als erster Schritt genannt.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.