Method: vitals.crashrate.query

Metrik grubundaki metrikleri sorgular.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
name

string

Zorunlu. Kaynak adı.

Biçim: apps/{app}/crashRateMetricSet

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
Alanlar
timelineSpec

object (TimelineSpec)

İsteğe bağlıdır. Zaman çizelgesi toplama parametrelerinin belirtilmesi.

Desteklenen toplama dönemleri:

  • DAILY: Metrikler takvim tarihi aralıklarında toplanır. Geçmişten gelen kısıtlamalar nedeniyle varsayılan ve desteklenen tek saat dilimi America/Los_Angeles şeklindedir.
  • HOURLY: Metrikler saatlik aralıklarla toplanır. Varsayılan ve desteklenen tek saat dilimi UTC'dir.
dimensions[]

string

İsteğe bağlıdır. Metriklerin dilimleneceği boyutlar.

Desteklenen boyutlar:

  • apiLevel (string): Kullanıcının cihazında çalışan Android'in API düzeyi (ör. 26).
  • versionCode (int64): Kullanıcının cihazında çalışan uygulamanın sürümü.
  • deviceModel (string): Kullanıcının cihaz modelinin benzersiz tanımlayıcısı. Tanımlayıcı, "cihazMarkası/cihaz" biçimindedir.Burada cihazMarkası, Build.BRAND'e ve cihaz, Build.DEVICE'a karşılık gelir (ör. google/coral).
  • deviceBrand (string): Kullanıcının cihaz markasının benzersiz tanımlayıcısı (ör. google).
  • deviceType (string): Kullanıcının cihazının türü (form faktörü olarak da bilinir), ör. TELEFON.
  • countryCode (string): Kullanıcının cihazının IP adresine göre ülke veya bölgesi.2 harfli ISO-3166 kodu olarak gösterilir (ör. ABD için US).
  • deviceRamBucket (int64): Cihazın MB cinsinden RAM'i, gruplar halinde (ör. 1-1,5 GB için 1024, 4-6 GB için 4096).
  • deviceSocMake (string): Cihazın birincil çip üzerinde sisteminin markası (ör. Samsung). Referans
  • deviceSocModel (string): Cihazın birincil çip üzerinde sisteminin modeli (ör. "Exynos 2100"). Referans
  • deviceCpuMake (string): Cihazın CPU'sunun markası (ör. Qualcomm).
  • deviceCpuModel (string): Cihazın CPU modeli (ör. "Kryo 240").
  • deviceGpuMake (string): Cihazın GPU'sunun markası (ör. ARM).
  • deviceGpuModel (string): Cihazın GPU'sunun modeli (ör. Mali).
  • deviceGpuVersion (string): Cihazın GPU'sunun sürümü (ör. T750).
  • deviceVulkanVersion (string): Cihazın Vulkan sürümü (ör. "4198400").
  • deviceGlEsVersion (string): Cihazın OpenGL ES sürümü (ör. "196610").
  • deviceScreenSize (string): Cihazın ekran boyutu (ör. NORMAL, BÜYÜK).
  • deviceScreenDpi (string): Cihazın ekran yoğunluğu (ör. mdpi, hdpi).
metrics[]

string

İsteğe bağlıdır. Toplanacak metrikler.

Desteklenen metrikler:

  • crashRate (google.type.Decimal): Toplama döneminde en az bir kilitlenme yaşayan farklı kullanıcıların yüzdesi.
  • crashRate7dUserWeighted (google.type.Decimal): Son 7 gün içinde crashRate için hareketli ortalama değeri. Günlük değerler, ilgili günün farklı kullanıcı sayısına göre ağırlıklandırılır.
  • crashRate28dUserWeighted (google.type.Decimal): Son 28 gün içindeki crashRate hareketli ortalama değeri. Günlük değerler, ilgili günün farklı kullanıcı sayısına göre ağırlıklandırılır. SAATLİK ayrıntı düzeyinde desteklenmez.
  • userPerceivedCrashRate (google.type.Decimal): Toplama döneminde uygulamanızı aktif olarak kullanırken en az bir kilitlenme (kullanıcı tarafından algılanan kilitlenme) yaşayan farklı kullanıcıların yüzdesi. Herhangi bir etkinlik gösteren veya ön plan hizmeti yürüten uygulamalar etkin kullanımda kabul edilir.
  • userPerceivedCrashRate7dUserWeighted (google.type.Decimal): Son 7 gün içinde userPerceivedCrashRate için hareketli ortalama değeri. Günlük değerler, ilgili günün farklı kullanıcı sayısına göre ağırlıklandırılır. SAATLİK ayrıntı düzeyinde desteklenmez.
  • userPerceivedCrashRate28dUserWeighted (google.type.Decimal): Son 28 gün içindeki userPerceivedCrashRate hareketli ortalama değeri. Günlük değerler, ilgili günün farklı kullanıcı sayısına göre ağırlıklandırılır. SAATLİK ayrıntı düzeyinde desteklenmez.
  • distinctUsers (google.type.Decimal): Toplama döneminde crashRate ve userPerceivedCrashRate metrikleri için normalleştirme değeri olarak kullanılan farklı kullanıcıların sayısı. Toplama dönemi boyunca uygulamayı etkin bir şekilde kullanan kullanıcılar bu metrikte sayılır. Herhangi bir etkinlik gösteren veya ön plan hizmeti yürüten uygulamalar etkin kullanımda kabul edilir. Kullanıcıların birden çok kez sayılmasına neden olabileceğinden, bu sayının daha fazla birleştirilmemesine dikkat edilmelidir. Değer, büyüklüğüne bağlı olarak en yakın 10, 100, 1.000 veya 1.000.000 katına yuvarlanır.
filter

string

İsteğe bağlıdır. Verilere uygulanacak filtreler. Filtreleme ifadesi, AIP-160 standardına uygundur ve tüm döküm boyutlarının eşitliğine göre filtrelemeyi destekler.

pageSize

integer

İsteğe bağlıdır. Döndürülen verilerin maksimum boyutu.

Belirtilmezse en fazla 1.000 satır döndürülür. Maksimum değer 10.000'dir. 10.000'in üzerindeki değerler 10.000'e zorlanır.

pageToken

string

İsteğe bağlıdır. Önceki bir çağrıdan alınan sayfa jetonu. Sonraki sayfayı almak için bu değeri sağlayın.

Sayfalandırma yapılırken isteğe sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

userCohort

enum (UserCohort)

İsteğe bağlıdır. Seçilecek kullanıcı görünümü. Çıkış verileri, seçilen görünüme karşılık gelir.

Desteklenen değerler:

  • OS_PUBLIC Herkese açık olarak yayınlanan tüm Android sürümlerindeki verileri seçmek için. Bu varsayılan seçenektir. Yukarıdaki tüm boyutları destekler.
  • APP_TESTERS Test kullanıcısı olmayı kabul eden kullanıcıların verilerini seçmek için. Yukarıdaki tüm boyutları destekler.
  • OS_BETA Yalnızca Android'in beta sürümlerinden veri seçmek ve yayınlanan Android sürümlerinden gelen verileri hariç tutmak için kullanılır. Yalnızca aşağıdaki boyutlar desteklenir:
  • versionCode (int64): Kullanıcının cihazında çalışan uygulamanın sürümü.

  • osBuild (string): Kullanıcının cihazının işletim sistemi derlemesi (ör. "T1B2.220916.004").

Yanıt metni

crashrate.query için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
Alanlar
rows[]

object (MetricsRow)

Döndürülen veri satırları.

nextPageToken

string

Sonraki veri sayfasını getirmek için devam jetonu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview sayfasını inceleyin.