PromptSurge

SDK Android

Avis in-app sur Android avec l'API In-App Review de Google Play

PromptSurge pour Android est une bibliothèque Kotlin qui affiche une courte pré-invite à votre image, puis lance le flux In-App Review de Google Play lorsque l'utilisateur confirme. Deux appels dans votre code ; le texte, le thème, l'image d'en-tête et les langues viennent du serveur.

Plan gratuit · minSdk 24 · JitPack

1 · Votre pré-invite

Votre image d'en-tête

Un petit service

Nous avons beaucoup travaillé sur la synchronisation hors ligne. Un court avis aide d'autres personnes à découvrir l'app.

Pas maintenantLaisser un avis

2 · La fiche de notation native

App Store ou Google Play

La fiche d'Apple ou de Google, affichée sans modification

Pas maintenant ferme le dialogue et n'affiche rien d'autre.

Ce que le SDK Android fait pour vous

La carte d'avis de Play

À la confirmation, le SDK exécute requestReviewFlow() et launchReviewFlow() de ReviewManager. La carte est celle de Google, affichée telle quelle ; la pré-invite est déjà fermée, et c'est le quota de Play qui décide si la carte apparaît.

S'adapte à tous les thèmes d'app

Le dialogue est en Material 3. Avec un thème Material, il hérite de votre style ; avec AppCompat, un thème de la plateforme ou un thème de jeu personnalisé, il bascule sur son propre thème intégré au lieu de planter. Les couleurs du tableau de bord sont appliquées par-dessus.

Sûr dans les apps en production

minSdk 24, aucune permission à l'exécution, rien d'ajouté à votre manifeste, règles R8 livrées dans l'AAR. requestReview() ne fait rien si l'activité est en cours de fermeture, si son état est déjà sauvegardé ou si le dialogue est déjà affiché.

Toutes les vérifications d'éligibilité intégrées

L'opt-out, un délai de répétition de 90 jours par appareil, le groupe de contrôle de 10 %, la phase de démarrage de 50 appareils et le plafond mensuel de votre plan sont vérifiés en premier. Quand la pré-invite est retenue pour la phase de démarrage, le groupe de contrôle ou un plafond atteint, le flux d'avis de Play se lance quand même, pour que le moment ne soit pas perdu.

Réponses Data Safety incluses

Le seul identifiant est le SHA-256 de ANDROID_ID et de votre nom de package, jamais l'ID brut, et aucun identifiant publicitaire n'est utilisé. Le README liste exactement ce qu'il faut déclarer dans le formulaire Data Safety de Play.

L'intégration

Ajoutez JitPack et une dépendance Gradle (les coordonnées et la version actuelle sont dans la documentation), initialisez dans votre Application, puis appelez requestReview() au moment choisi.

Application.onCreate()

import com.promptsurge.sdk.PromptSurge

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

Au moment choisi

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

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

Pendant l'intégration, PromptSurge.setLogLevel(PromptSurge.LogLevel.INFO) affiche une ligne par décision. La carte de Play est limitée par un quota et n'affiche souvent rien sur un build de debug : une carte invisible y est donc normale.

Voir la documentation d'intégration →

Sur le téléphone

Ce que voit votre utilisateur, en trois étapes

Les mêmes utilisateurs, le même moment. La différence : on leur demande d'abord, avec des mots qui parlent de votre app.

  1. Voyage enregistré

    Disponible hors ligne

    requestReview()

    Étape 1

    Votre code choisit le moment

    Appelez requestReview() juste après quelque chose de réussi, comme un voyage enregistré ou un niveau terminé.

  2. Un petit service

    Nous avons beaucoup travaillé sur les cartes hors ligne. Un court avis aide d'autres voyageurs à trouver cette app.

    Plus tardD'accord

    Étape 2

    Le pré-prompt demande avec vos mots

    Un court message qui nomme ce que fait votre app. Plus tard le ferme, et rien d'autre ne se passe.

  3. Noter cette app

    Touchez une étoile pour noter

    Un avis qui nomme la fonction

    Les cartes hors ligne ont sauvé mon voyage. Ça marche sans réseau.

    Étape 3

    La fenêtre de notation du store

    Un oui ouvre la fenêtre du store, inchangée. Le message qu'ils viennent de lire leur donne quelque chose de précis à écrire.

Ce pour quoi il est conçu

  1. Plus d'avis des mêmes utilisateurs

    On leur demande à un moment que vous avez choisi, avec une raison de répondre.

  2. Plus d'avis écrits

    Un message sur une fonction invite à écrire, pas seulement à mettre des étoiles.

  3. Vos mots-clés dans leurs mots

    Les avis qui nomment ce que fait votre app disent au prochain visiteur à qui elle s'adresse.

  4. Un signal que lisent les stores

    Apple et Google disent tous deux que les notes et les avis comptent dans le classement des apps dans la recherche.

Votre tableau de bord montre ce qui a changé pour votre app : avis écrits par jour, étoiles et mentions de mots-clés, avant le pré-prompt et avec lui.

Sources: Apple : recherche sur l'App Store · Google Play : découverte et classement des apps

