PromptSurge

SDK Unity

Une demande d'avis Unity pour iOS et Android en un seul appel C#

PromptSurge pour Unity est un package UPM qui affiche une courte pré-invite à votre image dans votre jeu, puis ouvre la fiche d'avis native : StoreKit sur iOS, Google Play In-App Review sur Android. Appelez RequestReview() après un niveau ; le texte, le thème, l'image d'en-tête et les langues viennent du serveur.

Plan gratuit · Unity 2022.3 LTS+ · iOS et Android

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 Unity fait pour vous

Les deux stores, un seul appel

PromptSurge.RequestReview() ouvre SKStoreReviewController sur iOS et l'In-App Review de Play sur Android via de petits shims natifs. La dépendance Play se résout automatiquement avec External Dependency Manager, ou avec une ligne Gradle sans lui.

Conçu pour les interfaces de jeu

Le dialogue est un overlay UGUI construit en code, avec vos couleurs et votre image d'en-tête. Il crée un EventSystem si votre scène n'en a pas, se ferme sur un appui en dehors de la carte ou sur le bouton retour d'Android, et reste masqué tant qu'il n'est pas prêt : une image lente ne bloque jamais les entrées.

Silencieux dans l'éditeur

Chaque appel est volontairement sans effet en Play Mode : pas de dialogue, pas de fiche native, aucun événement facturé et rien d'écrit dans PlayerPrefs. Compilez sur un appareil pour le voir.

Prêt pour IL2CPP

Le package fournit link.xml et des attributs [Preserve] : le stripping du code managé en Medium ou High ne supprime pas ce dont le SDK a besoin.

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, la fiche native s'ouvre quand même, pour que le moment ne soit pas perdu.

L'intégration

Ajoutez le package via Window > Package Manager > + > Add package from git URL, avec l'URL à version fixée indiquée dans la documentation. Initialisez ensuite une fois et appelez RequestReview() au moment choisi.

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();
    }
}

Sur Android, la bibliothèque d'avis de Play arrive automatiquement via EDM4U ; sans EDM4U, ajoutez implementation 'com.google.android.play:review:2.0.1' à mainTemplate.gradle. PromptSurge.SetLogLevel(LogLevel.Info) affiche une ligne par décision pendant l'intégration.

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'Unity sont prises en charge ?

Unity 2022.3 LTS et versions ultérieures. Les versions LTS plus anciennes peuvent fonctionner mais n'ont pas été compilées et ne sont pas prises en charge. Les builds Android nécessitent une distribution sur le Play Store et minSdkVersion 21 ; les builds iOS nécessitent iOS 14.

Pourquoi rien ne se passe dans l'éditeur ?

C'est voulu. Chaque point d'entrée est sans effet en Play Mode, pour que les tests ne facturent jamais d'impressions et ne remplissent pas PlayerPrefs. Compilez sur un appareil ; sur une nouvelle app, attendez-vous aussi à la phase de démarrage de 50 appareils, que vous pouvez désactiver dans le tableau de bord pendant vos tests.

L'équipe QA peut-elle voir le dialogue plusieurs fois ?

Oui. PromptSurge.SetRateLimitBypass(true) désactive les délais de répétition sur cet appareil. Le réglage est enregistré dans PlayerPrefs et journalise un avertissement à chaque vérification tant qu'il est actif : ne l'appelez donc jamais dans un build que vous publiez.

La pré-invite est-elle autorisée sur les deux stores ?

Les deux stores exigent que la note elle-même soit donnée dans leur propre fiche, et le SDK n'ouvre jamais que celles-ci : StoreKit sur iOS, Play In-App Review sur Android, toutes deux sans modification. La directive 5.6.1 d'Apple interdit les demandes d'avis personnalisées, et Google demande aux apps de ne poser aucune question aux utilisateurs avant sa carte. La pré-invite ne demande jamais au joueur ce qu'il ressent ni quelle note il donnerait, et un titre formulé comme une affirmation ne pose aucune question. Les deux stores déconseillent aussi d'ouvrir leur fiche par l'appui sur un bouton, car leurs limites peuvent l'empêcher d'apparaître ; les versions actuelles du SDK sautent la pré-invite là où cette limite est probablement atteinte, séparément sur iOS et Android. La manière dont chaque store examine un jeu donné relève de la décision de ce store.

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

Combien ça coûte ?

Le plan Indie est gratuit à vie : une app et 500 impressions de pré-invite par mois, sans carte bancaire. Startup coûte 39 € par app et par mois (31 € en facturation annuelle) pour 10 000 impressions par mois et une image d'en-tête personnalisée. Growth coûte 99 € et Unlimited 249 € par app et par mois. Chaque app a son propre plan ; le plan détermine combien d'apps votre organisation peut créer. Une impression de pré-invite correspond à une pré-invite affichée ; les fiches d'avis natives et les appareils du groupe de contrôle ne sont pas comptés. Prix en EUR, TVA incluse.

Un appel après votre niveau, le reste dans le tableau de bord

Plan gratuit, sans carte bancaire. Créez un jeu, copiez sa clé API et compilez sur un appareil.

Créer votre compte gratuit →

Vous avez déjà un compte ? Connexion