Method: vitals.lmkrate.query

Metrik kümesindeki metrikleri sorgular.

HTTP isteği

POST https://playdeveloperreporting.googleapis.com/v1beta1/{name=apps/*/lmkRateMetricSet}: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}/lmkRateMetricSet

İstek içeriği

İstek metni 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şe dayalı kısıtlamalar nedeniyle varsayılan ve desteklenen tek saat dilimi America/Los_Angeles'dır.
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 uygulama sürümü.
  • deviceModel (string): Kullanıcının cihaz modelinin benzersiz tanımlayıcısı. Tanımlayıcının biçimi "deviceBrand/device" şeklindedir.Burada deviceBrand, Build.BRAND'e, device ise 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 IP adresine göre cihazının bulunduğu ülke veya bölge, 2 harfli ISO-3166 kodu olarak gösterilir (ör. ABD için US).
  • deviceRamBucket (int64): Cihazın MB cinsinden RAM'i (3 GB, 4 GB vb.).
  • 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'sunun 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, LARGE.
  • deviceScreenDpi (string): Cihazın ekran yoğunluğu (ör. mdpi, hdpi).
metrics[]

string

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

Desteklenen metrikler:

  • userPerceivedLmkRate (google.type.Decimal): Toplama döneminde uygulamanızı aktif olarak kullanırken en az bir LMK (kullanıcı tarafından algılanan LMK) yaşayan benzersiz kullanıcıların yüzdesi. Herhangi bir etkinlik görüntüleyen veya ön plan hizmeti yürüten uygulamalar etkin kullanımda kabul edilir.
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal): Son 7 gün içinde userPerceivedLmkRate için hareketli ortalama değeri. Günlük değerler, o günkü farklı kullanıcı sayısına göre ağırlıklandırılır.
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal): Son 28 gün içinde userPerceivedLmkRate'nin hareketli ortalama değeri. Günlük değerler, o günkü farklı kullanıcı sayısına göre ağırlıklandırılır.
  • distinctUsers (google.type.Decimal): Toplama döneminde userPerceivedLmkRate metrikleri için normalleştirme değeri olarak kullanılan farklı kullanıcıların sayısı. Bir kullanıcı, toplama döneminde uygulamayı ön planda kullandıysa bu metriğe dahil edilir. Bu sayının daha fazla toplanmamasına dikkat edilmelidir. Aksi takdirde kullanıcılar birden fazla kez sayılabilir. 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.

Belirtilmemişse en fazla 1.000 satır döndürülür. Maksimum değer 100.000'dir. 100.000'in üzerindeki değerler 100.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 bunu sağlayın.

Sayfalama 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 Yayınlanan Android sürümlerindeki veriler hariç olmak üzere yalnızca Android'in beta sürümlerindeki verileri seçmek için. Yalnızca aşağıdaki boyutlar desteklenir:

  • versionCode (int64): Uygulamanın, kullanıcının cihazında çalışan sürümü.

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

Yanıt gövdesi

lmkrate.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

Verilerin sonraki sayfasını getirmek için devamlılık 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ına bakın.