Présentation des ensembles de métriques

L'API Google Play Developer Reporting vous permet d'accéder aux métriques, aux rapports et aux informations chronologiques sur vos applications. Pour simplifier au maximum l'utilisation des API, des 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 produire des répartitions. Sauf indication contraire, vous pouvez décomposer ou filtrer toutes les métriques 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 accepter plusieurs granularités (quotidiennes, horaires), l'opération renvoie une valeur d'actualisation par précision acceptée.

Vous pouvez utiliser la valeur d'actualisation directement comme point de terminaison d'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 afin d'émettre des requêtes. Chaque requête doit spécifier un niveau de précision et une période. Avec les métriques auxquelles vous souhaitez accéder, vous devez spécifier les dimensions à utiliser pour décomposer les agrégations.

Lorsque vous demandez des périodes pour demander des plages de dates, faites attention à ce que la taille de la période 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'expiration de requête causés par la lecture d'un trop grand nombre 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 les données ANR combinées aux données d'utilisation pour produire une métrique normalisée indépendamment du nombre d'utilisateurs. anrRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont 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 jusqu'à la date incluse.
anrRate28dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique "arRate" au cours des 28 derniers jours (jusqu'à la date incluse).
userPerceivedAnrRate (google.type.Decimal): pourcentage d'utilisateurs distincts dans la période d'agrégation qui ont subi au moins une erreur ANR perçue par l'utilisateur. Actuellement, seuls les ANR d'entrée d'entrée sont comptabilisés.
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 derniers jours (jusqu'à la date incluse).
distinctUsers (google.type.Decimal): nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles pendant la période d'agrégation.
vitals.crashrate Contient les données de plantage combinées aux données d'utilisation pour produire une métrique normalisée indépendamment du nombre d'utilisateurs. crashRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont 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 et incluant la date.
crashRate28dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique "crashRate" au cours des 28 derniers jours (jusqu'à la date incluse).
userPerceivedCrashRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont subi au moins un plantage alors que l'application était active.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique userPerceivedCrashRate au cours des sept derniers jours jusqu'à la date incluse.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique userPerceivedCrashRate au cours des 28 derniers jours, jusqu'à la date incluse.
distinctUsers (google.type.Decimal): nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles pendant la période d'agrégation.
vitals.excessivewakeuprate Contient le nombre de wakeups d'AlarmManager combiné aux données d'état du processus pour produire une métrique normalisée indépendamment du nombre d'utilisateurs. excessiveWakeupRate (google.type.Decimal): pourcentage d'utilisateurs distincts ayant obtenu plus de 10 wakeups par heure au cours de la période d'agrégation. 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 "WakeWakeupRate" 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 pendant la période d'agrégation.
vitals.stuckbackgroundwakelockrate Contient des données de durée de wakelock PowerManager combinées aux données d'état du processus pour produire une métrique normalisée indépendamment du nombre d'utilisateurs. stuckBgWakelockRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation pour lesquels un wakelock a été conservé en arrière-plan pendant plus d'une heure. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique "blockBgWakelockRate" pondérée selon les sept jours précédant et incluant la date en question.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): moyenne pondérée par l'utilisateur de la métrique "blockBgWakelockRate" pondérée au cours des 28 derniers jours, jusqu'à la date incluse.
distinctUsers (google.type.Decimal): nombre approximatif d'utilisateurs pour lesquels des données étaient disponibles pendant la période d'agrégation.
vitals.slowstartuprate Contient des données sur le démarrage lent de l'application, réparties par type de démarrage (à froid, tiède ou chaud). slowStartRate (google.type.Decimal): pourcentage d'utilisateurs distincts au cours de la période d'agrégation qui ont enregistré un 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 et incluant la date.
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 pendant la période d'agrégation.
vitals.errors.counts Contient le nombre de rapports d'erreur non normalisés. Remarque:Pour le moment, cette ressource n'est 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 accepte un ensemble distinct de dimensions pour le filtrage et la répartition. Consultez l'index de dimension ci-dessous pour obtenir la liste des dimensions disponibles dans l'API.

Dimension Description
versionCode Code de version de l'application en cours d'exécution 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 basé sur son adresse IP, représenté par un code ISO-3166 à deux lettres (par exemple, US for the United States).

Dimensions de l'appareil

Il s'agit des dimensions spécifiques à l'appareil et à 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, défini par le catalogue d'appareils de la Play Console.
deviceType Identifiant d'un facteur de forme d'appareil spécifique, 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 Marque du système principal sur puce de l'appareil, par exemple : Samsung. Consultez cette page.
deviceSocModel Nom du modèle de la puce principale du système de l'appareil (par exemple, "Exynos 2100". Consultez cette page.
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 ET GRANDE.
deviceScreenDpi Densité d'écran de l'appareil (mdpi ou hdpi, par exemple)