Wprowadzenie do zestawów danych

Interfejs Google Play Developer Reporting API umożliwia dostęp do danych, raportów i informacji o osi czasu dotyczących Twoich aplikacji. Aby jak najbardziej uprościć korzystanie z interfejsu API, zbiory danych ujednolicają dostęp do danych. Zbiór danych to logiczne zgrupowanie powiązanych danych, które mają wspólne atrybuty (np. aktualność i szczegółowość) i mogą być wysyłane w zapytaniach razem. Zestaw danych zawiera też kilka wymiarów, których możesz używać do filtrowania lub tworzenia podziałów. O ile nie określono inaczej, wszystkie dane można podzielić lub filtrować według wszystkich dostępnych wymiarów.

Aktualność

Każdy zasób zestawu wskaźników oferuje standardową metodę GET pobierania daty i godziny ostatniego dostępnego punktu danych, czyli aktualności. Jako że zestaw danych może obsługiwać wiele poziomów szczegółowości (dzienny, godzinowy), operacja zwraca jedną wartość świeżości dla każdego obsługiwanego poziomu szczegółowości.

Wartości świeżości możesz używać bezpośrednio jako punktu końcowego w zakresie czasu zapytania.

Zapytania o dane

Aby uzyskać dostęp do danych w zestawie danych, użyj niestandardowej metody QUERY do wysyłania zapytań. Każde zapytanie musi określać szczegółowość i zakres czasu. Oprócz danych, do których chcesz uzyskać dostęp, musisz określić wymiary, które mają być używane do podziału agregacji.

Wysyłając żądania dotyczące osi czasu, należy zachować ostrożność i określać zakresy dat w taki sposób, aby rozmiar zakresu czasu był odwrotnie proporcjonalny do rozmiaru aplikacji i liczby podziałów. Na przykład w przypadku dużej aplikacji w jednym żądaniu zapytania należy wybrać mniej dni, aby uniknąć przekroczenia limitu czasu zapytania spowodowanego odczytaniem zbyt dużej ilości danych.

Dostępne zestawy danych

Indeks poniżej zawiera listę wszystkich punktów końcowych i powiązanych z nimi danych, o które możesz poprosić.

Zestaw danych Opis Obsługiwane dane
vitals.anrrate Zawiera dane ANR połączone z danymi o użytkowaniu, aby uzyskać znormalizowane dane niezależne od liczby użytkowników. 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 ważona według użytkowników wartości metryki anrRate w ciągu 7 dni do daty włącznie.
anrRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości danych anrRate z 28 dni do daty włącznie.
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. Obecnie zliczane są tylko błędy ANR „Input dispatching” (Wysyłanie danych wejściowych).
userPerceivedAnrRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości danych userPerceivedAnrRate w ciągu 7 dni do daty włącznie.
userPerceivedAnrRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości danych userPerceivedAnrRate z 28 dni do daty włącznie.
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.crashrate Zawiera dane o awariach połączone z danymi o korzystaniu, aby uzyskać znormalizowane dane niezależne od liczby użytkowników. crashRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiła co najmniej 1 awaria.
crashRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości wskaźnika crashRate z 7 dni do daty włącznie.
crashRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości crashRate z 28 dni do daty włącznie.
userPerceivedCrashRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiła co najmniej 1 awaria podczas aktywnego korzystania z aplikacji.
userPerceivedCrashRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości userPerceivedCrashRate w ciągu 7 dni do daty włącznie.
userPerceivedCrashRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości danych userPerceivedCrashRate z 28 dni do daty włącznie.
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.lmkrate Zawiera dane LMK (low memory kill) połączone z danymi o użytkowaniu, aby uzyskać znormalizowane dane niezależne od liczby użytkowników. userPerceivedLmkRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpił co najmniej 1 błąd LMK (low memory kill), gdy aktywnie korzystali z aplikacji. Aplikacja jest uznawana za aktywnie używaną, jeśli wyświetla jakąkolwiek aktywność lub wykonuje dowolną usługę na pierwszym planie.
userPerceivedLmkRate7dUserWeighted (google.type.Decimal): średnia ważona przez użytkowników wartości danych userPerceivedLmkRate w ciągu 7 dni do daty włącznie.
userPerceivedLmkRate28dUserWeighted (google.type.Decimal): średnia ważona przez użytkowników wartości danych userPerceivedLmkRate z 28 dni do daty włącznie.
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.excessivewakeuprate Zawiera dane o liczbie wybudzeń AlarmManager połączone z danymi o stanie procesu, aby uzyskać znormalizowane dane niezależne od liczby użytkowników. excessiveWakeupRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiło ponad 10 wybudzeń na godzinę. excessiveWakeupRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości wskaźnika excessiveWakeupRate w ciągu 7 dni do daty włącznie.
excessiveWakeupRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości wskaźnika excessiveWakeupRate z 28 dni poprzedzających datę (włącznie z nią).
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.stuckbackgroundwakelockrate Zawiera dane o czasie trwania blokady wybudzania PowerManager połączone z danymi o stanie procesu, aby uzyskać znormalizowane dane niezależne od liczby użytkowników. stuckBgWakelockRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, u których wystąpiła blokada uśpienia w tle trwająca dłużej niż godzinę. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości metryki stuckBgWakelockRate w ciągu 7 dni do daty włącznie.
stuckBgWakelockRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości metryki stuckBgWakelockRate z 28 dni do daty włącznie.
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.slowstartrate Zawiera dane o powolnym uruchamianiu aplikacji z podziałem na typ uruchomienia (na zimno, na ciepło, z pamięci). slowStartRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, którzy wywołali zdarzenie powolnego uruchamiania. slowStartRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości wskaźnika slowStartRate w ciągu 7 dni do daty włącznie.
slowStartRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości danych slowStartRate z 28 dni do daty włącznie.
distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których w okresie agregacji były dostępne dane.
vitals.errors.counts Zawiera nieunormowane liczby raportów o błędach. Uwaga: ten zasób jest obecnie dostępny tylko w wersji alfa 1 interfejsu API.
errorReportCount (google.type.Decimal): bezwzględna liczba poszczególnych raportów o błędach otrzymanych w przypadku aplikacji.

