PromptSurge

Android-SDK

Android In-App-Review mit der In-App Review API von Google Play

PromptSurge für Android ist eine Kotlin-Bibliothek, die einen kurzen Pre-Prompt mit Ihrem Branding zeigt und dann den In-App-Review-Ablauf von Google Play startet, wenn der Nutzer bestätigt. Zwei Aufrufe in Ihrem Code; Texte, Theme, Kopfbild und Sprachen kommen vom Server.

Kostenloser Plan · minSdk 24 · JitPack

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

Die eigene Bewertungskarte von Play

Bei Bestätigung führt das SDK requestReviewFlow() und launchReviewFlow() von ReviewManager aus. Die Karte ist die von Google und wird so angezeigt, wie sie ist; der Pre-Prompt ist dann schon geschlossen, und das eigene Kontingent von Play entscheidet, ob die Karte erscheint.

Passt zu jedem App-Theme

Der Dialog ist Material 3. Mit einem Material-Theme übernimmt er Ihren Look; mit AppCompat-, Plattform- oder eigenen Spiele-Themes greift er auf sein mitgeliefertes Theme zurück, statt abzustürzen. Die Farben aus dem Dashboard werden darüber angewendet.

Sicher in Produktions-Apps

minSdk 24, keine Laufzeitberechtigungen, nichts wird Ihrem Manifest hinzugefügt, R8-Regeln werden im AAR mitgeliefert. requestReview() tut nichts, wenn die Activity gerade beendet wird, ihr Zustand bereits gespeichert ist oder der Dialog schon angezeigt wird.

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, startet der Bewertungsablauf von Play trotzdem, sodass der Moment nicht verloren geht.

Antworten für Data Safety inklusive

Die einzige Kennung ist SHA-256 aus ANDROID_ID plus Ihrem Paketnamen, nie die rohe ID, und es wird keine Werbe-ID verwendet. Die README listet genau auf, was Sie im Data Safety-Formular von Play angeben.

Die Integration

Fügen Sie JitPack und eine Gradle-Abhängigkeit hinzu (Koordinaten und aktuelle Version stehen in der Dokumentation), initialisieren Sie in Ihrer Application und rufen Sie dann requestReview() in Ihrem Moment auf.

Application.onCreate()

import com.promptsurge.sdk.PromptSurge

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        PromptSurge.initialize(this, "ps_live_your_key_here")
    }
}

In Ihrem Moment

// In an Activity (AppCompatActivity works)
PromptSurge.requestReview(this)

// Or from a Fragment
PromptSurge.requestReview(requireActivity())

Während der Integration gibt PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) eine Zeile pro Entscheidung aus. Die Karte von Play ist kontingentbegrenzt und zeigt auf einem Debug-Build oft nichts an; eine unsichtbare Karte ist dort also normal.

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

minSdk 24 (Android 7.0) und neuer, Kotlin 1.9 oder neuer, verteilt über JitPack. Der Dialog benötigt androidx.fragment, das appcompat bereits mitbringt.

Wie verhält sich der Pre-Prompt zu den Richtlinien von Google Play für In-App-Reviews?

Google bittet Apps, seine Bewertungskarte unverändert und ohne Überlagerung anzuzeigen und dem Nutzer vor oder während der Anzeige keine Fragen zu stellen; genannt werden Meinungsfragen („Gefällt Ihnen die App?“) und prädiktive Fragen („Würden Sie diese App mit 5 Sternen bewerten?“). PromptSurge verändert oder überlagert die Karte von Play nie, sein Dialog ist geschlossen, bevor sich die Karte öffnet, und seine Standardtexte und generierten Texte sind Aussagen, die um eine Bewertung bitten, nie eine Frage. Laut Googles Leitfaden sollten Apps außerdem keinen Call-to-Action-Button anbieten, der den Bewertungsablauf auslöst, weil das Kontingent verhindern kann, dass die Karte erscheint; der Bestätigen-Button eines Pre-Prompts ist ein solcher Button, wägen Sie diesen Hinweis also für Ihre App ab. In aktuellen SDK-Versionen lässt PromptSurge seinen Pre-Prompt auf einem Gerät innerhalb von 30 Tagen nach seiner letzten Anforderung der Play-Karte aus. Das senkt dieses Risiko, kann es aber nicht beseitigen, weil Google sein Kontingent nicht veröffentlicht. Wenn Sie eigene Texte schreiben, formulieren Sie den Titel als Aussage wie im Beispiel auf dieser Seite; das Dashboard warnt Sie vor jeder Frage.

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

Verbraucht „Nicht jetzt“ das Kontingent von Play?

Nein. „Nicht jetzt“ startet überhaupt keinen Bewertungsablauf. Nur eine Bestätigung oder die rein nativen Pfade für die Aufwärmphase, die Kontrollgruppe und ein aufgebrauchtes Plan-Limit rufen die In-App Review API auf.

Warum erscheint auf meinem Testgerät nichts?

Meist liegt es an der Aufwärmphase: Eine neue App bleibt allein bei der Karte von Play, bis 50 verschiedene Geräte den Bewertungsmoment erreicht haben. Schalten Sie sie für die App im Dashboard ab, während Sie testen. Die Karte von Play ist außerdem kontingentbegrenzt und bleibt auf Debug-Builds oft verborgen.

Was gebe ich bei Data Safety an?

Device or other IDs sowie App activity > App interactions: erhoben, nicht geteilt, für Analytics, nicht mit dem Nutzer verknüpft, zusätzlich zu allem, was der Rest Ihrer App erhebt. Die README erklärt jede Antwort.

Zwei Aufrufe in Ihrer Android-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