PromptSurge

iOS-SDK

iOS-Review-Prompt für SKStoreReviewController und requestReview

PromptSurge für iOS ist ein Swift-Paket, das einen kurzen Pre-Prompt mit Ihrem Branding zeigt und dann die eigene Bewertungsanfrage von StoreKit aufruft, wenn der Nutzer bestätigt. Zwei Aufrufe in Ihrem Code; Texte, Theme, Kopfbild und Sprachen kommen vom Server.

Kostenloser Plan · iOS 14+ · Swift Package Manager

1 · Ihr Pre-Prompt

Ihr Kopfbild

Eine kleine Bitte

Wir haben viel Arbeit in die Offline-Synchronisierung gesteckt. Eine kurze Bewertung hilft anderen, die App zu entdecken.

Nicht jetztBewertung abgeben

2 · Der native Bewertungsdialog

App Store oder Google Play

Der eigene Dialog von Apple oder Google, unverändert angezeigt

„Nicht jetzt“ schließt den Dialog und zeigt sonst nichts an.

Was das iOS-SDK für Sie erledigt

Der eigene Bewertungsdialog von StoreKit

Bei Bestätigung fordert das SDK mit Ihrer Window Scene den Bewertungsdialog von StoreKit an: Aktuelle SDK-Versionen rufen ab iOS 16 AppStore.requestReview(in:) auf, davor SKStoreReviewController.requestReview(in:). iOS entscheidet, ob der Dialog erscheint, bis zu dreimal pro Jahr und Gerät; das SDK zeichnet nie Sterne und erfasst nie selbst eine Bewertung.

UIKit und SwiftUI

Übergeben Sie einen beliebigen präsentierenden View Controller; aus SwiftUI übergeben Sie Ihren Root View Controller. Der Dialog ist eine programmatisch erstellte UIKit-Karte, die die Safe Area respektiert und lange Texte scrollt.

Alle Eignungsprüfungen eingebaut

Opt-out, eine 90-tägige Wartezeit pro Gerät, die Kontrollgruppe (10 %), die Aufwärmphase mit 50 Geräten und das monatliche Limit Ihres Plans werden geprüft, bevor etwas erscheint. Wird der Pre-Prompt wegen der Aufwärmphase, der Kontrollgruppe oder eines aufgebrauchten Limits zurückgehalten, wird die native Anfrage trotzdem ausgelöst, sodass der Moment nicht verloren geht.

Kein ATT-Prompt, Privacy Manifest enthalten

Die einzige Kennung ist ein gesalzener SHA-256-Hash aus identifierForVendor und Ihrer Bundle-ID; es gibt keine IDFA und keinen App Tracking Transparency-Prompt. PrivacyInfo.xcprivacy ist im Paket enthalten, und die README liefert Ihnen die Antworten für App Privacy.

Ohne Verzögerung angezeigt

Rufen Sie prefetch() beim Start auf, dann werden die Texte auf dem Gerät zwischengespeichert, und requestReview(in:) kann den Dialog ohne Netzwerk-Roundtrip anzeigen.

Die Integration

Fügen Sie das Paket in Xcode hinzu (File > Add Package Dependencies, dann die URL unten einfügen und das Produkt PromptSurge auswählen). Einmal initialisieren, dann requestReview(in:) in Ihrem Moment aufrufen. Die vollständigen Schritte, einschließlich Package.swift, finden Sie in der Dokumentation.

Paket-URL

https://github.com/PromptSurge-SDK/sdk-ios

App-Einstieg (SwiftUI)

import SwiftUI
import PromptSurge

@main
struct YourApp: App {
    init() {
        PromptSurge.initialize(apiKey: "ps_live_your_key_here")
        PromptSurge.prefetch()   // warms the cache in the background
    }

    var body: some Scene {
        WindowGroup { ContentView() }
    }
}

In Ihrem Moment (UIKit)

import PromptSurge

class CheckoutViewController: UIViewController {
    private func onPurchaseSuccess() {
        PromptSurge.requestReview(in: self)
    }
}

Während der Integration gibt PromptSurge.setLogLevel(.info) eine Zeile pro Entscheidung aus, einschließlich der Aufwärmphase, die eine neue App für ihre ersten 50 Geräte beim nativen Dialog belässt.

Integrationsdokumentation ansehen →

Auf dem Handy

