Wprowadzenie do zestawów wskaźników

Interfejs Google Play Developer Reporting API zapewnia dostęp do danych, raportów i osi czasu dotyczących Twoich aplikacji. Aby korzystanie z interfejsu API było jak najłatwiejsze, zestawy danych standaryzują dostęp do danych. Zbiór wskaźników to logiczne grupowanie powiązanych wskaźników, które mają wspólne atrybuty (na przykład aktualność i szczegółowość) i można wykonywać dotyczące ich zapytania. Zestaw danych zawiera też kilka wymiarów, których możesz używać do filtrowania lub tworzenia zestawienia. O ile nie wskazano inaczej, wszystkie dane możesz podzielić lub filtrować według wszystkich dostępnych wymiarów.

Aktualność

Każdy zasób zbioru danych zawiera standardową metodę GET służącą do pobierania daty i godziny ostatniego dostępnego punktu danych, nazywanego aktualnością. Zbiór wskaźników może obsługiwać wiele szczegółowości (codziennie, co godzinę), dlatego operacja zwraca 1 wartość świeżości na obsługiwaną szczegółowość.

Możesz użyć wartości aktualności bezpośrednio jako punktu końcowego w zakresie czasu zapytania.

Zapytania o dane

Aby uzyskać dostęp do danych w zbiorze danych, do wysyłania zapytań użyj niestandardowej metody QUERY. Każde zapytanie musi określać szczegółowość i zakres czasu. Razem z wskaźnikimi, do których chcesz uzyskać dostęp, musisz podać wymiary, które powinny być używane do podziału agregacji.

Zachowaj ostrożność, gdy prosisz o harmonogramy o wysyłanie żądań zakresu dat, tak aby rozmiar zakresu czasu był odwrotnie proporcjonalnie do rozmiaru aplikacji i liczby zestawienia. Duża aplikacja powinna na przykład wybierać mniej dni w pojedynczym żądaniu zapytania, aby uniknąć przekroczenia limitu czasu zapytania spowodowanego odczytaniem zbyt dużej ilości danych.

Dostępne zbiory wskaźników

Indeks poniżej zawiera wszystkie punkty końcowe i powiązane dane, o które możesz poprosić.

Zestaw danych	Opis	Obsługiwane dane
vitals.anrrate	Zawiera dane o błędach ANR w połączeniu z danymi o korzystaniu, aby wygenerować znormalizowane dane niezależne od liczby użytkowników.	anrRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, w których wystąpił co najmniej 1 błąd ANR. anrRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość danych anrRate w ciągu 7 dni do podanej daty. anrRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość danych anrRate od 28 dni do dnia włącznie. userPerceivedAnrRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, w których wystąpił co najmniej jeden błąd ANR. Obecnie liczone są wszystkie błędy ANR „wysyłania danych wejściowych”. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wskaźnika użytkownika (PerperivedAnrRate) w ciągu 7 dni (włącznie z datą). userPerceivedAnrRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość parametru userPerceivedAnrRate w ciągu 28 dni (włącznie z datą). distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, których dane były dostępne w okresie agregacji.
vitals.crashrate	Zawiera dane o awariach wraz z danymi o korzystaniu, co pozwala uzyskać znormalizowane dane niezależne od liczby użytkowników.	crashRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, w których wystąpiła co najmniej 1 awaria. crashRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wskaźnika awarii w ciągu 7 dni (włącznie z datą). crashRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wskaźnika awarii w ciągu 28 dni (włącznie z datą). userPerceivedCrashRate (google.type.Decimal): odsetek unikalnych użytkowników, którzy w okresie agregacji mieli co najmniej 1 awarię, gdy aplikacja była aktywna. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wskaźnika użytkownika (PerperivedCrashRate) w ciągu 7 dni (włącznie z datą). userPerceivedCrashRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość parametru userPerceivedCrashRate w ciągu 28 dni (włącznie z datą). distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, których dane były dostępne w okresie agregacji.
vitals.excessivewakeuprate	Zawiera dane o wybudzeniach aplikacji AlarmManager połączone z danymi o stanie procesu, co pozwala uzyskać znormalizowane dane niezależne od liczby użytkowników.	expexiveWakeupRate (google.type.Decimal): odsetek unikalnych użytkowników, którzy w okresie agregacji mieli ponad 10 wybudzeń na godzinę. exexiveWakeupRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia z nadmiarowej wartości getWakeupRate w ciągu 7 dni do podanej daty. expexiveWakeupRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wskaźnika nadmiernej liczby wybudzeń w ciągu 28 dni (włącznie z datą). distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, których dane były dostępne w okresie agregacji.
vitals.stuckbackgroundwakelockrate	Zawiera dane o czasie trwania blokady uśpienia w połączeniu z danymi o stanie procesu, aby utworzyć znormalizowane dane niezależne od liczby użytkowników.	stuckBgWakelockRate (google.type.Decimal): procent unikalnych użytkowników, którzy w okresie agregacji mieli ustawioną blokadę uśpienia w tle przez ponad godzinę. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ważona według użytkowników średnia wartość danych zablokowanychBgWakelockRate w okresie 7 dni do podanej daty. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ważona według użytkowników wartość danych zablokowaneBgWakelockRate w okresie od 28 dni do tej daty włącznie. distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, których dane były dostępne w okresie agregacji.
vitals.slowstartuprate	Zawiera dane o powolnym uruchamianiu aplikacji z podziałem na typy uruchomienia aplikacji (zimne, ciepłe, gorące).	slowStartRate (google.type.Decimal): odsetek unikalnych użytkowników w okresie agregacji, w których wystąpiło powolne uruchomienie. slowStartRate7dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość wskaźnika SlowStartRate od 7 dni do tej daty włącznie. slowStartRate28dUserWeighted (google.type.Decimal): ważona przez użytkowników średnia wartość wskaźnika SlowStartRate od 28 dni do tej daty włącznie. distinctUsers (google.type.Decimal): przybliżona liczba użytkowników, których dane były dostępne w okresie agregacji.
vitals.errors.counts	Zawiera znormalizowane liczby raportów o błędach.	Uwaga: ten zasób jest obecnie dostępny tylko w wersji 1 interfejsu API w wersji 1. errorReportCount (google.type.Decimal): bezwzględna liczba pojedynczych raportów o błędach otrzymanych w przypadku aplikacji.

