Method: vitals.anrrate.query

Consulta as métricas no conjunto de métricas.

Solicitação HTTP

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/anrRateMetricSet}:query

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso.

Formato: apps/{app}/anrRateMetricSet

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Campos
timelineSpec

object (TimelineSpec)

Especificação dos parâmetros de agregação da linha do tempo.

Períodos de agregação compatíveis:

  • DAILY: as métricas são agregadas em intervalos de datas do calendário. Devido a restrições históricas, o único fuso horário padrão e compatível é America/Los_Angeles.
  • HOURLY: as métricas são agregadas em intervalos por hora. O fuso horário padrão e único compatível é UTC.
dimensions[]

string

Dimensões pelas quais as métricas serão divididas.

Dimensões compatíveis:

  • apiLevel (string): o nível da API do Android que estava sendo executado no dispositivo do usuário, por exemplo, 26.
  • versionCode (int64): versão do app que estava em execução no dispositivo do usuário.
  • deviceModel (string): identificador exclusivo do modelo do dispositivo do usuário. O formato do identificador é "deviceBrand/device", em que deviceBrand corresponde a Build.BRAND e device corresponde a Build.DEVICE, por exemplo, google/coral.
  • deviceBrand (string): identificador exclusivo da marca do dispositivo do usuário, por exemplo, Google.
  • deviceType (string): o tipo (também conhecido como formato) do dispositivo do usuário, por exemplo, TELEFONE.
  • countryCode (string): o país ou a região do dispositivo 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).
  • deviceRamBucket (int64): RAM do dispositivo, em MB, em buckets (3 GB, 4 GB etc.).
  • deviceSocMake (string): marca do system on chip principal do dispositivo, por exemplo, Samsung. Referência
  • deviceSocModel (string): modelo do system on chip principal do dispositivo, por exemplo, "Exynos 2100". Referência
  • deviceCpuMake (string): marca da CPU do dispositivo, por exemplo, Qualcomm.
  • deviceCpuModel (string): modelo da CPU do dispositivo, por exemplo, "Kryo 240".
  • deviceGpuMake (string): marca da GPU do dispositivo, por exemplo, ARM.
  • deviceGpuModel (string): modelo da GPU do dispositivo, por exemplo, Mali.
  • deviceGpuVersion (string): versão da GPU do dispositivo, como Conexão T750
  • deviceVulkanVersion (string): versão Vulkan do dispositivo, como "4198400".
  • deviceGlEsVersion (string): versão do OpenGL ES do dispositivo, como e "196610".
  • deviceScreenSize (string): tamanho da tela do dispositivo. Por exemplo, NORMAL, GRANDE.
  • deviceScreenDpi (string): densidade da tela do dispositivo, por exemplo, mdpi, hdpi.
metrics[]

string

Métricas a serem agregadas.

Métricas compatíveis:

  • 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): valor médio contínuo de anrRate nos últimos 7 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • anrRate28dUserWeighted (google.type.Decimal): valor médio contínuo de anrRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • 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, os ANRs percebidos pelo usuário são do tipo "Envio de entrada".
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedAnrRate nos últimos 7 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Sem suporte na granularidade de HOURLY.
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal): valor médio contínuo de userPerceivedAnrRate nos últimos 28 dias. Os valores diários são ponderados pela contagem de usuários distintos no dia. Não . suportado na granularidade de HOURLY.
  • distinctUsers (google.type.Decimal): contagem de usuários distintos no período de agregação que foram usados como valor de normalização para as métricas anrRate e userPerceivedAnrRate. Um usuário é contabilizado nessa métrica se tiver usado o app em primeiro plano durante o período de agregação. Tome cuidado para não agregar mais essa contagem, já que isso pode fazer com que os usuários sejam contados várias vezes. O valor é arredondado para o múltiplo mais próximo de 10, 100, 1.000 ou 1.000.000, dependendo da magnitude do valor.
filter

string

Filtros a serem aplicados aos dados. A expressão de filtragem segue o padrão AIP-160 e é compatível com a filtragem por igualdade de todas as dimensões de detalhamento.

pageSize

integer

Tamanho máximo dos dados retornados.

Se não for especificado, no máximo 1.000 linhas serão retornadas. O valor máximo é 100.000. Valores acima desse valor serão convertidos para 100.000.

pageToken

string

Um token de página, recebido de uma chamada anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos à solicitação precisam corresponder à chamada que forneceu o token da página.

userCohort

enum (UserCohort)

Visualização do usuário a ser selecionada. Os dados de saída corresponderão à visualização selecionada.

Valores aceitos:

  • OS_PUBLIC Para selecionar dados de todas as versões do Android lançadas publicamente. Esse é o padrão. Oferece suporte a todas as dimensões acima.
  • APP_TESTERS Para selecionar dados de usuários que aceitaram participar do teste. Oferece suporte a todas as dimensões acima.
  • OS_BETA Para selecionar dados somente de versões Beta do Android, excluindo os dados das versões lançadas. Somente as seguintes dimensões são suportadas:
  • versionCode (int64): versão do app que estava em execução no dispositivo do usuário.

  • osBuild (string): build do SO do dispositivo do usuário, por exemplo, "T1B2.220916.004".

Corpo da resposta

Mensagem de resposta para anrrate.query.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Campos
rows[]

object (MetricsRow)

Linhas de dados retornadas.

nextPageToken

string

Token de continuação para buscar a próxima página de dados.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/playdeveloperreporting

Para mais informações, consulte a Visão geral do OAuth 2.0.