Was Ihre Nutzer sehen, in drei Schritten

Dieselben Nutzer, derselbe Moment. Der Unterschied: Sie werden zuerst gefragt, mit Worten über Ihre App.

  1. Reise gespeichert

    Offline verfügbar

    requestReview()

    Schritt 1

    Ihr Code wählt den Moment

    Rufen Sie requestReview() auf, direkt nachdem etwas gut gelaufen ist, etwa nach einer gespeicherten Reise oder einem geschafften Level.

  2. Eine kleine Bitte

    In den Offline-Karten steckt viel Arbeit. Eine kurze Bewertung hilft anderen Reisenden, diese App zu finden.

    SpäterKlar

    Schritt 2

    Der Pre-Prompt bittet in Ihren Worten

    Eine kurze Nachricht, die nennt, was Ihre App kann. Später schließt sie, und sonst passiert nichts.

  3. App bewerten

    Zum Bewerten auf einen Stern tippen

    Eine Bewertung, die die Funktion nennt

    Die Offline-Karten haben meine Reise gerettet. Funktioniert ohne Netz.

    Schritt 3

    Das Bewertungsfenster des Stores

    Ein Ja öffnet das Fenster des Stores, unverändert. Die Nachricht von eben gibt etwas Konkretes, worüber man schreiben kann.

Wofür es gebaut ist

  1. Mehr Bewertungen von denselben Nutzern

    Gefragt wird in einem Moment, den Sie gewählt haben, mit einem Grund zu antworten.

  2. Mehr geschriebene Bewertungen

    Eine Nachricht über eine Funktion lädt zu Worten ein, nicht nur zu Sternen.

  3. Ihre Keywords in deren Worten

    Bewertungen, die nennen, was Ihre App kann, zeigen dem nächsten Besucher, für wen sie ist.

  4. Ein Signal, das die Stores lesen

    Apple und Google sagen beide, dass Bewertungen und Rezensionen in das Suchranking von Apps einfließen.

Ihr Dashboard zeigt, was sich für Ihre App geändert hat: geschriebene Bewertungen pro Tag, Sterne und Keyword-Nennungen, vor dem Pre-Prompt und mit ihm.

Quellen: Apple: Suche im App Store · Google Play: Auffindbarkeit und Ranking von Apps

So funktioniert es

  1. SDK einbinden

    Installieren Sie das iOS-, Android- oder Unity-Paket und rufen Sie initialize() einmal beim Start auf. Rufen Sie dann requestReview() in einem Moment Ihrer Wahl auf, etwa nach einem geschafften Level, einem gespeicherten Projekt oder einer abgeschlossenen Bestellung.

  2. Machen Sie den Pre-Prompt zu Ihrem

    Schreiben Sie im Dashboard den Titel, die Nachricht und die beiden Button-Beschriftungen, oder lassen Sie die integrierte KI sie aus Ihren eigenen Rezensionen entwerfen. Wählen Sie ein Theme, fügen Sie ab Startup ein Kopfbild hinzu und akzeptieren Sie: Die Texte werden in 10 Sprachen übersetzt und erreichen die Geräte ohne App-Update.

  3. Mit der Kontrollgruppe vergleichen

    10 % der Geräte sehen den Pre-Prompt nie und bekommen in denselben Momenten direkt den nativen Dialog. Das Dashboard stellt beide Gruppen nebeneinander und erfasst jeden Tag Ihre Store-Bewertung und Bewertungsanzahl.

Gemessen an einer Kontrollgruppe, nicht angenommen

Jede App bekommt eine Kontrollgruppe. 10 % der Geräte werden ihr auf Lebenszeit zugeordnet und sehen den Pre-Prompt nie: Erreichen sie den Moment, den Sie gewählt haben, wird der native Dialog direkt ausgelöst, so wie ohne PromptSurge. Eine neue App startet außerdem mit einer Aufwärmphase von 50 Geräten, die nur den nativen Dialog sehen, sodass eine Basislinie existiert, bevor der erste Pre-Prompt erscheint.

Das Dashboard vergleicht die beiden Gruppen über alle Geräte, die Ihren Bewertungsmoment erreicht haben: wie viele den Pre-Prompt gesehen haben, wie viele durchgetippt haben, wie viele native Dialoge angefordert wurden. Ein Urteil hält es zurück, bis jede Gruppe mindestens 50 Geräte hat.