Wymiary

Każdy zestaw danych obsługuje oddzielny zestaw wymiarów do filtrowania i zestawienia. Na liście wskaźników wymiarów znajdziesz listę wymiarów dostępnych w interfejsie API.

Wymiar	Opis
versionCode	Kod wersji aplikacji uruchomionej na urządzeniu użytkownika w momencie przechwytywania danych. Ciąg znaków tego wymiaru można przeanalizować jako liczbę całkowitą. Więcej informacji o obsłudze wersji aplikacji na Androida znajdziesz tutaj.
countryCode	Identyfikator kraju lub regionu użytkownika określony na podstawie jego adresu IP.Jest to dwuliterowy kod ISO-3166 (np. „US” w przypadku Stanów Zjednoczonych).

Wymiary urządzenia

Są to wymiary właściwe dla urządzenia oraz jego oprogramowania i sprzętu.

Wymiar	Opis
apiLevel	Poziom interfejsu API Androida, który działał na urządzeniu użytkownika w momencie przechwytywania danych. Ciąg znaków tego wymiaru można przeanalizować jako liczbę całkowitą. Tutaj znajdziesz listę wersji Androida oraz ich mapowanie na poziomy interfejsu API.
deviceModel	Identyfikator konkretnego modelu urządzenia zdefiniowany w katalogu urządzeń w Konsoli Play.
deviceType	Identyfikator konkretnego formatu urządzenia używanego w katalogu urządzeń w Konsoli Play.
deviceRamBucket	RAM urządzenia, w MB, w zasobnikach (3 GB, 4 GB itp.).
deviceSocMake	Marka głównego układu urządzenia, np. Samsung Zobacz tutaj.
deviceSocModel	Nazwa modelu głównego układu na urządzeniu, np. „Exynos 2100” Zobacz tutaj.
deviceCpuMake	Marka procesora urządzenia, np. Qualcomm.
deviceCpuModel	Model procesora urządzenia, np. „Kryo 240”.
deviceGpuMake	Marka GPU urządzenia, np. ARM.
deviceGpuModel	Model GPU urządzenia, np. Mali
deviceGpuVersion	Wersja GPU urządzenia, np. T750.
deviceVulkanVersion	Wersja interfejsu urządzenia Sense, np. „4198400”.
deviceGlEsVersion	Wersja OpenGL ES, np. „196610”
deviceScreenSize	Rozmiar ekranu urządzenia, np. NORMALNY, PÓŁNOCNY.
deviceScreenDpi	Gęstość ekranu urządzenia, np. mdpi lub hdpi.