A API Google Play Developer Reporting permite acessar métricas, relatórios e informações de cronograma sobre seus apps. Para simplificar ao máximo o uso da API, os conjuntos de métricas padronizam o acesso a elas. Um conjunto de métricas é um agrupamento lógico de métricas relacionadas que compartilham atributos comuns (como atualização e granularidade) e podem ser consultadas juntas. Um conjunto de métricas também contém várias dimensões que podem ser usadas para filtrar ou produzir detalhamentos. A menos que especificado de outra forma, todas as métricas podem ser detalhadas ou filtradas por todas as dimensões disponíveis.
Atualização
Cada recurso de conjunto de métricas oferece um método GET padrão para recuperar a
data e a hora do ponto de dados mais recente disponível, conhecido como atualização. Como um conjunto de métricas pode
oferecer suporte a várias granularidades (diária, por hora), a operação retorna um valor de atualização
por granularidade com suporte.
É possível usar o valor de atualização diretamente como o endpoint em um período de consulta.
Consultas de dados
Para acessar os dados em um conjunto de métricas, use o método QUERY personalizado para emitir consultas.
Cada consulta precisa especificar uma granularidade e um período. Junto com as métricas que você quer
acessar, especifique as dimensões que serão usadas para detalhar as agregações.
É preciso ter cuidado ao solicitar cronogramas para solicitar períodos, de modo que o tamanho do período seja inversamente proporcional ao tamanho do app e ao número de detalhamentos. Por exemplo, um app grande precisa selecionar menos dias em uma única solicitação de consulta para evitar tempos limite de consulta causados pela leitura de muitos dados.
Conjuntos de métricas disponíveis
O índice abaixo lista todos os endpoints e dados associados que podem ser solicitados.
| Conjunto de métricas | Descrição | Métricas com suporte |
|---|---|---|
vitals.anrrate |
Contém dados de ANR combinados com dados de uso para produzir uma métrica normalizada independente das contagens de usuários. |
anrRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação
que tiveram pelo menos um ANR. anrRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica anrRate nos sete dias até a data, inclusive. anrRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica anrRate nos 28 dias até a data, inclusive. userPerceivedAnrRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos um ANR percebido pelo usuário. Atualmente, apenas os ANRs de "despacho de entrada" são contabilizados. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica userPerceivedAnrRate nos sete dias até a data, inclusive. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica userPerceivedAnrRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.crashrate |
Contém dados de falhas combinados com dados de uso para produzir uma métrica normalizada independente das contagens de usuários. |
crashRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação
que tiveram pelo menos uma falha. crashRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica crashRate nos sete dias até a data, inclusive. crashRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica crashRate nos 28 dias até a data, inclusive. userPerceivedCrashRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos uma falha enquanto o app estava em uso ativo. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica userPerceivedCrashRate nos sete dias até a data, inclusive. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica userPerceivedCrashRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.lmkrate
|
Contém dados de LMK (eliminação por pouca memória) combinados com dados de uso para produzir uma métrica normalizada independente das contagens de usuários. |
userPerceivedLmkRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram pelo menos um LMK (eliminação por pouca memória) enquanto estavam usando o app ativamente. Um app é considerado em uso ativo se estiver mostrando alguma atividade ou executando qualquer serviço em primeiro plano. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário de a métrica userPerceivedLmkRate nos sete dias até a data, inclusive. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica userPerceivedLmkRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.excessivewakeuprate |
Contém dados de contagens de ativação do AlarmManager combinados com dados de estado do processo para produzir uma métrica normalizada independente das contagens de usuários. |
excessiveWakeupRate (google.type.Decimal): porcentagem de usuários distintos no
período de agregação que tiveram mais de 10 ativações por hora.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário de
a métrica excessiveWakeupRate nos sete dias até a data, inclusive. excessiveWakeupRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário de a métrica excessiveWakeupRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.stuckbackgroundwakelockrate |
Contém dados de duração do wakelock do PowerManager combinados com dados de estado do processo para produzir uma métrica normalizada independente das contagens de usuários. |
stuckBgWakelockRate (google.type.Decimal): porcentagem de usuários distintos no
período de agregação que tiveram um wakelock mantido em segundo plano por mais de uma hora.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário
da métrica stuckBgWakelockRate nos sete dias até a data, inclusive. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica stuckBgWakelockRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.slowstartrate |
Contém dados de inicialização lenta do app detalhados por tipo de inicialização (a frio, com estado salvo, a quente). |
slowStartRate (google.type.Decimal): porcentagem de usuários distintos no
período de agregação que tiveram um evento de inicialização lenta.
slowStartRate7dUserWeighted (google.type.Decimal): média ponderada pelo usuário
da métrica slowStartRate nos sete dias até a data, inclusive. slowStartRate28dUserWeighted (google.type.Decimal): média ponderada pelo usuário da métrica slowStartRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.errors.counts |
Contém contagens de relatórios de erros não normalizados. |
Observação:esse recurso está disponível apenas na versão Alfa v1 da API. errorReportCount (google.type.Decimal): contagem absoluta de relatórios de erros individuais recebidos para um app. |
Dimensões
Cada conjunto de métricas oferece suporte a um conjunto distinto de dimensões para filtragem e detalhamentos. Confira o índice de dimensões abaixo para uma lista de dimensões disponíveis na API.
| Dimensão | Descrição |
|---|---|
versionCode |
O código da versão do app que estava em execução no dispositivo do usuário no momento em que os dados foram capturados. O valor de string dessa dimensão pode ser analisado como um número inteiro. Confira aqui mais detalhes sobre como o controle de versões de apps funciona no Android. |
countryCode |
Identificador do país ou região do usuário com base no endereço IP, representado como um código ISO-3166 de duas letras (por exemplo, US para os Estados Unidos). |
Dimensões do dispositivo
Essas são as dimensões específicas do dispositivo e das características de software e hardware.
| Dimensão | Descrição |
|---|---|
apiLevel |
O nível da API do Android que estava em execução no dispositivo do usuário no momento em que os dados foram capturados. O valor de string dessa dimensão pode ser analisado como um número inteiro. Confira aqui a lista de versões do Android e como elas são mapeadas para níveis da API. |
deviceModel |
Identificador de um modelo de dispositivo específico, conforme definido pelo catálogo de dispositivos do Play Console. |
deviceType |
Identificador de um formato de dispositivo específico, conforme usado pelo catálogo de dispositivos do Play Console. |
deviceRamBucket |
RAM do dispositivo, em MB, em buckets (3 GB, 4 GB etc.). |
deviceSocMake |
A marca do sistema principal no chip do dispositivo, por exemplo, Samsung. Confira aqui. |
deviceSocModel |
O nome do modelo do sistema principal no chip do dispositivo, por exemplo, "Exynos 2100". Confira aqui. |
deviceCpuMake |
Marca da CPU do dispositivo, por exemplo, Qualcomm. |
deviceCpuModel |
Modelo da CPU do dispositivo, por exemplo, "Kryo 240". |
deviceGpuMake |
Marca da GPU do dispositivo, por exemplo, ARM. |
deviceGpuModel |
Modelo da GPU do dispositivo, por exemplo, Mali. |
deviceGpuVersion |
Versão da GPU do dispositivo, por exemplo, T750. |
deviceVulkanVersion |
Versão do Vulkan do dispositivo, por exemplo, "4198400". |
deviceGlEsVersion |
Versão do OpenGL ES do dispositivo, por exemplo, "196610". |
deviceScreenSize |
Tamanho da tela do dispositivo, por exemplo, NORMAL, GRANDE. |
deviceScreenDpi |
Densidade da tela do dispositivo, por exemplo, mdpi, hdpi. |