SDK iOS
Demande d'avis iOS pour SKStoreReviewController et requestReview
PromptSurge pour iOS est un package Swift qui affiche une courte pré-invite à votre image, puis appelle la demande d'avis de StoreKit 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 · iOS 14+ · Swift Package Manager
1 · Votre pré-invite
Un petit service
Nous avons beaucoup travaillé sur la synchronisation hors ligne. Un court avis aide d'autres personnes à découvrir l'app.
2 · La fiche de notation native
App Store ou Google Play
La fiche d'Apple ou de Google, affichée sans modification
Ce que le SDK iOS fait pour vous
La fiche d'avis de StoreKit
À la confirmation, le SDK demande à StoreKit sa fiche d'avis avec votre UIWindowScene : les versions actuelles du SDK appellent AppStore.requestReview(in:) à partir d'iOS 16, et SKStoreReviewController.requestReview(in:) avant. iOS décide si la fiche apparaît, jusqu'à trois fois par an et par appareil ; le SDK ne dessine jamais d'étoiles et ne collecte jamais de note lui-même.
UIKit et SwiftUI
Passez n'importe quel view controller de présentation ; depuis SwiftUI, transmettez votre view controller racine. Le dialogue est une carte UIKit créée par programmation, qui respecte la safe area et fait défiler les textes longs.
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 avant tout affichage. Quand la pré-invite est retenue pour la phase de démarrage, le groupe de contrôle ou un plafond atteint, la demande native se déclenche quand même, pour que le moment ne soit pas perdu.
Pas de demande ATT, manifeste de confidentialité inclus
Le seul identifiant est un hash SHA-256 salé de identifierForVendor et de votre bundle ID ; pas d'IDFA ni de demande App Tracking Transparency. PrivacyInfo.xcprivacy est livré dans le package, et le README vous donne les réponses pour App Privacy.
Affiché sans attendre
Appelez prefetch() au lancement et le texte est mis en cache sur l'appareil : requestReview(in:) peut ainsi afficher le dialogue sans aller-retour réseau.
L'intégration
Ajoutez le package dans Xcode (File > Add Package Dependencies, puis collez l'URL ci-dessous et choisissez le produit PromptSurge). Initialisez une fois, puis appelez requestReview(in:) au moment choisi. Toutes les étapes, y compris Package.swift, sont dans la documentation.
URL du package
https://github.com/PromptSurge-SDK/sdk-iosPoint d'entrée de l'app (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() }
}
}Au moment choisi (UIKit)
import PromptSurge
class CheckoutViewController: UIViewController {
private func onPurchaseSuccess() {
PromptSurge.requestReview(in: self)
}
}Pendant l'intégration, PromptSurge.setLogLevel(.info) affiche une ligne par décision, y compris la phase de démarrage qui maintient une nouvelle app sur la fiche native pour ses 50 premiers appareils.
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.
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é.
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.
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
Plus d'avis des mêmes utilisateurs
On leur demande à un moment que vous avez choisi, avec une raison de répondre.
Plus d'avis écrits
Un message sur une fonction invite à écrire, pas seulement à mettre des étoiles.
Vos mots-clés dans leurs mots
Les avis qui nomment ce que fait votre app disent au prochain visiteur à qui elle s'adresse.
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
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.
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.
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'iOS sont prises en charge ?
iOS 14 et versions ultérieures, compilé avec Xcode 14 ou ultérieur, installé avec Swift Package Manager.
Une pré-invite est-elle autorisée par la directive 5.6.1 de l'App Store ?
La directive 5.6.1 indique qu'il faut utiliser l'API d'Apple pour demander des avis et qu'Apple interdira les demandes d'avis personnalisées. PromptSurge ne collecte jamais de note lui-même : les étoiles et le texte de l'avis passent toujours par la fiche d'Apple, demandée via StoreKit. Le dialogue qui la précède est une courte sollicitation qui ne demande jamais à l'utilisateur ce qu'il ressent. La documentation StoreKit d'Apple dit aussi de ne pas appeler requestReview en réponse à l'appui sur un bouton, car le système peut ne pas afficher la fiche ; avec une pré-invite, c'est l'appui de l'utilisateur sur le bouton de confirmation qui la demande. Dans les versions actuelles du SDK, PromptSurge cesse d'afficher sa pré-invite sur un appareil dès qu'il y a demandé la fiche d'Apple trois fois en 365 jours, la limite d'Apple elle-même, si bien qu'un oui reste moins souvent sans suite. La manière dont Apple examine une app donnée relève de la décision d'Apple : gardez donc tout texte que vous rédigez vous-même sous la forme d'une simple affirmation, et pensez à décrire la pré-invite dans vos notes pour l'App Review ; le tableau de bord vous avertit lorsqu'un texte pose une question.
Ce que disent les stores, et une note pour l'App Review (documentation en anglais) →La fiche native apparaîtra-t-elle toujours après une confirmation ?
Non, c'est iOS qui décide. StoreKit affiche la demande au maximum trois fois sur 365 jours par appareil et, à quelqu'un qui a déjà noté, seulement pour une nouvelle version au bout d'un an. Dans les versions actuelles du SDK, la pré-invite n'est plus affichée sur un appareil dès que le SDK y a demandé la fiche trois fois en 365 jours. Ni le SDK ni aucun autre code ne peut savoir si elle est apparue ni si l'utilisateur a noté.
Pourquoi rien n'apparaît sur mon appareil de test ?
Presque toujours à cause de la phase de démarrage : une nouvelle app reste sur la seule fiche native jusqu'à ce que 50 appareils distincts aient atteint le moment de demande d'avis. Désactivez la phase de démarrage pour l'app dans le tableau de bord pendant vos tests, et activez setLogLevel(.info) pour voir chaque décision.
Que dois-je déclarer dans App Privacy ?
Identifiers > Device ID et Usage Data > Product Interaction, tous deux pour l'analytique, non liés à l'identité et non utilisés pour le suivi, en plus de ce que collecte le reste de votre app. Le README contient le tableau.
À voir aussi
Commencez gratuitement
Le plan Indie est gratuit à vie : une app, 500 impressions de pré-invite par mois, sans carte bancaire. Les images d'en-tête personnalisées commencent avec Startup, à 39 € par app et par mois. Prix en EUR, TVA incluse.
Deux appels dans votre app iOS, 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