L'API Google Play Developer Reporting vous permet d'accéder aux métriques, aux rapports et aux informations chronologiques concernant vos applications. Pour simplifier au maximum l'utilisation de l'API, les ensembles de métriques standardisent l'accès aux métriques. Un ensemble de métriques est un regroupement logique de métriques associées qui partagent des attributs communs (tels que la fraîcheur et la précision) et peuvent être interrogées ensemble. Un ensemble de métriques contient également un certain nombre de dimensions que vous pouvez utiliser pour filtrer ou générer des répartitions. Sauf indication contraire, toutes les métriques peuvent être ventilées ou filtrées selon toutes les dimensions disponibles.
Actualisation
Chaque ressource d'ensemble de métriques propose une méthode GET standard pour récupérer la date et l'heure du dernier point de données disponible, appelé "fraîcheur". Étant donné qu'un ensemble de métriques peut prendre en charge plusieurs niveaux de précision (quotidien, horaire), l'opération renvoie une valeur de fraîcheur par niveau de précision pris en charge.
Vous pouvez utiliser directement la valeur de fraîcheur comme point de terminaison dans une période de requête.
Requêtes de données
Pour accéder aux données d'un ensemble de métriques, vous devez utiliser la méthode personnalisée QUERY pour envoyer des requêtes.
Chaque requête doit spécifier une précision et une plage de dates. En plus des métriques auxquelles vous souhaitez accéder, vous devez spécifier les dimensions à utiliser pour répartir les agrégations.
Il convient d'être prudent lorsque vous demandez des périodes pour les chronologies, afin que la taille de la période soit inversement proportionnelle à la taille de votre application et au nombre de répartitions. Par exemple, une grande application doit sélectionner moins de jours dans une même requête pour éviter les délais d'expiration dus à la lecture d'une trop grande quantité de données.
Ensembles de métriques disponibles
L'index ci-dessous liste tous les points de terminaison et les données associées que vous pouvez demander.
| Ensemble de métriques | Description | Métriques acceptées |
|---|---|---|
vitals.anrrate |
Contient des données ANR combinées à des données d'utilisation pour produire une métrique normalisée indépendante du nombre d'utilisateurs. |
anrRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant subi au moins une erreur ANR. anrRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique anrRate au cours des sept jours précédant la date et incluant celle-ci. anrRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par utilisateur de la métrique anrRate au cours des 28 jours précédant la date (incluse). userPerceivedAnrRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant subi au moins une erreur ANR perçue par l'utilisateur. Actuellement, seules les ANR de type "Envoi d'entrée" sont comptabilisées. userPerceivedAnrRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par utilisateur de la métrique userPerceivedAnrRate au cours des sept jours précédant la date et incluant celle-ci. userPerceivedAnrRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique userPerceivedAnrRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.crashrate |
Contient des données sur les plantages combinées à des données d'utilisation pour produire une métrique normalisée indépendante du nombre d'utilisateurs. |
crashRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation ayant subi au moins un plantage. crashRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique crashRate au cours des sept jours précédant la date et incluant celle-ci. crashRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique crashRate au cours des 28 jours précédant la date (incluse). userPerceivedCrashRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation ayant subi au moins un plantage lorsque l'application était en cours d'utilisation. userPerceivedCrashRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique userPerceivedCrashRate au cours des sept jours précédant la date et incluant celle-ci. userPerceivedCrashRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique userPerceivedCrashRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.lmkrate
|
Contient des données LMK (low memory kill) combinées à des données d'utilisation pour produire une métrique normalisée indépendante du nombre d'utilisateurs. |
userPerceivedLmkRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant subi au moins un LMK (low memory kill) lorsqu'ils utilisaient activement votre application. Une application est considérée comme étant en cours d'utilisation active si elle affiche une activité ou exécute un service de premier plan. userPerceivedLmkRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique userPerceivedLmkRate au cours des sept jours précédant la date et incluant celle-ci. userPerceivedLmkRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique userPerceivedLmkRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.excessivewakeuprate |
Contient des données sur le nombre de réveils AlarmManager combinées à des données sur l'état des processus pour produire une métrique normalisée indépendante du nombre d'utilisateurs. |
excessiveWakeupRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant subi plus de 10 wakeups par heure.
excessiveWakeupRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique excessiveWakeupRate au cours des sept jours précédant la date et incluant celle-ci. excessiveWakeupRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique excessiveWakeupRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.stuckbackgroundwakelockrate |
Contient des données sur la durée du verrouillage de réveil PowerManager combinées à des données sur l'état du processus pour produire une métrique normalisée indépendante du nombre d'utilisateurs. |
stuckBgWakelockRate (google.type.Decimal) : pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont subi un wakelock en arrière-plan pendant plus d'une heure.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique stuckBgWakelockRate au cours des sept jours précédant la date (incluse). stuckBgWakelockRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par utilisateur de la métrique stuckBgWakelockRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.slowstartuprate |
Contient des données sur le démarrage lent des applications, ventilées par type de démarrage (à froid, tiède, à chaud). |
slowStartRate (google.type.Decimal) : pourcentage d'utilisateurs uniques au cours de la période d'agrégation ayant enregistré un événement de démarrage lent.
slowStartRate7dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique slowStartRate au cours des sept jours précédant la date et incluant celle-ci. slowStartRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique slowStartRate au cours des 28 jours précédant la date (incluse). distinctUsers (google.type.Decimal) : nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles au cours de la période d'agrégation. |
vitals.errors.counts |
Contient le nombre de rapports d'erreurs non normalisés. |
Remarque : Cette ressource n'est pour l'instant disponible que dans la version alpha v1 de l'API. errorReportCount (google.type.Decimal) : nombre absolu de rapports d'erreur individuels reçus pour une application. |
Dimensions
Chaque ensemble de métriques est compatible avec un ensemble distinct de dimensions pour le filtrage et les répartitions. Consultez l'index des dimensions ci-dessous pour obtenir la liste des dimensions disponibles dans l'API.
| Dimension | Description |
|---|---|
versionCode |
Code de version de l'application qui s'exécutait sur l'appareil de l'utilisateur au moment de la capture des données. La valeur de chaîne de cette dimension peut être analysée en tant qu'entier. Pour en savoir plus sur le fonctionnement de la gestion des versions d'applications sur Android, cliquez ici. |
countryCode |
Identifiant du pays ou de la région de l'utilisateur en fonction de son adresse IP, représenté par un code ISO-3166 à deux lettres (par exemple, "US" pour les États-Unis). |
Dimensions de l'appareil
Il s'agit des dimensions spécifiques à l'appareil, ainsi qu'à ses caractéristiques logicielles et matérielles.
| Dimension | Description |
|---|---|
apiLevel |
Niveau d'API d'Android exécuté sur l'appareil de l'utilisateur au moment de la capture des données. La valeur de chaîne de cette dimension peut être analysée en tant qu'entier. Consultez cette page pour obtenir la liste des versions d'Android et leur correspondance avec les niveaux d'API. |
deviceModel |
Identifiant d'un modèle d'appareil spécifique, tel que défini par le catalogue d'appareils de la Play Console. |
deviceType |
Identifiant d'un facteur de forme d'appareil spécifique, tel qu'utilisé par le catalogue d'appareils de la Play Console. |
deviceRamBucket |
RAM de l'appareil, en Mo, par tranche (3 Go, 4 Go, etc.). |
deviceSocMake |
Marque du système sur puce principal de l'appareil, par exemple Samsung. Pour en savoir plus, cliquez ici. |
deviceSocModel |
Nom du modèle du système sur puce principal de l'appareil, par exemple "Exynos 2100". Pour en savoir plus, cliquez ici. |
deviceCpuMake |
Marque du processeur de l'appareil (par exemple, Qualcomm. |
deviceCpuModel |
Modèle du processeur de l'appareil, par exemple "Kryo 240". |
deviceGpuMake |
Marque du GPU de l'appareil, par exemple ARM |
deviceGpuModel |
Modèle du GPU de l'appareil, par exemple Mali. |
deviceGpuVersion |
Version du GPU de l'appareil (par exemple, T750. |
deviceVulkanVersion |
Version Vulkan de l'appareil (par exemple, "4198400". |
deviceGlEsVersion |
Version OpenGL ES de l'appareil, par exemple "196610". |
deviceScreenSize |
Taille de l'écran de l'appareil, par exemple NORMAL, LARGE. |
deviceScreenDpi |
Densité d'écran de l'appareil (par exemple, mdpi ou hdpi). |