Method: vitals.crashrate.query

Fragt die Messwerte im Messwertsatz ab.

HTTP-Anfrage

POST https://playdeveloperreporting.googleapis.com/v1alpha1/{name=apps/*/crashRateMetricSet}:query

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname

Format: apps/{app}/crashRateMetricSet

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Felder
timelineSpec

object (TimelineSpec)

Spezifikation der Zeitachsen-Aggregationsparameter.

Unterstützte Aggregationszeiträume:

  • DAILY: Messwerte werden in Kalenderdatumsintervallen zusammengefasst. Aufgrund von historischen Einschränkungen ist America/Los_Angeles die einzige unterstützte Standardzeitzone.
  • HOURLY: Messwerte werden in stündlichen Intervallen zusammengefasst. Die standardmäßige und nur unterstützte Zeitzone ist UTC.
dimensions[]

string

Dimensionen, nach denen die Messwerte aufgeschlüsselt werden sollen.

Unterstützte Dimensionen:

  • apiLevel (string): das API-Level von Android, das auf dem Gerät des Nutzers ausgeführt wurde, z.B. 26.
  • versionCode (int64): Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.
  • deviceModel (string): eindeutige Kennung des Gerätemodells des Nutzers Die Form der Kennung ist „deviceBrand/device“, wobei „deviceBrand“ Build.BRAND und „device“ „Build.DEVICE“ entspricht, z.B. google/coral.
  • deviceBrand (string): Die eindeutige Kennung der Gerätemarke des Nutzers, z.B. Google.
  • deviceType (string): der Typ (auch Formfaktor genannt) des Geräts des Nutzers, z.B. PHONE.
  • countryCode (string): das Land oder die Region des Geräts des Nutzers basierend auf seiner IP-Adresse, dargestellt als zweistelliger ISO 3166-Code (z.B. US für die USA).
  • deviceRamBucket (int64): RAM des Geräts in MB in Buckets (3 GB, 4 GB usw.).
  • deviceSocMake (string): Marke des primären System-on-Chips des Geräts, z.B. Samsung Referenz
  • deviceSocModel (string): Modell des primären System-on-Chips des Geräts, z.B. „Exynos 2100“. Referenz
  • deviceCpuMake (string): Marke der CPU des Geräts, z.B. Qualcomm.
  • deviceCpuModel (string): Modell der CPU des Geräts, z.B. „Kryo 240“.
  • deviceGpuMake (string): Marke der GPU des Geräts, z.B. ARM.
  • deviceGpuModel (string): Modell der GPU des Geräts, z.B. Mali
  • deviceGpuVersion (string): Version der GPU des Geräts, z.B. T750
  • deviceVulkanVersion (string): Vulkan-Version des Geräts, z.B. „4198400“.
  • deviceGlEsVersion (string): OpenGL ES-Version des Geräts, z.B. „196610“.
  • deviceScreenSize (string): Bildschirmgröße des Geräts, z.B. NORMAL, GROSS.
  • deviceScreenDpi (string): Bildschirmdichte des Geräts, z.B. mdpi, hdpi.
metrics[]

string

Zu aggregierende Messwerte.

Unterstützte Messwerte:

  • crashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen mindestens ein Absturz aufgetreten ist.
  • crashRate7dUserWeighted (google.type.Decimal): gleitender Durchschnitt von crashRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet.
  • crashRate28dUserWeighted (google.type.Decimal): gleitender Durchschnitt von crashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad STÜNDLICH nicht unterstützt.
  • userPerceivedCrashRate (google.type.Decimal): Prozentsatz der einzelnen Nutzer im Aggregationszeitraum, bei denen während der aktiven Nutzung deiner App mindestens ein Absturz aufgetreten ist (vom Nutzer wahrgenommener Absturz). Eine App gilt als aktiv, wenn sie Aktivitäten anzeigt oder Dienste im Vordergrund ausführt.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): gleitender Durchschnitt von userPerceivedCrashRate in den letzten 7 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad STÜNDLICH nicht unterstützt.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): gleitender Durchschnitt von userPerceivedCrashRate in den letzten 28 Tagen. Die Tageswerte werden nach der Anzahl der einzelnen Nutzer für den Tag gewichtet. Wird im Detaillierungsgrad STÜNDLICH nicht unterstützt.
  • distinctUsers (google.type.Decimal): Anzahl der einzelnen Nutzer im Aggregationszeitraum, die als Normalisierungswert für die Messwerte crashRate und userPerceivedCrashRate verwendet wurden. Ein Nutzer wird bei diesem Messwert berücksichtigt, wenn er die App während des Aggregationszeitraums aktiv verwendet hat. Eine App gilt als aktiv, wenn sie Aktivitäten anzeigt oder Dienste im Vordergrund ausführt. Achten Sie darauf, diese Anzahl nicht weiter zu aggregieren, da dies dazu führen kann, dass Nutzer mehrfach gezählt werden. Der Wert wird je nach Größe auf das nächste Vielfache von 10, 100, 1.000 oder 1.000.000 gerundet.
filter

string

Auf Daten anzuwendende Filter. Der Filterausdruck entspricht dem AIP-160 und unterstützt das Filtern nach Gleichheit aller Aufschlüsselungsdimensionen.

pageSize

integer

Maximale Größe der zurückgegebenen Daten.

Wenn keine Vorgabe erfolgt, werden maximal 1.000 Zeilen zurückgegeben. Der Maximalwert beträgt 100.000. Werte über 100.000 werden in 100.000 umgewandelt.

pageToken

string

Ein Seitentoken, das von einem vorherigen Aufruf empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren müssen alle anderen für die Anfrage angegebenen Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat.

userCohort

enum (UserCohort)

Nutzeransicht zur Auswahl. Die Ausgabedaten entsprechen der ausgewählten Ansicht.

Unterstützte Werte:

  • OS_PUBLIC Daten aus allen öffentlich veröffentlichten Android-Versionen auswählen Das ist die Standardeinstellung. Unterstützt alle oben genannten Dimensionen.
  • APP_TESTERS Zur Auswahl von Daten von Nutzern, die sich als Tester entschieden haben. Unterstützt alle oben genannten Dimensionen.
  • OS_BETA Nur Daten aus Android-Betaversionen auswählen, Daten aus veröffentlichten Android-Versionen ausschließen. Nur die folgenden Dimensionen werden unterstützt:
  • versionCode (int64): Version der App, die auf dem Gerät des Nutzers ausgeführt wurde.

  • osBuild (string): Betriebssystem-Build des Nutzergeräts, z.B. „T1B2.220916.004“.

Antworttext

Antwortnachricht für crashrate.query.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Felder
rows[]

object (MetricsRow)

Zurückgegebene Datenzeilen.

nextPageToken

string

Fortsetzungs-Token zum Abrufen der nächsten Seite mit Daten.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/playdeveloperreporting

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.