Mit der Google Play Developer Reporting API können Sie auf Messwerte, Berichte und Zeitachsendaten zu Ihren Apps zugreifen. Um die API-Nutzung so einfach wie möglich zu gestalten, wird der Messwertzugriff durch Messwertgruppen standardisiert. Ein Messwert-Set ist eine logische Gruppierung von zusammengehörigen Messwerten, die gemeinsame Attribute (z. B. Aktualität und Granularität) haben und zusammen abgefragt werden können. Ein Messwertset enthält auch eine Reihe von Dimensionen, mit denen Sie filtern oder Aufschlüsselungen erstellen können. Sofern nicht anders angegeben, können alle Messwerte nach allen verfügbaren Dimensionen aufgeschlüsselt oder gefiltert werden.
Aktualität
Jede Messwertgruppe bietet eine Standardmethode GET, um das Datum und die Uhrzeit des letzten verfügbaren Datenpunkts abzurufen. Dies wird als Aktualität bezeichnet. Da ein Messwertset mehrere Granularitäten (täglich, stündlich) unterstützen kann, wird für jede unterstützte Granularität ein Aktualitätswert zurückgegeben.
Sie können den Aktualitätswert direkt als Endpunkt in einem Abfragezeitraum verwenden.
Datenabfragen
Wenn Sie auf die Daten in einem Messwertset zugreifen möchten, sollten Sie die benutzerdefinierte Methode QUERY verwenden, um Abfragen auszuführen.
Für jede Abfrage müssen ein Detaillierungsgrad und ein Zeitraum angegeben werden. Zusammen mit den Messwerten, auf die Sie zugreifen möchten, sollten Sie die Dimensionen angeben, die zum Aufschlüsseln der Aggregationen verwendet werden sollen.
Achten Sie beim Anfordern von Zeitachsen darauf, dass die Größe des Zeitbereichs umgekehrt proportional zur Größe Ihrer App und zur Anzahl der Aufschlüsselungen ist. Bei einer großen App sollten beispielsweise weniger Tage in einer einzelnen Abfrageanfrage ausgewählt werden, um Abfragetimeouts zu vermeiden, die durch das Lesen zu vieler Daten verursacht werden.
Verfügbare Messwertgruppen
Im Index unten sind alle Endpunkte und zugehörigen Daten aufgeführt, die Sie anfordern können.
| Messwertgruppe | Beschreibung | Unterstützte Messwerte |
|---|---|---|
vitals.anrrate |
Enthält ANR-Daten, die mit Nutzungsdaten kombiniert werden, um einen normalisierten Messwert zu erhalten, der unabhängig von der Anzahl der Nutzer ist. |
anrRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein ANR-Fehler aufgetreten ist. anrRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „anrRate“ in den 7 Tagen bis einschließlich des Datums. anrRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „anrRate“ in den 28 Tagen bis einschließlich des Datums. userPerceivedAnrRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein vom Nutzer wahrgenommener ANR-Fehler aufgetreten ist. Derzeit werden nur ANR-Fehler vom Typ „Input dispatching“ gezählt. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedAnrRate“ in den 7 Tagen bis einschließlich des Datums. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedAnrRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.crashrate |
Enthält Absturzdaten, die mit Nutzungsdaten kombiniert werden, um einen normalisierten Messwert zu erhalten, der unabhängig von der Anzahl der Nutzer ist. |
crashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist. crashRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „crashRate“ in den 7 Tagen bis einschließlich des Datums. crashRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „crashRate“ in den 28 Tagen bis einschließlich des Datums. userPerceivedCrashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist, während die App aktiv verwendet wurde. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedCrashRate“ in den 7 Tagen bis einschließlich des Datums. userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedCrashRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.lmkrate
|
Enthält LMK-Daten (Low-Memory-Kill), die mit Nutzungsdaten kombiniert werden, um einen normalisierten Messwert zu erhalten, der unabhängig von der Anzahl der Nutzer ist. |
userPerceivedLmkRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein LMK (Low Memory Killer) aufgetreten ist, während sie Ihre App aktiv verwendet haben. Eine App gilt als aktiv verwendet, wenn sie eine Aktivität anzeigt oder einen Vordergrunddienst ausführt. userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedLmkRate“ in den 7 Tagen bis einschließlich des Datums. userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedLmkRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.excessivewakeuprate |
Enthält Daten zu AlarmManager-Aktivierungen in Kombination mit Daten zum Prozessstatus, um einen normalisierten Messwert zu erhalten, der unabhängig von der Anzahl der Nutzer ist. |
excessiveWakeupRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, die mehr als 10 Wakeups pro Stunde hatten.
excessiveWakeupRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „excessiveWakeupRate“ in den 7 Tagen bis einschließlich des Datums. excessiveWakeupRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „excessiveWakeupRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.stuckbackgroundwakelockrate |
Enthält Daten zur Dauer von PowerManager-Wakelocks in Kombination mit Daten zum Prozessstatus, um einen normalisierten Messwert zu erhalten, der unabhängig von der Anzahl der Nutzer ist. |
stuckBgWakelockRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen ein Wakelock im Hintergrund länger als eine Stunde gehalten wurde.
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „stuckBgWakelockRate“ in den 7 Tagen bis einschließlich des Datums. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „stuckBgWakelockRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.slowstartuprate |
Enthält Daten zu langsamen App-Starts, aufgeschlüsselt nach Art des App-Starts (Kalt-, Warm- und Heißstart). |
slowStartRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, die ein Ereignis mit langsamen Start hatten.
slowStartRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „slowStartRate“ in den 7 Tagen bis einschließlich des Datums. slowStartRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „slowStartRate“ in den 28 Tagen bis einschließlich des Datums. distinctUsers (google.type.Decimal): Die ungefähre Anzahl der Nutzer, für die im Aggregationszeitraum Daten verfügbar waren. |
vitals.errors.counts |
Enthält nicht normalisierte Anzahl von Fehlerberichten. |
Hinweis:Diese Ressource ist derzeit nur in der v1-Alphadatei der API verfügbar. errorReportCount (google.type.Decimal): Absolute Anzahl der einzelnen Fehlerberichte, die für eine App eingegangen sind. |
Dimensionen
Jeder Messwertgruppe ist eine bestimmte Gruppe von Dimensionen für Filter und Aufschlüsselungen zugeordnet. Im Dimensionsindex unten finden Sie eine Liste der in der API verfügbaren Dimensionen.
| Dimension | Beschreibung |
|---|---|
versionCode |
Der Versionscode der App, die auf dem Gerät des Nutzers ausgeführt wurde, als die Daten erfasst wurden. Der Stringwert dieser Dimension kann als Ganzzahl geparst werden. Weitere Informationen zur Funktionsweise der App-Versionsverwaltung unter Android |
countryCode |
Kennung des Landes oder der Region des Nutzers basierend auf seiner IP-Adresse, dargestellt als zweistelliger ISO-3166-Code (z.B. US für die USA). |
Abmessungen
Das sind die Dimensionen, die sich auf das Gerät und seine Software- und Hardwaremerkmale beziehen.
| Dimension | Beschreibung |
|---|---|
apiLevel |
Das API-Level von Android, das auf dem Gerät des Nutzers zum Zeitpunkt der Datenerfassung ausgeführt wurde. Der Stringwert dieser Dimension kann als Ganzzahl geparst werden. Eine Liste der Android-Versionen und der entsprechenden API-Levels finden Sie hier. |
deviceModel |
Kennung eines bestimmten Gerätemodells, wie im Gerätekatalog der Play Console definiert. |
deviceType |
Kennung eines bestimmten Geräteformfaktors, wie er im Gerätekatalog der Play Console verwendet wird. |
deviceRamBucket |
RAM des Geräts in MB, in Gruppen (3 GB, 4 GB usw.). |
deviceSocMake |
Die Marke des primären System-on-Chip des Geräts, z.B. Samsung. Weitere Informationen |
deviceSocModel |
Der Modellname des primären System-on-Chip des Geräts, z.B. „Exynos 2100“. Weitere Informationen |
deviceCpuMake |
Marke der CPU des Geräts, z.B. Qualcomm |
deviceCpuModel |
Modell der CPU des Geräts, z.B. „Kryo 240“. |
deviceGpuMake |
Marke der GPU des Geräts, z.B. ARM |
deviceGpuModel |
Modell der GPU des Geräts, z.B. Mali |
deviceGpuVersion |
Version der GPU des Geräts, z.B. T750 |
deviceVulkanVersion |
Vulkan-Version des Geräts, z.B. „4198400“. |
deviceGlEsVersion |
OpenGL ES-Version des Geräts, z.B. „196610“. |
deviceScreenSize |
Displaygröße des Geräts, z.B. NORMAL, GROSS. |
deviceScreenDpi |
Bildschirmdichte des Geräts, z.B. „mdpi“ oder „hdpi“. |