Diese Seite wurde von der Cloud Translation API übersetzt.

Einführung in Messwertsätze

Über die Google Play Developer Reporting API können Sie auf Messwerte, Berichte und Zeitachseninformationen zu Ihren Apps zugreifen. Um die API-Nutzung so einfach wie möglich zu gestalten, standardisieren Messwertsätze den Messwertzugriff. Ein Messwertsatz ist eine logische Gruppierung verwandter Messwerte mit gemeinsamen Attributen (wie Aktualität und Detaillierungsgrad) und kann gemeinsam abgefragt werden. Ein Messwertsatz enthält außerdem eine Reihe von Dimensionen, mit denen Sie Aufschlüsselungen filtern oder erstellen können. Sofern nicht anders angegeben, können alle Messwerte nach allen verfügbaren Dimensionen aufgeschlüsselt oder gefiltert werden.

Aktualität

Jede Ressource des Messwertsatzes bietet eine Standardmethode GET, um das Datum und die Uhrzeit des letzten verfügbaren Datenpunkts, die Aktualität, abzurufen. Da ein Messwertsatz mehrere Granularitäten (täglich, stündlich) unterstützen kann, gibt der Vorgang einen Aktualitätswert pro unterstütztem Detaillierungsgrad zurück.

Sie können den Wert für die Aktualität direkt als Endpunkt in einem Abfragezeitraum verwenden.

Datenabfragen

Für den Zugriff auf die Daten in einem Messwertsatz sollten Sie die benutzerdefinierte Methode QUERY für Abfragen verwenden. 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.

Gehen Sie bei der Anforderung von Zeiträumen für den Anfragezeitraum vorsichtig vor, damit die Größe des Zeitraums umgekehrt proportional zur Größe Ihrer Anwendung und der Anzahl der Aufschlüsselungen ist. Beispielsweise sollte eine große Anwendung weniger Tage in einer einzelnen Abfrageanfrage auswählen, um Zeitüberschreitungen bei Abfragen zu vermeiden, die durch das Lesen von zu vielen Daten verursacht werden.

Verfügbare Messwertsätze

Im folgenden Index sind alle Endpunkte und die zugehörigen Daten aufgeführt, die Sie anfordern können.

Messwertsatz	Beschreibung	Unterstützte Messwerte
`vitals.anrrate`	Enthält ANR-Daten in Kombination mit Nutzungsdaten, um unabhängig von der Nutzeranzahl einen normalisierten Messwert zu erstellen.	anrRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein ANR-Fehler aufgetreten ist. anrRate7dUserWeighted (google.type.Decimal): Der vom Nutzer gewichtete Durchschnitt des Messwerts „anrRate“ in den sieben Tagen bis zum Datum. anrRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des anrRate-Messwerts in den 28 Tagen bis zum Datum. userPerceivedAnrRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein vom Nutzer wahrgenommener ANR-Fehler aufgetreten ist. Derzeit werden EINe ANRs von "Eingabeweiterleitung" gezählt. userPerceivedAnrRate7dUserWeighted (google.type.Decimal): Der vom Nutzer gewichtete Durchschnitt des Messwerts „userPerceivedAnrRate“ in den 7 Tagen bis einschließlich zum Datum. userPerceivedAnrRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „userPerceivedAnrRate“ in den 28 Tagen bis einschließlich zum Datum. distinctUsers (google.type.Decimal): Die ungefähre Anzahl von Nutzern, für die im Zusammenfassungszeitraum Daten verfügbar waren.
`vitals.crashrate`	Enthält Absturzdaten kombiniert mit Nutzungsdaten, um einen normalisierten Messwert unabhängig von der Anzahl der Nutzer zu erstellen.	crashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist. crashRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt der Absturzrate in den 7 Tagen bis einschließlich zum Datum. crashRate28dUserWeighted (google.type.Decimal): Der nach Nutzer gewichtete Durchschnitt des Absturzratenmesswerts in den 28 Tagen bis einschließlich zum Datum. userPerceivedCrashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen während der aktiven Nutzung der App mindestens ein Absturz aufgetreten ist. userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Der vom Nutzer gewichtete Durchschnitt des Messwerts „userPerceivedCrashRate“ in den 7 Tagen bis einschließlich zum Datum. 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 von Nutzern, für die im Zusammenfassungszeitraum Daten verfügbar waren.
`vitals.excessivewakeuprate`	Enthält Wecker-Wakeup-Daten zusammen mit Daten zum Prozessstatus, um einen normalisierten Messwert unabhängig von der User-Zahl zu erzeugen.	excessiveWakeupRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum mit mehr als 10 Wakeups pro Stunde. excessiveWakeupRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „übermäßiger WakeupRate“ in den sieben Tagen bis zum einschließlich Datum. excessiveWakeupRate28dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „übermäßiger WakeupRate“ in den 28 Tagen bis einschließlich zum Datum. distinctUsers (google.type.Decimal): Die ungefähre Anzahl von Nutzern, für die im Zusammenfassungszeitraum Daten verfügbar waren.
`vitals.stuckbackgroundwakelockrate`	Enthält Daten zur PowerManager-Wakelock-Dauer in Kombination mit Daten zum Prozessstatus, um einen normalisierten Messwert unabhängig von der Nutzerzahl zu erstellen.	stuckBgWakelockRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen länger als 1 Stunde eine Wakelock im Hintergrund ausgeführt wurde. stuckBgWakelockRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des hängenden BgWakelockRate-Messwerts in den sieben Tagen bis zum Datum. stuckBgWakelockRate28dUserWeighted (google.type.Decimal): Der vom Nutzer gewichtete Durchschnitt des hängenden BgWakelockRate-Messwerts in den 28 Tagen bis einschließlich zum Datum. distinctUsers (google.type.Decimal): Die ungefähre Anzahl von Nutzern, für die im Zusammenfassungszeitraum Daten verfügbar waren.
`vitals.slowstartuprate`	Enthält Daten zum langsamen App-Start, aufgeschlüsselt nach dem Typ des App-Starts (kalt, warm, heiß).	slowStartRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Zusammenfassungszeitraum, die ein langsames Startereignis hatten. slowStartRate7dUserWeighted (google.type.Decimal): Der nutzergewichtete Durchschnitt des Messwerts „slowStartRate“ in den sieben Tagen bis zum Datum. slowStartRate28dUserWeighted (google.type.Decimal): Der vom Nutzer gewichtete Durchschnitt des Messwerts „slowStartRate“ in den 28 Tagen bis einschließlich zum Datum. distinctUsers (google.type.Decimal): Die ungefähre Anzahl von Nutzern, für die im Zusammenfassungszeitraum Daten verfügbar waren.
`vitals.errors.counts`	Enthält nicht normalisierte Fehlerberichtzahlen.	Hinweis: Diese Ressource ist vorerst nur in der V1-Alphaversion der API verfügbar. errorReportCount (google.type.Decimal): Die absolute Anzahl der einzelnen Fehlerberichte, die für eine App empfangen wurden.

