Method: vitals.anrrate.query

Wysyła zapytanie o dane w zbiorze danych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
name

string

Wymagane. Nazwa zasobu.

Format: apps/{app}/anrRateMetricSet

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Pola
timelineSpec

object (TimelineSpec)

Opcjonalnie. Specyfikacja parametrów agregacji osi czasu.

Obsługiwane okresy agregacji:

  • DAILY: dane są agregowane w przedziałach dat kalendarzowych. Ze względu na ograniczenia historyczne domyślną i jedyną obsługiwaną strefą czasową jest America/Los_Angeles.
  • HOURLY: dane są agregowane w przedziałach godzinowych. Domyślną i jedyną obsługiwaną strefą czasową jest UTC.
dimensions[]

string

Opcjonalnie. Wymiary, według których mają być dzielone dane.

Obsługiwane wymiary:

  • apiLevel (string): poziom interfejsu API Androida, który był używany na urządzeniu użytkownika, np. 26.
  • versionCode (int64): wersja aplikacji, która była używana na urządzeniu użytkownika.
  • deviceModel (string): unikalny identyfikator modelu urządzenia użytkownika. Identyfikator ma postać „deviceBrand/device”, gdzie deviceBrand odpowiada Build.BRAND, a device odpowiada Build.DEVICE, np. google/coral.
  • deviceBrand (string): unikalny identyfikator marki urządzenia użytkownika, np. google.
  • deviceType (string): typ (znany też jako format) urządzenia użytkownika, np. PHONE.
  • countryCode (string): kraj lub region urządzenia użytkownika na podstawie jego adresu IP, przedstawiony jako 2-literowy kod ISO-3166 (np. US w przypadku Stanów Zjednoczonych).
  • deviceRamBucket (int64): pamięć RAM urządzenia w MB, w przedziałach (np. 1024 w przypadku 1–1,5 GB, 4096 w przypadku 4–6 GB).
  • deviceSocMake (string): producent głównego układu SoC urządzenia, np. Samsung. Informacje
  • deviceSocModel (string): model głównego układu SoC urządzenia, np. „Exynos 2100”. Informacje
  • deviceCpuMake (string): producent procesora urządzenia, np. Qualcomm.
  • deviceCpuModel (string): model procesora urządzenia, np. „Kryo 240”.
  • deviceGpuMake (string): producent procesora graficznego urządzenia, np. ARM.
  • deviceGpuModel (string): model procesora graficznego urządzenia, np. Mali.
  • deviceGpuVersion (string): wersja procesora graficznego urządzenia, np. T750.
  • deviceVulkanVersion (string): wersja Vulkan na urządzeniu, np. „4198400”.
  • deviceGlEsVersion (string): wersja OpenGL ES na urządzeniu, np. „196610”.
  • deviceScreenSize (string): rozmiar ekranu urządzenia, np. NORMAL, LARGE.
  • deviceScreenDpi (string): gęstość ekranu urządzenia, np. mdpi, hdpi.
metrics[]

string

Opcjonalnie. Dane do agregacji.

Obsługiwane dane:

  • anrRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpił co najmniej 1 błąd ANR.
  • anrRate7dUserWeighted (google.type.Decimal): średnia krocząca wartość anrRate z ostatnich 7 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości HOURLY.
  • anrRate28dUserWeighted (google.type.Decimal): średnia krocząca wartość anrRate z ostatnich 28 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości HOURLY.
  • userPerceivedAnrRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpił co najmniej 1 błąd ANR widoczny dla użytkowników. Błędy ANR widoczne dla użytkowników to obecnie błędy typu 'Input dispatching'.
  • userPerceivedAnrRate7dUserWeighted (google.type.Decimal): średnia ruchoma wartość userPerceivedAnrRate z ostatnich 7 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nieobsługiwane w przypadku szczegółowości HOURLY.
  • userPerceivedAnrRate28dUserWeighted (google.type.Decimal): średnia ruchoma wartość userPerceivedAnrRate z ostatnich 28 dni. Wartości dzienne są ważone przez liczbę unikalnych użytkowników w danym dniu. Nie . obsługiwane w przypadku szczegółowości HOURLY.
  • distinctUsers (google.type.Decimal): liczba unikalnych użytkowników w okresie agregacji, którzy byli używani jako wartość normalizująca w przypadku danych anrRate i userPerceivedAnrRate. Użytkownik jest uwzględniany w tych danych, jeśli korzystał z aplikacji na pierwszym planie w okresie agregacji. Należy uważać, aby nie agregować tej liczby, ponieważ może to spowodować wielokrotne zliczanie użytkowników. Wartość jest zaokrąglana do najbliższej wielokrotności 10, 100, 1000 lub 1 000 000 w zależności od jej wielkości.
filter

string

Opcjonalnie. Filtry do zastosowania do danych. Wyrażenie filtrujące jest zgodne ze standardem AIP-160 i obsługuje filtrowanie według równości wszystkich wymiarów podziału.

pageSize

integer

Opcjonalnie. Maksymalny rozmiar zwracanych danych.

Jeśli nie podano tego argumentu, zwracanych jest co najwyżej 1000 wierszy. Maksymalna wartość to 100 000. Wartości powyżej 100 000 zostaną zmienione na 100 000.

pageToken

string

Opcjonalnie. Token strony otrzymany z poprzedniego wywołania. Podaj go, aby pobrać następną stronę.

Podczas paginowania wszystkie inne parametry podane w żądaniu muszą być zgodne z wywołaniem, które zwróciło token strony.

userCohort

enum (UserCohort)

Opcjonalnie. Widok użytkownika do wybrania. Dane wyjściowe będą odpowiadać wybranemu widokowi.

Obsługiwane wartości:

  • OS_PUBLIC – aby wybrać dane ze wszystkich publicznie udostępnionych wersji Androida. Jest to ustawienie domyślne. Obsługuje wszystkie wymiary wymienione powyżej.
  • APP_TESTERS – aby wybrać dane od użytkowników, którzy wyrazili zgodę na udział w testach. Obsługuje wszystkie wymiary wymienione powyżej.
  • OS_BETA – aby wybrać dane tylko z wersji beta Androida, z wyłączeniem danych z wydanych wersji Androida. Obsługiwane są tylko te wymiary:
  • versionCode (int64): wersja aplikacji, która była używana na urządzeniu użytkownika.

  • osBuild (string): kompilacja systemu operacyjnego na urządzeniu użytkownika, np. „T1B2.220916.004”.

Treść odpowiedzi

Wiadomość odpowiedzi na anrrate.query.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Pola
rows[]

object (MetricsRow)

Zwrócone wiersze danych.

nextPageToken

string

Token kontynuacji do pobrania następnej strony danych.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w OAuth 2.0 Overview.