PromptSurge

Unity-SDK

Ein Unity-Review-Prompt für iOS und Android mit einem C#-Aufruf

PromptSurge für Unity ist ein UPM-Paket, das in Ihrem Spiel einen kurzen Pre-Prompt mit Ihrem Branding zeigt und dann den nativen Bewertungsdialog öffnet: StoreKit auf iOS, Google Play In-App Review auf Android. Rufen Sie RequestReview() nach einem Level auf; Texte, Theme, Kopfbild und Sprachen kommen vom Server.

Kostenloser Plan · Unity 2022.3 LTS+ · iOS und Android

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 Unity-SDK für Sie erledigt

Beide Stores, ein Aufruf

PromptSurge.RequestReview() öffnet über kleine native Shims SKStoreReviewController auf iOS und In-App Review von Play auf Android. Die Play-Abhängigkeit wird mit dem External Dependency Manager automatisch aufgelöst, ohne ihn mit einer Gradle-Zeile.

Gebaut für Spiele-UIs

Der Dialog ist ein im Code gebautes UGUI-Overlay mit Ihren Farben und Ihrem Kopfbild. Er legt ein EventSystem an, falls Ihre Szene keines hat, schließt sich bei einem Tipp außerhalb der Karte oder mit der Android-Zurück-Taste und bleibt verborgen, bis er bereit ist, sodass ein langsam ladendes Bild nie die Eingabe blockiert.

Stumm im Editor

Jeder Aufruf ist im Play Mode absichtlich wirkungslos: kein Dialog, kein nativer Bewertungsdialog, keine abgerechneten Ereignisse und nichts, was in PlayerPrefs geschrieben wird. Erstellen Sie einen Build für ein Gerät, um den Dialog zu sehen.

Bereit für IL2CPP

Das Paket liefert link.xml und [Preserve]-Attribute mit, sodass Managed Code Stripping auf Medium oder High nichts entfernt, was das SDK braucht.

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 zuerst geprüft. Wird der Pre-Prompt wegen der Aufwärmphase, der Kontrollgruppe oder eines aufgebrauchten Limits zurückgehalten, öffnet sich der native Dialog trotzdem, sodass der Moment nicht verloren geht.

Die Integration

Fügen Sie das Paket über Window > Package Manager > + > Add package from git URL hinzu, mit der versionsgebundenen URL aus der Dokumentation. Dann einmal initialisieren und RequestReview() in Ihrem Moment aufrufen.

GameManager.cs

using PromptSurgeSDK;

public class GameManager : MonoBehaviour {
    void Start() {
        PromptSurge.Initialize("ps_live_your_key_here");
        PromptSurge.Prefetch();   // warms the cache in the background
    }
}

LevelManager.cs

using PromptSurgeSDK;

public class LevelManager : MonoBehaviour {
    void OnLevelComplete() {
        PromptSurge.RequestReview();
    }
}

Auf Android kommt die Review-Bibliothek von Play automatisch über EDM4U; ohne EDM4U fügen Sie implementation 'com.google.android.play:review:2.0.1' zu mainTemplate.gradle hinzu. PromptSurge.SetLogLevel(LogLevel.Info) gibt während der Integration eine Zeile pro Entscheidung aus.

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 Unity-Versionen werden unterstützt?

Unity 2022.3 LTS und neuer. Ältere LTS-Versionen funktionieren eventuell, wurden aber nicht kompiliert und werden nicht unterstützt. Android-Builds benötigen den Vertrieb über den Play Store und minSdkVersion 21; iOS-Builds benötigen iOS 14.

Warum passiert im Editor nichts?

Absichtlich. Jeder Einstiegspunkt ist im Play Mode wirkungslos, damit beim Testen nie Impressionen abgerechnet oder PlayerPrefs gefüllt werden. Erstellen Sie einen Build für ein Gerät; bei einer neuen App rechnen Sie außerdem mit der Aufwärmphase von 50 Geräten, die Sie im Dashboard abschalten können, während Sie testen.

Kann die QA den Dialog mehr als einmal sehen?

Ja. PromptSurge.SetRateLimitBypass(true) schaltet die Wartezeiten auf diesem Gerät ab. Die Einstellung wird in PlayerPrefs gespeichert und protokolliert bei jeder Prüfung eine Warnung, solange sie aktiv ist; rufen Sie sie also nie in einem Build auf, den Sie ausliefern.

Ist der Pre-Prompt in beiden Stores erlaubt?

Beide Stores verlangen, dass die Bewertung selbst in ihrem eigenen Dialog stattfindet, und das SDK öffnet immer nur diese: StoreKit auf iOS, Play In-App Review auf Android, beide unverändert. Apples Richtlinie 5.6.1 lässt eigene Bewertungs-Prompts nicht zu, und Google bittet Apps, Nutzern vor seiner Karte keine Fragen zu stellen. Der Pre-Prompt fragt nie, wie der Spieler das Spiel findet oder wie er bewerten würde, und ein Titel, der als Aussage formuliert ist, stellt überhaupt keine Frage. Beide Stores raten außerdem davon ab, ihren Dialog per Button-Tipp zu öffnen, weil ihre Limits dazu führen können, dass er nicht erscheint; aktuelle SDK-Versionen lassen den Pre-Prompt aus, wo dieses Limit wahrscheinlich erreicht ist, getrennt für iOS und Android. Wie jeder Store ein bestimmtes Spiel prüft, entscheidet der jeweilige Store.

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

Was kostet es?

Der Indie-Plan ist für immer kostenlos: eine App und 500 Pre-Prompt-Impressionen pro Monat, keine Kreditkarte. Startup kostet 39 € pro App und Monat (31 € bei jährlicher Abrechnung) für 10.000 Impressionen pro Monat und ein eigenes Kopfbild. Growth kostet 99 € und Unlimited 249 € pro App und Monat. Jede App hat ihren eigenen Plan; der Plan bestimmt, wie viele Apps Ihre Organisation anlegen kann. Eine Prompt-Impression ist ein angezeigter Pre-Prompt; native Bewertungsdialoge und Geräte der Kontrollgruppe werden nicht gezählt. Preise in EUR, inkl. MwSt.

Ein Aufruf nach Ihrem Level, der Rest im Dashboard

Kostenloser Plan, keine Kreditkarte. Legen Sie ein Spiel an, kopieren Sie seinen API-Schlüssel und erstellen Sie einen Build für ein Gerät.

Kostenloses Konto erstellen →

Sie haben bereits ein Konto? Anmelden