Dimensionen

Jeder Messwertsatz unterstützt bestimmte Dimensionen für Filter und Aufschlüsselungen. Eine Liste der in der API verfügbaren Dimensionen finden Sie im Dimensionsindex unten.

Dimension	Beschreibung
`versionCode`	Der Versionscode der App, die zum Zeitpunkt der Datenerfassung auf dem Gerät des Nutzers ausgeführt wurde. Der Stringwert dieser Dimension kann als Ganzzahl geparst werden. Weitere Informationen zur Funktionsweise der App-Versionsverwaltung unter Android finden Sie hier.
`countryCode`	Kennzeichnung des Landes oder der Region des Nutzers auf Basis seiner IP-Adresse, dargestellt als ISO 3166-Code mit zwei Buchstaben (z.B. US für die USA).

Geräteabmessungen

Dies sind die spezifischen Abmessungen des Geräts sowie die zugehörigen Software- und Hardwaremerkmale.

Dimension	Beschreibung
`apiLevel`	Die API-Ebene von Android, die zum Zeitpunkt der Datenerhebung auf dem Gerät des Nutzers ausgeführt wurde. Der Stringwert dieser Dimension kann als Ganzzahl geparst werden. Eine Liste der Android-Releases und deren Zuordnung zu API-Levels findest du hier.
`deviceModel`	Kennung eines bestimmten Gerätemodells, wie im Play Console-Gerätekatalog definiert.
`deviceType`	Kennung eines bestimmten Geräteformfaktors gemäß dem Play Console-Gerätekatalog.
`deviceRamBucket`	RAM des Geräts in MB (in Buckets, 3 GB, 4 GB usw.).
`deviceSocMake`	Die Marke des primären System-on-Chips, z.B. Samsung Weitere Informationen
`deviceSocModel`	Der Modellname des primären System-on-Chips des Geräts, z.B. „Exynos 2100“. Weitere Informationen
`deviceCpuMake`	Die CPU des Geräts, z.B. Qualcomm.
`deviceCpuModel`	Modell der CPU des Geräts, z.B. „Kryo 240“.
`deviceGpuMake`	Die 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`	Bildschirmgröße des Geräts, z.B. Normal, groß.
`deviceScreenDpi`	Bildschirmdichte des Geräts, z. B. mdpi, hdpi