La API de Google Play Developer Reporting te permite acceder a métricas, informes y a la información de la línea de tiempo de tus apps. Para que el uso de la API sea lo más sencillo 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 la actualización y la granularidad) y se pueden consultar juntas. Un conjunto de métricas también contiene una cantidad de dimensiones que puedes 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 de conjunto de métricas ofrece un método GET estándar para recuperar la fecha y la hora del punto de datos disponible más reciente, lo que se conoce como actualización. Dado que un conjunto de métricas puede admitir varias granularidades (diaria, por hora), la operación devuelve un valor de actualización por cada granularidad admitida.
Puedes usar el valor de actualización directamente como el extremo en un intervalo de tiempo de la búsqueda.
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 una granularidad y un período. Junto con las métricas a las que deseas acceder, debes especificar las dimensiones que se deben usar para desglosar las agregaciones.
Se debe tener cuidado al solicitar períodos para solicitar rangos de fechas, de modo que el tamaño del rango de fechas sea inversamente proporcional al tamaño de tu app y a la cantidad de desgloses. Por ejemplo, una app grande debería seleccionar menos días en una sola solicitud de consulta para evitar los tiempos de espera de la consulta causados por la lectura de demasiados datos.
Conjuntos de métricas disponibles
En el índice a continuación, se enumeran 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 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): Es el promedio ponderado por el usuario de la métrica anrRate en los 7 días hasta la fecha inclusive. anrRate28dUserWeighted (google.type.Decimal): Es 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, solo se contabilizan los ANR de "Envío de entrada". userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica userPerceivedAnrRate durante los 7 días hasta la fecha inclusive. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica userPerceivedAnrRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.crashrate |
Contiene datos de fallas combinados con datos de uso para producir una métrica normalizada independiente de los recuentos de usuarios. |
crashRate (google.type.Decimal): Es el 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 el usuario de la métrica crashRate durante los 7 días hasta la fecha inclusive. crashRate28dUserWeighted (google.type.Decimal): Es 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): Es el promedio ponderado por el usuario de la métrica userPerceivedCrashRate en los 7 días hasta la fecha inclusive. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica userPerceivedCrashRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.lmkrate
|
Contiene datos de LMK (cierre por falta de memoria) combinados con datos de uso para producir una métrica normalizada independiente de los recuentos de usuarios. |
userPerceivedLmkRate (google.type.Decimal): Es el porcentaje de usuarios distintos en el período de agregación que experimentaron al menos un error de LMK (cierre por falta de memoria) mientras usaban tu app de forma activa. Se considera que una app está en uso activo si muestra alguna actividad o ejecuta algún servicio en primer plano. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica userPerceivedLmkRate en los 7 días hasta la fecha inclusive. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica userPerceivedLmkRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.excessivewakeuprate |
Contiene datos de recuento de activación de AlarmManager combinados con datos de estado del proceso para generar una métrica normalizada independiente de los recuentos de usuarios. |
excessiveWakeupRate (google.type.Decimal): Es el porcentaje de usuarios distintos en el período de agregación que tuvieron más de 10 activaciones por hora.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica excessiveWakeupRate en los 7 días hasta la fecha inclusive. excessiveWakeupRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica excessiveWakeupRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.stuckbackgroundwakelockrate |
Contiene datos de duración del bloqueo de activación de PowerManager combinados con datos de estado del proceso para generar 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 en segundo plano durante más de 1 hora.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica stuckBgWakelockRate en los 7 días hasta la fecha inclusive. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica stuckBgWakelockRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.slowstartuprate |
Contiene datos sobre el inicio lento de la app desglosados por tipo de inicio (en frío, semicaliente y en caliente). |
slowStartRate (google.type.Decimal): Es el porcentaje de usuarios distintos en el período de agregación que tuvieron un evento de inicio lento.
slowStartRate7dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica slowStartRate en los 7 días hasta la fecha inclusive. slowStartRate28dUserWeighted (google.type.Decimal): Es el promedio ponderado por el usuario de la métrica slowStartRate en los 28 días hasta la fecha inclusive. distinctUsers (google.type.Decimal): Es la cantidad aproximada de usuarios para los que había datos disponibles en el período de agregación. |
vitals.errors.counts |
Contiene recuentos de informes de errores sin normalizar. |
Nota: Por el momento, este recurso solo está disponible en la versión alfa v1 de la API. errorReportCount (google.type.Decimal): Es el recuento absoluto de los informes de errores individuales que se recibieron para una app. |
Dimensiones
Cada conjunto de métricas admite un conjunto distinto de dimensiones para el filtrado y los desgloses. Consulta el índice de dimensiones a continuación para ver 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 ejecutaba en el dispositivo del usuario en el momento en que se capturaron los datos. El valor de cadena de esta dimensión se puede analizar como un número entero. Consulta aquí para obtener más detalles sobre cómo funciona el control de versiones de las apps en Android. |
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., US 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 capturaron los datos. El valor de cadena de esta dimensión se puede analizar como un número entero. Consulta aquí la lista de versiones de Android y cómo se asignan a los niveles de API. |
deviceModel |
Es el identificador de un modelo de dispositivo en particular, según se define en el catálogo de dispositivos de Play Console. |
deviceType |
Es el identificador de un factor de forma de dispositivo en particular, tal como se usa en el catálogo de dispositivos de Play Console. |
deviceRamBucket |
Es la RAM del dispositivo, en MB, en intervalos (3 GB, 4 GB, etcétera). |
deviceSocMake |
Fabricante del sistema en chip principal del dispositivo, p.ej., Samsung. Consulta aquí. |
deviceSocModel |
Nombre del modelo del sistema en chip principal del dispositivo, p.ej., "Exynos 2100". Consulta aquí. |
deviceCpuMake |
Marca de la CPU del dispositivo, p.ej., Qualcomm. |
deviceCpuModel |
Modelo de la CPU del dispositivo, p.ej., "Kryo 240". |
deviceGpuMake |
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 |
Versión de Vulkan del dispositivo, p.ej., "4198400". |
deviceGlEsVersion |
Versión de OpenGL ES del dispositivo, p.ej., "196610". |
deviceScreenSize |
Tamaño de la pantalla del dispositivo, p.ej., NORMAL, GRANDE. |
deviceScreenDpi |
Densidad de pantalla del dispositivo, p.ej., mdpi, hdpi. |