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. Zestaw danych to logiczne grupowanie powiązanych danych, które mają wspólne atrybuty (np. aktualność i szczegółowość) i mogą być razem używane w zapytaniach. 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ść świeżości możesz użyć 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ść przy wyborze zakresów dat, 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 metryczny | 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 parametru anrRate z 7 dni do daty włącznie. anrRate28dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości 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 dane były dostępne w okresie agregacji. |
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 crashRate w ciągu 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 dane były dostępne w okresie agregacji. |
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) podczas aktywnego korzystania 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 dane były dostępne w okresie agregacji. |
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 do daty włącznie. distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, dla których dane były dostępne w okresie agregacji. |
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 blokada uśpienia była utrzymywana w tle przez ponad godzinę. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): średnia ważona według użytkowników wartości wskaźnika stuckBgWakelockRate z 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.slowstartuprate | 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 metryki slowStartRate w okresie 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 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.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, przedstawiony jako dwuliterowy kod 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. NORMALNY, DUŻY. |
deviceScreenDpi | Gęstość ekranu urządzenia, np. mdpi, hdpi. |