L'API Google Play Developer Reporting vous permet d'accéder aux métriques, aux rapports et aux informations de chronologie 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 l'actualisation et la granularité) 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 produire des répartitions. Sauf indication contraire, toutes les métriques peuvent être réparties ou filtrées par 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é "actualisation". Étant donné qu'un ensemble de métriques peut
prendre en charge plusieurs granularités (quotidienne, horaire), l'opération renvoie une valeur d'actualisation
par granularité acceptée.
Vous pouvez utiliser directement la valeur d'actualisation comme point de terminaison dans une plage de temps 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 émettre des requêtes.
Chaque requête doit spécifier une granularité et une plage de temps. En plus des métriques auxquelles vous souhaitez
accéder, vous devez spécifier les dimensions à utiliser pour répartir les agrégations.
Lorsque vous demandez des chronologies, veillez à demander des plages de dates afin que la taille du plage de temps soit inversement proportionnelle à la taille de votre application et au nombre de répartitions. Par exemple, une application volumineuse doit sélectionner moins de jours dans une seule requête pour éviter les délais d'attente dus à la lecture d'une trop grande quantité de données.
Ensembles de métriques disponibles
L'index ci-dessous répertorie 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 distincts 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 incluse. anrRate28dUserWeighted (google.type.Decimal) : moyenne pondérée par l'utilisateur de la métrique anrRate au cours des 28 jours précédant la date incluse. userPerceivedAnrRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation ayant subi au moins une erreur ANR perçue par l'utilisateur. Actuellement, seules les erreurs 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 incluse. 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 de plantage 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 incluse. 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 incluse. 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 (plantage dû à une faible mémoire) 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 plantage dû à une faible mémoire (LMK) lorsqu'ils
utilisaient activement votre application. Une application est considérée comme étant en cours d'utilisation 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 incluse. 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 de nombre de wakeups AlarmManager combinées à des données d'état de 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 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 incluse. 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 de durée de wakelock PowerManager combinées à des données d'état de 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 ayant 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 l'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 de démarrage lent d'application réparties 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 subi 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 incluse. 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 des nombres 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'erreurs individuels reçus pour une application. |
Dimensions
Chaque ensemble de métriques prend en charge 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 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 obtenir la liste des versions d'Android et leur correspondance avec les niveaux d'API, cliquez ici. |
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, en buckets (3 Go, 4 Go, etc.). |
deviceSocMake |
Fabricant du système sur puce principal de l'appareil, par exemple Samsung. Cliquez ici. |
deviceSocModel |
Nom du modèle du système sur puce principal de l'appareil, par exemple "Exynos 2100". 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 |
Fabricant du processeur graphique de l'appareil, par exemple ARM. |
deviceGpuModel |
Modèle du processeur graphique de l'appareil, par exemple Mali. |
deviceGpuVersion |
Version du processeur graphique 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, hdpi. |