Esta página foi traduzida pela API Cloud Translation.

Introdução aos conjuntos de métricas

A API Google Play Developer Reporting permite acessar métricas, relatórios e informações do cronograma sobre seus apps. Para simplificar 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 consultados juntos. 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árias, 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. Com as métricas que você quer acessar, especifique as dimensões que serão usadas para detalhar as agregações.

É necessário cuidado ao solicitar cronogramas para solicitar períodos. Assim, o tamanho do período é 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 o tempo limite de consulta causado pela leitura excessiva de 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 aceitas
`vitals.anrrate`	Contém dados de ANRs 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. anrRate7dUserWeight (google.type.decimal): a média ponderada do usuário da métrica anrRate nos últimos sete dias, até a data. anrRate28dUserWeight (google.type.decimal): a média ponderada do usuário da métrica anrRate nos 28 dias até a data e incluindo. 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, todos os ANRs de "Envio de entrada" são contados. userPerceivedAnrRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica userPerceivedAnrRate nos últimos sete dias, incluindo a data. userPerceivedAnrRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica "userPerceivedAnrRate" nos 28 dias anteriores à data e incluindo essa 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.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. crashRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica crashRate nos últimos sete dias, incluindo a data. crashRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica crashRate nos últimos 28 dias, incluindo 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. userPerceivedCrashRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica userPerceivedCrashRate nos sete dias anteriores à data em que foi incluída. userPerceivedCrashRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica userPerceivedCrashRate nos últimos 28 dias, incluindo 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.excessivewakeuprate`	Contém dados de contagem de alarmes da 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. excessiveWakeupRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica excessivaWakeupRate nos últimos sete dias, incluindo a data. excessiveWakeupRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica excessivaWakeupRate nos últimos 28 dias, incluindo 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 de wake lock 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 diferentes no período de agregação que tiveram um wakelock mantido em segundo plano por mais de uma hora. stuckBgWakelockRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica travaBgWakelockRate nos últimos sete dias, incluindo a data. stuckBgWakelockRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica travaBgWakelockRate nos últimos 28 dias, incluindo 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.slowstartuprate`	Contém dados de inicialização de apps lentos detalhados por tipo de inicialização do app (frio, morno, quente).	slowStartRate (google.type.decimal): porcentagem de usuários distintos no período de agregação que tiveram um evento de início lento. slowStartRate7dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica "SlowStartRate" nos últimos sete dias até a data, inclusive. slowStartRate28dUserWeight (google.type.decimal): a média ponderada pelo usuário da métrica lentaStartRate nos 28 dias até a data e incluindo. 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 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 erro individuais que foram recebidos para um app.

Dimensões

Cada conjunto de métricas é compatível com um conjunto distinto de dimensões para filtragem e detalhamento. Confira o índice de dimensões abaixo para ver 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 da string dessa dimensão pode ser analisado como um número inteiro. Veja aqui mais detalhes sobre como o controle de versões do app 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 as características de software e hardware dele.

Dimensão	Descrição
`apiLevel`	O nível de API do Android que estava em execução no dispositivo do usuário no momento em que os dados foram capturados. O valor da string dessa dimensão pode ser analisado como um número inteiro. Veja aqui a lista de versões do Android e como elas são mapeadas para os níveis da API.
`deviceModel`	É o identificador de um modelo de dispositivo específico, conforme definido pelo catálogo de dispositivos do Play Console.
`deviceType`	É o identificador de um formato específico 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 dispositivo, por exemplo, Samsung Veja aqui.
`deviceSocModel`	O nome do modelo do sistema no chip principal do dispositivo, por exemplo, "Exynos 2100". Veja aqui.
`deviceCpuMake`	A 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`	A versão do Vulkan do dispositivo, como "4198400".
`deviceGlEsVersion`	Versão do OpenGL ES do dispositivo, por exemplo, "196610".
`deviceScreenSize`	Tamanho da tela do dispositivo, por exemplo, GRANDE, GRANDE.
`deviceScreenDpi`	Densidade de tela do dispositivo, por exemplo, mdpi, hdpi.