Se usó la API de Cloud Translation para traducir esta página.

Introducción a los conjuntos de métricas

La API de Google Play Developer Reporting te permite acceder a métricas, informes y, también, información de cronogramas sobre tus apps. Para que el uso de la API sea lo más simple posible, los conjuntos de métricas estandarizan el acceso a las métricas. Un conjunto de métricas es una agrupación lógica de métricas relacionadas que comparten atributos comunes (como actualidad y nivel de detalle) y se pueden consultar juntas. Un conjunto de métricas también contiene varias dimensiones que puede usar para filtrar o generar desgloses. A menos que se especifique lo contrario, todas las métricas se pueden desglosar o filtrar según todas las dimensiones disponibles.

Actualidad

Cada recurso del conjunto de métricas ofrece un método GET estándar para recuperar la fecha y hora del último dato disponible, conocido como actualización. Como un conjunto de métricas puede admitir varios niveles de detalle (diario, por hora), la operación muestra un valor de actualización por nivel de detalle admitido.

Puedes usar el valor de actualización directamente como el extremo en un intervalo de tiempo de consulta.

Consultas de datos

Para acceder a los datos de un conjunto de métricas, debes usar el método QUERY personalizado para emitir consultas. Cada consulta debe especificar un nivel de detalle y un intervalo de tiempo. Junto con las métricas a las que deseas acceder, debes especificar las dimensiones que se deben usar para desglosar las agregaciones.

Debes tener cuidado al solicitar cronogramas para solicitar períodos, de modo que el tamaño del intervalo sea inversamente proporcional al tamaño de tu app y la cantidad de desgloses. Por ejemplo, una app de gran tamaño debe seleccionar menos días en una sola solicitud de consulta para evitar los tiempos de espera de consulta causados por la lectura de demasiados datos.

Conjuntos de métricas disponibles

El siguiente índice enumera todos los extremos y los datos asociados que puedes solicitar.

Conjunto de métricas	Descripción	Métricas admitidas
`vitals.anrrate`	Contiene datos de ANR combinados con datos de uso para producir una métrica normalizada que es independiente de los recuentos de usuarios.	anrRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que experimentaron al menos un error de ANR. anrRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica anrRate en los 7 días hasta la fecha inclusive. anrRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica anrRate en los 28 días hasta la fecha inclusive. userPerceivedAnrRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que experimentaron al menos un error de ANR percibido por el usuario. Actualmente, se cuentan los ANR de "Envío de entrada". userPerceivedAnrRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica userPerceivedAnrRate en los 7 días hasta la fecha inclusive. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica userPerceivedAnrRate en los 28 días hasta la fecha. distinctUsers (google.type.Decimal): La cantidad aproximada de usuarios para los que los datos estuvieron disponibles en el período de agregación.
`vitals.crashrate`	Contiene datos de bloqueos combinados con datos de uso para producir una métrica normalizada independiente de los recuentos de usuarios.	crashRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que experimentaron al menos una falla. crashRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por usuario de la métrica crashRate en los 7 días hasta la fecha inclusive. crashRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica crashRate en los 28 días hasta la fecha inclusive. userPerceivedCrashRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que experimentaron al menos una falla mientras la app estaba en uso activo. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica userPerceivedCrashRate en los 7 días hasta la fecha inclusive. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica userPerceivedCrashRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): La cantidad aproximada de usuarios para los que los datos estuvieron disponibles en el período de agregación.
`vitals.excessivewakeuprate`	Contienen datos de activación de AlarmManager combinados con datos de estados de procesos para producir una métrica normalizada independiente de los recuentos de usuarios.	excessiveWakeupRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que tuvo más de 10 activaciones por hora. excessiveWakeupRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica "OverWakeupRate" excesiva durante los 7 días hasta la fecha inclusive. excessiveWakeupRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica excesoWakeupRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): La cantidad aproximada de usuarios para los que los datos estuvieron disponibles en el período de agregación.
`vitals.stuckbackgroundwakelockrate`	Contiene los datos de duración de bloqueo de activación de PowerManager combinados con los datos de estado del proceso para producir una métrica normalizada independiente de los recuentos de usuarios.	stuckBgWakelockRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que tuvieron un bloqueo de activación activo en segundo plano por más de 1 hora. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métricastickBgWakelockRate de la métrica 7 días hasta la fecha inclusive. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métricastickBgWakelockRate en los 28 días hasta la fecha. distinctUsers (google.type.Decimal): La cantidad aproximada de usuarios para los que los datos estuvieron disponibles en el período de agregación.
`vitals.slowstartuprate`	Contiene datos lentos sobre el inicio de apps desglosados por tipo de inicio (frío, templado, activo).	slowStartRate (google.type.Decimal): Porcentaje de usuarios distintos en el período de agregación que tuvieron un evento de inicio lento. slowStartRate7dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica slowStartRate en los 7 días hasta la fecha inclusive. slowStartRate28dUserWeighted (google.type.Decimal): El promedio ponderado por el usuario de la métrica slowStartRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): La cantidad aproximada de usuarios para los que los datos estuvieron disponibles en el período de agregación.
`vitals.errors.counts`	Contiene recuentos de informes de errores no normalizados.	Nota: Por el momento, este recurso solo está disponible en la versión Alfa v1 de la API. errorReportCount (google.type.Decimal): Recuento absoluto de informes de errores individuales que se recibieron para una app.

