Google Play In-App Review et In-App Updates en 2026
Deux fonctionnalités de Play Core décident discrètement si votre application continue de progresser toute seule sur sa fiche App Store. L'API d'avis intégrée permet à un utilisateur de noter et d'évaluer votre application sans jamais la quitter. Les mises à jour intégrées vous permettent de proposer à un utilisateur actif de passer à une version plus récente sans passer par le Play Store. Bien utilisées, elles font grimper les notes et réduisent la part d'utilisateurs bloqués sur une ancienne version. Utilisées à la légère, elles agacent les gens, consomment un quota invisible et vous rapportent des tickets d'assistance au lieu de signal.
Ce tutoriel parcourt les deux API dans l’ordre dans lequel vous les implémentez réellement : prérequis, moment de la requête, limites de conception, chemin de code, puis test sur matériel réel. Tout ce qui suit respecte le comportement documenté de Play Core de Google, et deux règles encadrent l’ensemble — vous ne pouvez pas forcer l’affichage d’une boîte de dialogue d’avis, et vous ne pouvez pas promettre qu’une mise à jour s’installera selon votre calendrier. Play décide des deux. Votre rôle est de demander au bon moment, avec le bon type de flux, et de maintenir l’application fonctionnelle lorsque la réponse est non.
1. Ce que fait chaque API — et ce qu’elle ne fait délibérément pas
Le parcours d’avis intégré permet à votre application d’afficher une carte de notation Play Store. L’utilisateur peut laisser de 1 à 5 étoiles et un commentaire facultatif, et l’avis est envoyé au Play Store puis finit par s’afficher. Ce que vous n’obtenez pas, c’est un retour sur votre propre demande : l’API n’indique ni si l’utilisateur a laissé un avis, ni même si la boîte de dialogue a été affichée. Aucune valeur sur laquelle brancher, aucun nombre d’étoiles à lire, et aucun moyen de réafficher la carte à la demande.
Les mises à jour intégrées invitent les utilisateurs actifs à installer une version plus récente. Ce n'est pas un interrupteur de télécommande : les installations ne sont jamais silencieuses, les redémarrages ne sont jamais forcés, et les mises à jour ne vont que vers un code de version supérieur. Ce que vous contrôlez, c'est le type de flux — flexible ou immédiat — et la force de votre recommandation, via la priorité de mise à jour associée à la version. Tout le reste relève de la décision de Play.
Un détail de plus à connaître avant de concevoir l’interface : si votre application se trouve sur un canal de test fermé, la note et le commentaire recueillis via le parcours d’avis vous sont communiqués en privé en tant que développeur au lieu d’être publiés. Utile pour répéter, mais ce ne sont pas les mêmes données que les notes publiques.
2. Exigences à vérifier avant tout code
- Les avis intégrés à l’application fonctionnent sur les appareils Android (téléphones, tablettes et téléviseurs avec Google TV) sous Android 5.0 (niveau d’API 21) ou supérieur disposant du Google Play Store, ainsi que sur les appareils ChromeOS disposant du Play Store.
- L'intégration des avis nécessite la version 1.8.0 ou supérieure de la bibliothèque Play Core ; le guide d'intégration actuel utilise
com.google.android.play:review:2.0.2, pluscom.google.android.play:review-ktx:2.0.2pour Kotlin. - Les mises à jour intégrées sont prises en charge sur Android 5.0 (niveau d’API 21) ou supérieur, et uniquement sur les téléphones Android, les tablettes Android et ChromeOS. Elles ne sont pas compatibles avec les applications qui utilisent des fichiers d’expansion APK (
.obb). - L’intégration des mises à jour utilise
com.google.android.play:app-update:2.1.0, ainsi quecom.google.android.play:app-update-ktx:2.1.0pour Kotlin.
Deux conséquences en découlent. Si votre application livre des fichiers d'extension, les mises à jour intégrées sont exclues et vous invitez à mettre à jour via la fiche App Store. Et sur un appareil sans Play Store, les deux API ne font tout simplement rien — elles échouent, en silence. Conditionnez donc votre interface au résultat de votre propre appel de requête plutôt que de supposer que la fonctionnalité est disponible.
3. In-app review : les moments où vous êtes autorisé à demander
Les directives de Google sont courtes et strictes. Déclenchez le flux après que l’utilisateur a suffisamment expérimenté l’application ou le jeu pour donner un retour utile — un niveau terminé, un export achevé, une première session réussie. N’incitez pas de manière excessive ; chaque invite inutile consomme le quota décrit ci-dessous et frustre la personne qu’elle était censée satisfaire.
L'interdiction stricte porte sur le questionnement préalable. Votre application ne doit rien demander à l'utilisateur avant ou pendant l'affichage du bouton ou de la carte de notation, y compris des questions d'opinion comme « Aimez-vous l'application ? » et des questions prédictives comme « Noteriez-vous cette application 5 étoiles ? ». Filtrer d'abord les utilisateurs mécontents est exactement ce que la règle vise à empêcher. Si vous voulez votre propre point d'entrée, dirigez-le vers la fiche Play Store — un simple lien qui fonctionne toujours — et réservez l'API aux moments que vous maîtrisez.
4. Examen intégré : les règles de conception auxquelles vous ne pouvez pas déroger
La carte appartient à Play, pas à votre design system. Affichez-la telle quelle : aucune modification de taille, d’opacité, de forme ou de toute autre propriété. Ne placez pas de superposition sur ou autour de la carte, et gardez la carte et son arrière-plan sur la couche la plus haute. Une fois la carte apparue, ne la retirez jamais par programmation — elle est fermée soit par une action explicite de l’utilisateur, soit par un mécanisme interne du Play Store.
Dans le code, attendez la fin du parcours d’examen avant que votre application ne poursuive son chemin normal, par exemple avant de passer au niveau suivant. Si une erreur survient pendant le parcours, ne prévenez pas l’utilisateur et ne modifiez pas votre parcours : continuez normalement dès que le callback de fin est déclenché.
5. Quotas : pourquoi launchReviewFlow n’est pas un simple bouton
Play applique un quota temporel sur la fréquence à laquelle la boîte de dialogue d'avis peut être montrée à un utilisateur ; c'est pourquoi appeler launchReviewFlow plus d'une fois sur une courte période — l'exemple donné par Google est moins d'un mois — peut simplement n'afficher rien du tout. La valeur exacte est un détail d'implémentation et peut changer sans préavis.
Comme le quota évolue, vous ne pouvez pas concevoir une interface qui présuppose un succès. Un bouton d’appel à l’action dédié qui déclenche l’API est l’anti-modèle que Google signale explicitement : l’utilisateur a peut-être atteint son quota, la fenêtre ne s’affiche jamais et votre bouton semble cassé. Pour un clic délibéré sur « noter », redirigez plutôt vers le Play Store. Réservez l’API aux moments où la demande est attendue et où l’absence de fenêtre passe inaperçue.
6. Examen intégré : le parcours du code, étape par étape
Trois appels, dans cet ordre.
- Créez le manager.
ReviewManagerFactory.create(context)vous fournit leReviewManagerqui lance le parcours. - Préchargez les informations. Appelez
requestReviewFlow(). En cas de succès, vous recevez l'objetReviewInfonécessaire au lancement ; en cas d'échec, lisez leReviewErrorCodedepuis laReviewExceptionet journalisez-le. L'objetReviewInfon'est valide que pendant une durée limitée, demandez-le donc à l'avance mais seulement une fois certain que le flux se lancera. - Lancement.
launchReviewFlow(activity, reviewInfo)affiche la carte. Le callback de fin vous indique que le parcours est terminé — rien de plus. Poursuivez le parcours de votre application quel que soit le résultat.
7. Mises à jour intégrées : flexibles ou immédiates
Il existe deux flux, qui répondent à des questions produit différentes. Les mises à jour flexibles se téléchargent en arrière-plan avec un suivi d’état fluide, de sorte que l’utilisateur continue de travailler pendant que la mise à jour arrive — le bon choix lorsque la nouvelle version ajoute des fonctionnalités ou des gains de performance qui peuvent attendre quelques minutes. Les mises à jour immédiates sont un flux plein écran qui impose à l’utilisateur de mettre à jour et de redémarrer avant de continuer, pour les mises à jour critiques pour les fonctionnalités de base ; une fois que l’utilisateur accepte, Play gère à la fois l’installation et le redémarrage de l’application.
Choisissez le flux le plus simple qui résout le problème réel. L’escalade est légitime — vous pouvez d’abord notifier en douceur et finir par exiger la mise à jour — mais elle relève de votre logique de priorité et d’ancienneté, pas d’une décision prise une fois pour toutes au moment de l’implémentation.
8. Jours d’ancienneté et priorité de mise à jour : comment s’exprime le « à quel point c’est grave »
Deux signaux indiquent à votre application à quel point une mise à jour est en retard.
clientVersionStalenessDays()renvoie le nombre de jours depuis que la mise à jour est disponible sur le Play Store. C’est l’horloge d’escalade naturelle : attendez quelques jours avant une invite flexible, quelques jours de plus avant d’en exiger une immédiate.updatePriority()renvoie la priorité que vous avez attachée à la version — un entier entre 0 (la valeur par défaut) et 5 (la plus élevée). Elle est définie via le champinAppUpdatePrioritysousEdits.tracks.releasesdans l’API Google Play Developer. Toutes les versions nouvellement ajoutées dans une release partagent la priorité de la release, et la priorité ne peut être définie que pendant le déploiement d’une nouvelle release — elle ne peut pas être modifiée ensuite, la valeur doit donc être décidée avant publication.
Une subtilité surprend souvent : la priorité que voit votre application tient compte de tous les codes de version entre la version installée et la plus récente disponible, quel que soit le canal sur lequel chacun a été publié. Publiez la version 1 en production sans priorité, la version 2 sur un canal de test interne avec priorité 5, puis la version 3 en production sans priorité — les utilisateurs de production qui passent de 1 à 3 reçoivent quand même la priorité 5, car la version 2 se trouve entre les deux.
Notez aussi la limite : inAppUpdatePriority n’est pas pris en charge lorsque vous envoyez un build vers le partage d’applications interne, donc un comportement dépendant de la priorité ne peut pas être répété de cette façon.
9. Lancer le flux de mise à jour et lire le résultat
Vérifiez d’abord la disponibilité. Créez un AppUpdateManager avec AppUpdateManagerFactory.create(context), lisez appUpdateInfo, confirmez que updateAvailability() renvoie UPDATE_AVAILABLE, et vérifiez que le type de flux que vous comptez utiliser est autorisé avec isUpdateTypeAllowed(). Appelez ensuite seulement startUpdateFlowForResult() avec un lanceur de résultat d’activité enregistré pour le contrat intégré StartIntentSenderForResult.
Chaque instance AppUpdateInfo ne peut lancer qu’une seule mise à jour. Si la mise à jour échoue et que vous voulez réessayer, demandez un nouveau AppUpdateInfo et vérifiez à nouveau la disponibilité et l’autorisation. Le callback renvoie RESULT_OK (acceptée), RESULT_CANCELED (refusée) ou RESULT_IN_APP_UPDATE_FAILED (autre chose a bloqué le consentement ou la mise à jour). Avec les mises à jour immédiates, vous ne verrez peut-être jamais RESULT_OK, car la mise à jour est généralement terminée avant que le contrôle ne revienne à votre application.
AppUpdateOptions porte aussi un indicateur AllowAssetPackDeletion, faux par défaut, qui permet à une mise à jour de supprimer des packs d’assets lorsque le stockage de l’appareil est saturé. Activez-le délibérément : vérifiez d’abord si la mise à jour réussit avec l’indicateur à faux, et n’optez pour l’activation qu’ensuite, car cet indicateur existe précisément pour supprimer des assets.
10. Mises à jour flexibles : surveiller, télécharger, puis redémarrer
Enregistrez un InstallStateUpdatedListener avant de lancer le flux et désenregistrez-le lorsque vous n’avez plus besoin des mises à jour. Pendant que l’état est DOWNLOADING, vous pouvez lire bytesDownloaded() et totalBytesToDownload() pour afficher une progression réelle. Lorsque l’état atteint DOWNLOADED, Play ne redémarre pas l’application à votre place — c’est tout l’intérêt d’un flux flexible. Affichez une notification ou un snackbar, laissez l’utilisateur confirmer, puis appelez completeUpdate() lorsqu’il le fait.
L'endroit où cet appel se produit change l'expérience. Au premier plan, la plateforme affiche une interface plein écran et redémarre l'application en arrière-plan ; en arrière-plan, la mise à jour s'installe silencieusement. Dans les deux cas, vérifiez à chaque point d'entrée dans l'application — onResume() est l'endroit habituel — si une mise à jour se trouve encore à l'état DOWNLOADED, et proposez-la à nouveau le cas échéant. Sinon, les octets téléchargés continuent d'occuper le stockage de l'utilisateur sans jamais être installés.
11. Mises à jour immédiates : relancer un flux bloqué
Une fois que l’utilisateur accepte une mise à jour immédiate, Play affiche la progression par-dessus votre interface pendant toute la durée, et si l’utilisateur ferme ou quitte l’application, le téléchargement et l’installation se poursuivent en arrière-plan. C’est pratique pour la mise à jour et délicat pour votre code : votre application peut revenir au premier plan dans un état où le flux ne s’est jamais formellement terminé.
Gérez cela dans onResume(). Si updateAvailability() renvoie DEVELOPER_TRIGGERED_UPDATE_IN_PROGRESS, appelez à nouveau startUpdateFlowForResult() pour reprendre. Lorsque l’utilisateur refuse ou annule, l’interface Play se ferme et votre application doit choisir : si elle peut fonctionner sans la mise à jour, laissez-le continuer et redemandez plus tard ; si elle ne le peut vraiment pas, dites-le clairement avant de relancer le flux, pour que la relance soit comprise plutôt que vécue comme une boucle de plantage.
12. Tester les deux API sur des appareils réels
La plupart des intégrations « défaillantes » sont des artefacts de test. Pour les mises à jour intégrées, le partage d’application interne est la voie standard : assurez-vous que l’appareil de test dispose d’une build prenant en charge les mises à jour intégrées, installée depuis une URL de partage d’application interne, importez une version avec un code de version supérieur, ouvrez le lien de partage de la nouvelle version sur l’appareil sans installer depuis la page Play qui s’affiche, puis lancez l’application depuis le lanceur — la mise à jour devrait alors être proposée à votre application.
Si ce n’est toujours pas le cas, vérifiez les quatre causes habituelles : le compte doit posséder l’application, c’est-à-dire l’avoir téléchargée au moins une fois depuis Play ; le build de test doit partager l’identifiant d’application et la clé de signature avec la version Play ; le code de version installé doit être inférieur à celui de la mise à jour ; et inAppUpdatePriority n’est pas pris en charge par le partage d’application interne, si bien que les flux pilotés par la priorité y sont différents.
Pour les avis, la différence pratique réside dans ce que voit le testeur. Sur un canal de test fermé, la note et le commentaire recueillis sont transmis en privé au développeur au lieu d’apparaître publiquement — utile pour vérifier votre intégration et le timing, mais pas représentatif d’une évolution réelle des notes.
13. Ce qu’il faut surveiller une fois les deux en ligne
Les invitations à noter doivent faire évoluer le volume d’avis progressivement, jamais par un pic qui coïncide avec une version : un pic est un effet de calendrier, pas un changement de qualité, et la cause habituelle est une invitation placée trop tôt dans la session. Pour les mises à jour, suivez semaine après semaine la part d’utilisateurs actifs sur le dernier code de version : une mise à jour flexible doit faire croître ce chiffre sans toucher à votre note moyenne, et elle doit réduire le nombre de rapports de bugs provenant des anciens builds.
Si les invites coïncident avec des désinstallations, ou avec des commentaires mécontents à une étoile, la solution n’est pas d’inviter plus souvent ni plus tôt dans le cycle de vie de l’installation. Déplacez le déclencheur plus loin dans le parcours utilisateur, là où la valeur de l’application a déjà été démontrée.
Vous gérez des comptes développeur à grande échelle ? Nous prenons en charge le volet opérationnel.
Nous avons bien reçu votre message et vous répondrons sous 24 heures.
← Retour à la modification