Wymiary

Każdy zestaw danych obsługuje inny zestaw wymiarów do filtrowania i podziałów. Poniżej znajdziesz indeks wymiarów, w którym wymienione są wymiary dostępne w API.

Wymiar Opis
versionCode Kod wersji aplikacji, która była uruchomiona na urządzeniu użytkownika w momencie rejestrowania danych. Wartość ciągu znaków tego wymiaru można przeanalizować jako liczbę całkowitą. Więcej informacji o tym, jak działa wersjonowanie aplikacji na Androidzie, znajdziesz tutaj.
countryCode Identyfikator kraju lub regionu użytkownika na podstawie jego adresu IP w formie dwuliterowego kodu ISO 3166 (np. US w przypadku Stanów Zjednoczonych).

Wymiary urządzenia

Są to wymiary specyficzne dla urządzenia oraz jego oprogramowania i sprzętu.

Wymiar Opis
apiLevel Poziom interfejsu API Androida, który był uruchomiony na urządzeniu użytkownika w momencie rejestrowania danych. Wartość ciągu znaków tego wymiaru można przeanalizować jako liczbę całkowitą. Listę wersji Androida i odpowiadających im poziomów interfejsu API znajdziesz tutaj.
deviceModel Identyfikator konkretnego modelu urządzenia zdefiniowany w katalogu urządzeń w Konsoli Play.
deviceType Identyfikator konkretnego typu urządzenia używany w katalogu urządzeń w Konsoli Play.
deviceRamBucket Pamięć RAM urządzenia w MB, w przedziałach (3 GB, 4 GB itp.).
deviceSocMake Marka głównego układu SOC urządzenia, np. Samsung. Zobacz tutaj.
deviceSocModel Nazwa modelu głównego układu SoC urządzenia, np. „Exynos 2100”. Zobacz tutaj.
deviceCpuMake Marka procesora urządzenia, np. Qualcomm.
deviceCpuModel Model procesora urządzenia, np. „Kryo 240”.
deviceGpuMake Marka procesora graficznego urządzenia, np. ARM.
deviceGpuModel Model procesora graficznego urządzenia, np. Mali.
deviceGpuVersion Wersja procesora graficznego urządzenia, np. T750.
deviceVulkanVersion Wersja interfejsu Vulkan na urządzeniu, np. „4198400”.
deviceGlEsVersion Wersja OpenGL ES urządzenia, np. „196610”.
deviceScreenSize Rozmiar ekranu urządzenia, np. NORMAL, LARGE.
deviceScreenDpi Gęstość ekranu urządzenia, np. mdpi, hdpi.