Dimensiones

Cada conjunto de métricas admite un conjunto distinto de dimensiones para filtrar y desglosar. Consulta el índice de dimensiones que aparece a continuación para obtener una lista de las dimensiones disponibles en la API.

Dimensión	Descripción
`versionCode`	Es el código de versión de la app que se estaba ejecutando en el dispositivo del usuario en el momento en que se capturaron los datos. El valor de string de esta dimensión se puede analizar como un número entero. Para obtener detalles adicionales sobre cómo funciona el control de versiones de apps en Android, haz clic aquí.
`countryCode`	Identificador del país o la región del usuario según su dirección IP, representado como un código ISO-3166 de 2 letras (p. ej., EE.UU. para Estados Unidos).

Dimensiones de dispositivos

Estas son las dimensiones específicas del dispositivo y sus características de software y hardware.

Dimensión	Descripción
`apiLevel`	Es el nivel de API de Android que se ejecutaba en el dispositivo del usuario en el momento en que se capturaban los datos. El valor de string de esta dimensión se puede analizar como un número entero. Consulta aquí la lista de las versiones de Android y cómo se asignan a los niveles de API.
`deviceModel`	Es el identificador de un modelo de dispositivo en particular, tal como lo define el catálogo de dispositivos de Play Console.
`deviceType`	Es el identificador de un factor de forma de dispositivo específico, como lo usa el catálogo de dispositivos de Play Console.
`deviceRamBucket`	RAM del dispositivo, en MB, en depósitos (3 GB, 4 GB, etc.).
`deviceSocMake`	La marca del sistema en chip principal del dispositivo, p.ej., Samsung Consulta aquí.
`deviceSocModel`	El nombre del modelo del sistema en chip principal del dispositivo, p.ej., “Exynos 2100”. Consulta aquí.
`deviceCpuMake`	La marca de la CPU del dispositivo, p.ej., Qualcomm.
`deviceCpuModel`	Modelo de la CPU del dispositivo, p.ej., "Kryo 240".
`deviceGpuMake`	La marca de la GPU del dispositivo, p.ej., ARM.
`deviceGpuModel`	Modelo de la GPU del dispositivo, p.ej., Malí.
`deviceGpuVersion`	Versión de la GPU del dispositivo, p.ej., T750
`deviceVulkanVersion`	La versión Vulkan del dispositivo, p.ej., “4198400”.
`deviceGlEsVersion`	Versión de OpenGL ES del dispositivo, p.ej., “196,610”.
`deviceScreenSize`	Tamaño de la pantalla del dispositivo, p.ej., NORMAL, GRANDE.
`deviceScreenDpi`	Es la densidad de la pantalla del dispositivo, p.ej., mdpi, hdpi.