Les outils et ressources suivants vous aideront à exploiter tout le potentiel de l'API Play Integrity dans le cadre de votre stratégie de lutte contre les abus.
Surveiller l'état de l'API Play Integrity
Le tableau de bord d'état Play affiche des informations sur l'état de l'API Play Integrity. Celles-ci indiquent l'état du service, y compris les perturbations et les interruptions. Si le problème que vous rencontrez n'est pas signalé, veuillez contacter l'assistance pour les développeurs Google Play support.
Tester différentes réponses de l'API Play Integrity dans votre application
Vous pouvez créer des tests pour évaluer comment l'API Play Integrity interagit avec votre application. Pour les adresses e-mail que vous spécifiez, vous pouvez sélectionner les évaluations d'intégrité ou le code d'erreur qu'elles doivent recevoir des serveurs Google Play dans votre application. Vous pouvez ainsi tester la réaction de votre application à toutes les réponses et erreurs possibles.
Vous pouvez configurer un test dans la Play Console. Accédez à Protégé avec Play dans le menu de gauche. À côté de l'API Play Integrity, cliquez sur Gérer , puis recherchez Tests pour commencer. Pour obtenir des instructions détaillées, consultez le Centre d'aide de la Play Console.
Notez que pour les réponses test, un champ testingDetails supplémentaire apparaît dans la
charge utile renvoyée.
"testingDetails": { "isTestingResponse": true }
Analyser les réponses de l'API Play Integrity que reçoit votre application
Vous pouvez accéder aux rapports de l'API Play Integrity dans la Play Console pour comprendre les réponses que reçoit votre application et identifier les problèmes potentiels. Pour afficher votre rapport, accédez à Protégé avec Play , puis cliquez sur l'icône en forme de flèche vers la droite dans la section Surveiller l'API Play Integrity.
Le rapport affiche les éléments suivants :
- Le volume de requêtes standards et classiques effectuées par votre application.
- Une répartition de chaque réponse d'évaluation pour les détails de l'appareil, de l'application et du compte. Les évaluations facultatives ne sont pas encore affichées dans le rapport.
- Les codes d'erreur les plus courants rencontrés par votre application.
- Les certificats les plus courants provenant de versions d'application non reconnues.
Vous pouvez filtrer le rapport par version d'application, pays et version d'OS Android pour obtenir une vue plus détaillée de vos évaluations d'intégrité. Les données ne sont pas affichées lorsque le volume de requêtes est faible afin de protéger la confidentialité des utilisateurs.
Vérifier l'évaluation de l'intégrité de l'appareil depuis n'importe quel appareil
Si vous devez vérifier l'évaluation de l'intégrité renvoyée par l'API Play Integrity pour votre application sur un appareil particulier (par exemple, lors du débogage ou du dépannage d'un problème signalé par un utilisateur), vous pouvez utiliser l'application Play Store afin de générer une évaluation de l'API Play Integrity pour cet appareil.
Commencez par activer les options pour les développeurs du Play Store sur l'appareil. Appuyez sur l'icône de votre profil, puis sur Settings (Paramètres). Ouvrez le menu About (À propos) et appuyez sept fois sur la ligne intitulée Play Store version (Version du Play Store) pour déverrouiller le mode développeur.
Ensuite, pour générer une évaluation à partir d'un appareil Android, ouvrez l'application Play Store. Appuyez sur votre icône de profil, puis sur Settings (Paramètres). Ouvrez le menu General (Général), puis appuyez sur Developer options (Options pour les développeurs). Dans les paramètres Play Integrity, appuyez sur Check integrity (Vérifier l'intégrité) afin de générer une évaluation.
Vérifier l'intégrité sur un appareil à distance
Vous pouvez également lancer une vérification de l'intégrité sur un appareil Wear OS, Android Automotive OS ou un appareil Android TV connecté directement depuis votre téléphone principal. Vous pouvez ainsi obtenir des évaluations de l'intégrité de l'appareil sur ces facteurs de forme.
Pour effectuer une vérification de l'intégrité à distance :
- Assurez-vous que votre téléphone principal et l'appareil cible (montre, voiture ou TV, par exemple) sont connectés au même compte Google.
- Sur votre téléphone principal, ouvrez l'application Play Store, puis accédez à Paramètres > Général > Options pour les développeurs.
- Dans la section Play Integrity, appuyez sur la flèche d'expansion du bouton divisé Vérifier l'intégrité pour afficher vos appareils connectés.
- Sélectionnez l'appareil cible dans la liste déroulante.
Le téléphone déclenche la vérification sur l'appareil à distance et affiche l'évaluation résultante une fois l'opération terminée.
Aider les utilisateurs à résoudre les problèmes d'intégrité
L'API Play Integrity fournit différentes boîtes de dialogue de correction Play que vous pouvez déclencher dans votre application pour aider les utilisateurs à résoudre des problèmes d'évaluation spécifiques.
Pour guider les utilisateurs dans la résolution des problèmes d'intégrité de l'appareil, vous pouvez les rediriger vers la fonctionnalité de dépannage de l'application Play Store. Pour résoudre les problèmes d'intégrité de l'appareil, demandez à l'utilisateur de procéder comme suit :
- Ouvrez l'application Google Play Store.
- En haut à droite, appuyez sur l'icône du profil.
- Appuyez sur Paramètres > À propos > Certification Play Protect.
- Appuyez sur Résoudre problème appareil. Ce bouton n'est visible que pour les utilisateurs dont les appareils ne répondent pas aux critères d'intégrité des appareils Play. L'utilisateur voit alors une série d'invites qui l'aideront à résoudre le problème et, si possible, à le corriger.
Lutter contre la fraude à l'aide des solutions reCAPTCHA Enterprise de bout en bout
Les entreprises clientes à la recherche d'une solution complète de lutte contre la fraude et les bots peuvent acheter reCAPTCHA Enterprise pour mobile. Cette application inclut des SDK pour Android qui fournissent aux développeurs des scores de risque de fraude. reCAPTCHA Enterprise inclut automatiquement les signaux de l'API Play Integrity et les combine aux signaux reCAPTCHA relatifs aux réseaux et aux applications, offrant ainsi une solution prête à l'emploi, fluide et invisible pour lutter contre la fraude. Elle peut également protéger les applications Android sur lesquelles l'API Play Integrity n'est pas disponible.
Obtenir de l'aide
Pour signaler une évaluation inattendue de l'API Play Integrity, veuillez soumettre un problème en incluant toutes les informations demandées.
Pour poser des questions ou envoyer des commentaires sur l'API Play Integrity, plusieurs options s'offrent à vous :
- Contactez l'assistance aux développeurs Google Play directement depuis la Play Console.
- Remplissez ce formulaire dans le centre d'aide de la Play Console.
Si vous demandez à augmenter le nombre de requêtes quotidiennes envoyées par votre application, cela peut prendre jusqu'à une semaine. Nous vous recommandons vivement de surveiller votre utilisation de l'API Play Integrity dans la Google Play Console ou dans la console Google Cloud, où vous pouvez également configurer des alertes de quota pour éviter toute interruption de service.