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 des 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 réparties 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 QUERY personnalisée pour envoyer des requêtes.
Chaque requête doit spécifier une précision et une période. 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. La taille de la période doit être 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 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 l'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.anonrssandswapmemoryusage |
Contient des données anonymes sur l'utilisation de la mémoire RSS et swap, combinées à des données d'utilisation. |
anonRssAndSwapMemoryUsageP50 (google.type.Decimal) : 50e centile de l'utilisation de la mémoire RSS anonyme et de l'espace d'échange. anonRssAndSwapMemoryUsageP75 (google.type.Decimal) : 75e centile de l'utilisation de la mémoire RSS et swap anonyme. anonRssAndSwapMemoryUsageP90 (google.type.Decimal) : 90e centile de l'utilisation de la mémoire RSS anonyme et de l'espace d'échange. anonRssAndSwapMemoryUsageP95 (google.type.Decimal) : 95e centile de l'utilisation de la mémoire RSS et swap anonyme. anonRssAndSwapMemoryUsageP99 (google.type.Decimal) : 99e centile de l'utilisation de la mémoire RSS anonyme et de l'espace d'échange. distinctUsers (google.type.Decimal) : nombre d'utilisateurs distincts pour lesquels des métriques de mémoire ont été signalées au cours de la période d'agrégation. Veillez à ne pas agréger davantage ce nombre, car cela pourrait entraîner le comptabilisation des utilisateurs plusieurs fois. La valeur est arrondie au multiple le plus proche de 10, 100, 1 000 ou 1 000 000, selon son ordre de grandeur. |
vitals.bitmapmemoryusage |
Contient des données sur l'utilisation de la mémoire bitmap combinées à des données d'utilisation. |
bitmapMemoryUsageP50 (google.type.Decimal) : 50e centile de l'utilisation de la mémoire bitmap. bitmapMemoryUsageP75 (google.type.Decimal) : 75e centile de l'utilisation de la mémoire bitmap. bitmapMemoryUsageP90 (google.type.Decimal) : 90e centile de l'utilisation de la mémoire bitmap. bitmapMemoryUsageP95 (google.type.Decimal) : 95e centile de l'utilisation de la mémoire bitmap. bitmapMemoryUsageP99 (google.type.Decimal) : 99e centile de l'utilisation de la mémoire bitmap. distinctUsers (google.type.Decimal) : nombre d'utilisateurs distincts pour lesquels des métriques de mémoire ont été signalées au cours de la période d'agrégation. Veillez à ne pas agréger davantage ce nombre, car cela pourrait entraîner le comptabilisation des utilisateurs plusieurs fois. La valeur est arrondie au multiple le plus proche de 10, 100, 1 000 ou 1 000 000, selon son ordre de grandeur. |
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 distincts 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 utilisée activement 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 distincts au cours de la période d'agrégation qui ont 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 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 eu un wakelock maintenu 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.slowstartrate |
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 distincts 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 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'erreur 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, dans des groupes (3 Go, 4 Go, etc.). |
deviceSocMake |
Marque du système sur puce principal de l'appareil (Samsung, par exemple). Pour en savoir plus, cliquez ici. |
deviceSocModel |
Nom du modèle du principal système sur puce de l'appareil, par exemple "Exynos 2100". Pour en savoir plus, cliquez ici. |
deviceCpuMake |
Fabricant 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" ou "LARGE"). |
deviceScreenDpi |
Densité d'écran de l'appareil (par exemple, mdpi ou hdpi). |