Eine ehrliche Grenze: Apple und Google teilen einer App nie mit, ob ein Nutzer bewertet hat oder was er geschrieben hat. Deshalb erfasst PromptSurge neben dem Funnel einmal täglich Ihre Store-Bewertung und Bewertungsanzahl und zeigt die Veränderung. Das ist eine Gesamtzahl des Stores, keinem einzelnen Prompt zugeordnet, und das Dashboard sagt das auch.

Kontrollgruppe mit 10 %

Pro Gerät zugeordnet, auf Lebenszeit. Der native Dialog wird in denselben Momenten direkt ausgelöst.

Aufwärmphase mit 50 Geräten

Eine neue App startet allein mit dem nativen Dialog, damit die Basislinie zuerst kommt.

Täglicher Store-Snapshot

Ihre Durchschnittsbewertung und Bewertungsanzahl aus jedem Store, einmal täglich, für Apps mit Store-Link.

Häufig gestellte Fragen

Welche iOS-Versionen werden unterstützt?

iOS 14 und neuer, gebaut mit Xcode 14 oder neuer, installiert über Swift Package Manager.

Ist ein Pre-Prompt nach App-Store-Richtlinie 5.6.1 erlaubt?

Richtlinie 5.6.1 besagt, dass Sie für Bewertungsanfragen die API von Apple verwenden sollen und dass Apple eigene Bewertungs-Prompts nicht zulassen wird. PromptSurge erfasst nie selbst eine Bewertung: Die Sterne und der Rezensionstext entstehen immer in Apples eigenem Dialog, angefordert über StoreKit. Der Dialog davor ist eine kurze Bitte, die nie fragt, wie der Nutzer die App findet. Die StoreKit-Dokumentation von Apple sagt außerdem, requestReview nicht als Reaktion auf einen Button-Tipp aufzurufen, weil das System den Dialog möglicherweise nicht anzeigt; mit einem Pre-Prompt ist es der Tipp des Nutzers auf Bestätigen, der ihn anfordert. In aktuellen SDK-Versionen zeigt PromptSurge seinen Pre-Prompt auf einem Gerät nicht mehr an, sobald es Apples Dialog dort dreimal in 365 Tagen angefordert hat, Apples eigenes Limit, sodass ein Ja seltener ins Leere läuft. Wie Apple eine bestimmte App prüft, ist Apples Entscheidung. Formulieren Sie selbst geschriebene Texte deshalb als schlichte Aussage und beschreiben Sie den Pre-Prompt am besten in Ihren Notizen für das App Review; das Dashboard warnt Sie, wenn ein Text eine Frage stellt.

Was die Stores sagen, und eine Notiz für das App Review (Dokumentation auf Englisch) →

Erscheint der native Dialog nach einer Bestätigung immer?

Nein, iOS entscheidet. StoreKit zeigt die Anfrage höchstens dreimal in 365 Tagen pro Gerät, und jemandem, der bereits bewertet hat, nur für eine neue Version nach einem Jahr. In aktuellen SDK-Versionen erscheint der Pre-Prompt auf einem Gerät nicht mehr, sobald das SDK den Dialog dort dreimal in 365 Tagen angefordert hat. Weder das SDK noch irgendein anderer Code kann sehen, ob sie erschienen ist oder ob der Nutzer bewertet hat.

Warum erscheint auf meinem Testgerät nichts?

Fast immer liegt es an der Aufwärmphase: Eine neue App bleibt allein beim nativen Dialog, bis 50 verschiedene Geräte den Bewertungsmoment erreicht haben. Schalten Sie die Aufwärmphase für die App im Dashboard ab, während Sie testen, und aktivieren Sie setLogLevel(.info), um jede Entscheidung zu sehen.

Was gebe ich bei App Privacy an?

Identifiers > Device ID und Usage Data > Product Interaction, beide für Analytics, nicht mit der Identität verknüpft und nicht für Tracking verwendet, zusätzlich zu allem, was der Rest Ihrer App erhebt. Die README enthält die Tabelle.

Zwei Aufrufe in Ihrer iOS-App, der Rest im Dashboard

Kostenloser Plan, keine Kreditkarte. Legen Sie eine App an, kopieren Sie ihren API-Schlüssel und liefern Sie aus.

Kostenloses Konto erstellen →

Sie haben bereits ein Konto? Anmelden