API In-App Review de Google Play : règles et limites

L'API permet aux utilisateurs de noter ton app sans la quitter. Google la décrit comme un moyen de "prompt users to submit Play Store ratings and reviews without the inconvenience of leaving your app or game." (inviter les utilisateurs à soumettre des notes et avis sur le Play Store sans la gêne de quitter ton app ou ton jeu). L'utilisateur choisit de 1 à 5 étoiles et peut ajouter un commentaire ; une fois envoyé, l'avis part sur le Play Store.

Pourquoi la fenêtre peut ne pas s'afficher

• Un quota existe. Google indique qu'il "enforces a time-bound quota on how often a user can be shown the review dialog" (applique un quota limité dans le temps sur la fréquence d'affichage de la fenêtre d'avis à un utilisateur). Appeler launchReviewFlow plus d'une fois sur une courte période (par exemple moins d'un mois) "might not always display a dialog" (peut ne pas toujours afficher de fenêtre). La valeur "can be changed by Google Play without any notice." (peut être modifiée par Google Play sans préavis.)
• Tu n'obtiens aucun résultat. Le guide Kotlin/Java indique que l'API "does not indicate whether the user reviewed or not, or even whether the review dialog was shown." (n'indique pas si l'utilisateur a noté ou non, ni même si la fenêtre a été affichée.) Continue ton parcours normal dans les deux cas, et n'affiche aucune erreur à l'utilisateur si le parcours échoue.
• Prérequis. Android 5.0 (API 21) ou plus récent avec le Play Store installé, et Play Core 1.8.0 ou plus récent, selon la page de présentation au moment de la consultation.

Règles d'utilisation

• Déclenche-la après que l'utilisateur a assez utilisé l'app pour donner un retour utile, et ne la sollicite pas trop.
• Ne pose aucune question avant ou pendant l'affichage de la carte, y compris « Tu aimes l'app ? ».
• Affiche la carte telle quelle : ni taille, opacité ou forme modifiées, pas de superposition, et ne la retire pas par programmation.
• Ne propose pas de bouton qui déclenche l'API. Redirige vers le Play Store dans ce cas.
• Demande l'objet ReviewInfo à l'avance seulement lorsque tu es sûr de lancer le parcours ; il expire.

Sur les récompenses : les pages que j'ai lues n'en parlent pas. Les notes récompensées ne sont pas une option ; voir acheter des avis d'applis pour la politique Play.

Concevoir autour du quota

1. Choisis un ou deux moments clés (après une tâche terminée) et arrête-toi là.
2. Ne construis jamais de logique qui dépend de l'affichage effectif de la fenêtre.
3. Pour une entrée dans les réglages, renvoie vers ta fiche Play.
4. Recueille les retours privés séparément : demander des retours, pas des avis.

Tests

Google indique que tu peux tester sans publier en production, via une piste de test interne ou le partage interne d'applications. Les limites de quota ne s'appliquent pas aux apps téléchargées depuis la piste de test interne. Avec le partage interne d'applications, les avis ne peuvent pas être envoyés. Les conditions (compte dans la piste, compte principal du Play Store, aucun avis existant) figurent sur la page de test de Google. Voir aussi pourquoi les avis des testeurs restent privés.

Google peut tout changer. Vérifie de nouveau les pages ci-dessus avant chaque publication. Pas un conseil juridique.

Commence gratuitement.

Liens : guide, pourquoi les avis des testeurs restent privés, avis publiés par les développeurs sur les pages d'app, design de l'invite.