Com a API Google Play Developer Reporting, você pode acessar métricas, relatórios e informações de linha do tempo sobre seus apps. Para simplificar ao máximo o uso da API, os conjuntos de métricas padronizam o acesso às métricas. 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 gerar 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 compatível.
É possível usar o valor de atualização diretamente como o endpoint em um intervalo de tempo 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 devem ser usadas para detalhar as agregações.
É preciso ter cuidado ao solicitar intervalos de datas para linhas do tempo. O tamanho do intervalo de tempo é inversamente proporcional ao tamanho do app e ao número de detalhamentos. Por exemplo, um app grande deve selecionar menos dias em uma única solicitação de consulta para evitar tempos limite causados pela leitura de muitos dados.
Conjuntos de métricas disponíveis
O índice abaixo lista todos os endpoints e dados associados que você pode solicitar.
| Conjunto de métricas | Descrição | Métricas compatíveis |
|---|---|---|
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): a média ponderada pelo usuário da métrica anrRate nos sete dias até a data, incluindo ela. anrRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica anrRate nos 28 dias até a data. userPerceivedAnrRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que perceberam pelo menos um ANR. No momento, apenas ANRs de "Despacho de entrada" são contabilizados. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): a média ponderada por usuário da métrica userPerceivedAnrRate nos sete dias até a data, inclusive. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica userPerceivedAnrRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): o 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): a média ponderada pelo usuário da métrica crashRate nos sete dias até a data, incluindo ela. crashRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica crashRate nos 28 dias até a data. 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): a média ponderada por usuário da métrica userPerceivedCrashRate nos sete dias até a data, incluindo ela. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica userPerceivedCrashRate nos 28 dias até a data. distinctUsers (google.type.Decimal): o 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 (falha 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 perceberam pelo menos um LMK (falha por pouca memória) enquanto usavam o app ativamente. Um app é considerado em uso ativo se estiver mostrando alguma atividade ou executando algum serviço em primeiro plano. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica userPerceivedLmkRate nos sete dias até a data, incluindo ela. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica userPerceivedLmkRate nos 28 dias até a data, inclusive. distinctUsers (google.type.Decimal): o 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 contagem de despertar 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): a média ponderada pelo usuário da métrica
excessiveWakeupRate nos sete dias até a data, inclusive. excessiveWakeupRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica excessiveWakeupRate nos 28 dias até a data. distinctUsers (google.type.Decimal): o 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): a média ponderada pelo usuário da métrica stuckBgWakelockRate nos sete dias até a data, incluindo ela. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica stuckBgWakelockRate nos 28 dias até a data, incluindo ela. distinctUsers (google.type.Decimal): o número aproximado de usuários para os quais os dados estavam disponíveis no período de agregação. |
vitals.slowstartuprate |
Contém dados de inicialização lenta do app detalhados por tipo de inicialização (a frio, com estado salvo e a quente). |
slowStartRate (google.type.Decimal): porcentagem de usuários distintos no período de agregação que tiveram um evento de início lento.
slowStartRate7dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica "slowStartRate" nos sete dias até a data, inclusive. slowStartRate28dUserWeighted (google.type.Decimal): a média ponderada pelo usuário da métrica "slowStartRate" nos 28 dias até a data. distinctUsers (google.type.Decimal): o 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 normalizadas. |
Observação:no momento, 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 que foram recebidos para um app. |
Dimensões
Cada conjunto de métricas é compatível com um conjunto diferente de dimensões para filtragem e detalhamentos. Confira o índice de dimensão abaixo para ver uma lista das dimensões disponíveis na API.
| Dimensão | Descrição |
|---|---|
versionCode |
O código da versão do app que estava sendo executado no dispositivo do usuário quando 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 da 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 dele.
| 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. Consulte aqui a lista de versões do Android e como elas são mapeadas para níveis de 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 específico de dispositivo, conforme usado pelo catálogo de dispositivos do Play Console. |
deviceRamBucket |
RAM do dispositivo, em MB, em intervalos (3 GB, 4 GB etc.). |
deviceSocMake |
A marca do principal sistema em um chip do dispositivo, por exemplo, Samsung. Confira aqui. |
deviceSocModel |
O nome do modelo do principal sistema em um 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, LARGE. |
deviceScreenDpi |
Densidade de tela do dispositivo, por exemplo, mdpi, hdpi. |