Comment ça marche

  1. Ajoutez le SDK

    Installez le package iOS, Android ou Unity et appelez initialize() une fois au lancement. Appelez ensuite requestReview() au moment que vous choisissez, par exemple un niveau terminé, un projet enregistré ou une commande finalisée.

  2. Personnalisez la pré-invite

    Dans le tableau de bord, rédigez le titre, le message et les deux libellés de boutons, ou laissez l'IA intégrée les rédiger à partir de vos propres avis. Choisissez un thème, ajoutez une image d'en-tête à partir de Startup, et acceptez : le texte est traduit en 10 langues et atteint les appareils sans mise à jour de l'app.

  3. Comparez avec le groupe de contrôle

    10 % des appareils ne voient jamais la pré-invite et reçoivent directement la fiche native aux mêmes moments. Le tableau de bord place les deux groupes côte à côte et relève chaque jour votre note et votre nombre de notes sur le store.

Mesuré face à un groupe de contrôle, pas supposé

Chaque app a un groupe de contrôle. 10 % des appareils y sont affectés à vie et ne voient jamais la pré-invite : quand ils atteignent le moment que vous avez choisi, la fiche native se déclenche directement, comme elle le ferait sans PromptSurge. Une nouvelle app commence aussi par une phase de démarrage de 50 appareils avec la seule fiche native, pour qu'une référence existe avant l'affichage de la première pré-invite.

Le tableau de bord compare les deux groupes sur tous les appareils qui ont atteint votre moment de demande d'avis : combien ont vu la pré-invite, combien ont appuyé pour continuer, combien de fiches natives ont été demandées. Il ne rend pas de verdict tant que chaque groupe ne compte pas au moins 50 appareils.

Une limite honnête : Apple et Google n'indiquent jamais à une app si un utilisateur a noté ni ce qu'il a écrit. C'est pourquoi, à côté de l'entonnoir, PromptSurge relève une fois par jour votre note et votre nombre de notes sur le store et en montre l'évolution. C'est un total du store, qui n'est attribué à aucune demande en particulier, et le tableau de bord le précise.

Groupe de contrôle de 10 %

Attribué par appareil, à vie. La fiche native se déclenche directement aux mêmes moments.

Phase de démarrage de 50 appareils

Une nouvelle app commence avec la seule fiche native, pour que la référence vienne en premier.

Relevé quotidien des stores

Votre note moyenne et votre nombre de notes sur chaque store, une fois par jour, pour les apps avec un lien store.

Questions fréquentes

Quelles versions d'Android sont prises en charge ?

minSdk 24 (Android 7.0) et versions ultérieures, Kotlin 1.9 ou ultérieur, distribué via JitPack. Le dialogue a besoin d'androidx.fragment, qu'appcompat inclut déjà.

Quel est le lien entre la pré-invite et les consignes de Google Play sur les avis in-app ?

Google demande aux apps d'afficher sa carte d'avis telle quelle, sans rien superposer, et de ne poser aucune question à l'utilisateur avant ou pendant son affichage, en citant les questions d'opinion (« Vous aimez l'app ? ») et les questions prédictives (« Donneriez-vous 5 étoiles à cette app ? »). PromptSurge ne modifie ni ne recouvre jamais la carte de Play, son dialogue est fermé avant que la carte ne s'ouvre, et ses textes par défaut et générés sont des affirmations qui demandent un avis, jamais une question. Le guide de Google indique aussi que les apps ne devraient pas proposer de bouton d'appel à l'action qui déclenche le flux d'avis, car son quota peut empêcher la carte d'apparaître ; le bouton de confirmation d'une pré-invite est un tel bouton, alors évaluez cette recommandation pour votre app. Dans les versions actuelles du SDK, PromptSurge n'affiche pas sa pré-invite sur un appareil dans les 30 jours qui suivent sa dernière demande de la carte de Play, ce qui réduit ce risque sans pouvoir le supprimer, car Google ne publie pas son quota. Si vous rédigez vos propres textes, formulez le titre comme une affirmation, comme l'exemple de cette page ; le tableau de bord vous avertit de toute question.

Ce que disent les stores, et une note pour l'App Review (documentation en anglais) →

Le bouton Pas maintenant consomme-t-il le quota de Play ?

Non. Pas maintenant ne lance aucun flux d'avis. Seuls une confirmation, ou les cas où seule la carte native est lancée (phase de démarrage, groupe de contrôle, plafond du plan atteint), appellent l'API In-App Review.

Pourquoi rien n'apparaît sur mon appareil de test ?

Généralement à cause de la phase de démarrage : une nouvelle app reste sur la seule carte de Play jusqu'à ce que 50 appareils distincts aient atteint le moment de demande d'avis. Désactivez-la pour l'app dans le tableau de bord pendant vos tests. La carte de Play est elle-même limitée par un quota et reste souvent masquée sur les builds de debug.

Que dois-je déclarer dans Data Safety ?

Device or other IDs, et App activity > App interactions : collectées, non partagées, pour l'analytique, non liées à l'utilisateur, en plus de ce que collecte le reste de votre app. Le README explique chaque réponse.

Deux appels dans votre app Android, le reste dans le tableau de bord

Plan gratuit, sans carte bancaire. Créez une app, copiez sa clé API et publiez.

Créer votre compte gratuit →

Vous avez déjà un compte ? Connexion