Method: vitals.lmkrate.query

ค้นหาเมตริกในชุดเมตริก

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
name

string

ต้องระบุ ชื่อทรัพยากร

รูปแบบ: apps/{app}/lmkRateMetricSet

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "timelineSpec": {
    object (TimelineSpec)
  },
  "dimensions": [
    string
  ],
  "metrics": [
    string
  ],
  "filter": string,
  "pageSize": integer,
  "pageToken": string,
  "userCohort": enum (UserCohort)
}
ช่อง
timelineSpec

object (TimelineSpec)

ไม่บังคับ การระบุพารามิเตอร์การรวบรวมไทม์ไลน์

ระยะเวลาการรวบรวมที่รองรับ

  • DAILY: จะได้รับการรวบรวมในช่วงวันที่ในปฏิทิน เนื่องจากข้อจำกัดในอดีต เขตเวลาเริ่มต้นและเขตเวลาเดียวที่รองรับคือ America/Los_Angeles
dimensions[]

string

ไม่บังคับ มิติข้อมูลที่จะใช้แบ่งเมตริก

มิติข้อมูลที่รองรับ

  • apiLevel (string): ระดับ API ของ Android ที่ทำงานในอุปกรณ์ของผู้ใช้ เช่น 26.
  • versionCode (int64): เวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้
  • deviceModel (string): ตัวระบุที่ไม่ซ้ำกันของรุ่นอุปกรณ์ของผู้ใช้ รูปแบบของตัวระบุคือ "deviceBrand/device" โดยที่ deviceBrand สอดคล้องกับ Build.BRAND และ device สอดคล้องกับ Build.DEVICE เช่น google/coral
  • deviceBrand (string): ตัวระบุที่ไม่ซ้ำกันของแบรนด์อุปกรณ์ของผู้ใช้ เช่น google
  • deviceType (string): ประเภท (หรือที่เรียกว่ารูปแบบของอุปกรณ์) ของอุปกรณ์ของผู้ใช้ เช่น โทรศัพท์
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์เป็น MB ในกลุ่ม (3 GB, 4 GB ฯลฯ)
  • deviceSocMake (string): แบรนด์ของระบบบนชิปหลักของอุปกรณ์ เช่น Samsung ข้อมูลอ้างอิง
  • deviceSocModel (string): รุ่นของระบบบนชิปหลักของอุปกรณ์ เช่น "Exynos 2100" ข้อมูลอ้างอิง
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น Qualcomm
  • deviceCpuModel (string): รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ยี่ห้อ GPU ของอุปกรณ์ เช่น ARM
  • deviceGpuModel (string): รุ่นของ GPU ของอุปกรณ์ เช่น มาลี
  • deviceGpuVersion (string): เวอร์ชันของ GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ใหญ่
  • deviceScreenDpi (string): ความหนาแน่นของหน้าจอของอุปกรณ์ เช่น mdpi, hdpi
metrics[]

string

ไม่บังคับ เมตริกที่จะรวม

เมตริกที่รองรับ

  • userPerceivedLmkRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในช่วงการรวบรวมข้อมูลที่พบ LMK อย่างน้อย 1 ครั้งขณะที่ใช้งานแอปของคุณอยู่ (LMK ที่ผู้ใช้รับรู้) ระบบจะถือว่าแอปมีการใช้งานอยู่หากแอปแสดงกิจกรรมหรือเรียกใช้บริการที่ทำงานอยู่เบื้องหน้า
  • userPerceivedLmkRate7dUserWeighted (google.type.Decimal): มูลค่าเฉลี่ยต่อเนื่องของ userPerceivedLmkRate ในช่วง 7 วันที่ผ่านมา ระบบจะถ่วงน้ำหนักค่ารายวันตามจำนวนผู้ใช้ที่ไม่ซ้ำกันในวันนั้น
  • userPerceivedLmkRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยต่อเนื่องของ userPerceivedLmkRate ในช่วง 28 วันที่ผ่านมา ระบบจะถ่วงน้ำหนักค่ารายวันตามจำนวนผู้ใช้ที่ไม่ซ้ำกันในวันนั้น
  • distinctUsers (google.type.Decimal): จำนวนผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวบรวมที่ใช้เป็นค่าการปรับให้เป็นค่ามาตรฐานสำหรับเมตริก userPerceivedLmkRate ระบบจะนับผู้ใช้ในเมตริกนี้หากผู้ใช้ใช้แอปในเบื้องหน้าในระหว่างระยะเวลาการรวบรวมข้อมูล โปรดระมัดระวังไม่ให้รวมจำนวนนี้เพิ่มเติม เนื่องจากอาจส่งผลให้ระบบนับผู้ใช้หลายครั้ง ระบบจะปัดเศษค่าให้เป็นค่าทวีคูณที่ใกล้เคียงที่สุดของ 10, 100, 1,000 หรือ 1,000,000 โดยขึ้นอยู่กับขนาดของค่า
filter

string

ไม่บังคับ ตัวกรองที่จะใช้กับข้อมูล นิพจน์การกรองเป็นไปตามมาตรฐาน AIP-160 และรองรับการกรองตามความเท่ากันของมิติข้อมูลแบบแยกรายละเอียดทั้งหมด
pageSize

integer

ไม่บังคับ ขนาดสูงสุดของข้อมูลที่แสดง

หากไม่ระบุ ระบบจะแสดงผลแถวอย่างมาก 1, 000 แถว ค่าสูงสุดคือ 100,000 และค่าที่สูงกว่า 100,000 จะถูกบังคับให้เป็น 100,000
pageToken

string

ไม่บังคับ โทเค็นหน้าเว็บที่ได้รับจากการเรียกก่อนหน้า ระบุข้อมูลนี้เพื่อดึงข้อมูลหน้าถัดไป

เมื่อแบ่งหน้า พารามิเตอร์อื่นๆ ทั้งหมดที่ระบุในคำขอต้องตรงกับการเรียกที่ระบุโทเค็นหน้าเว็บ
userCohort

enum (UserCohort)

ไม่บังคับ มุมมองผู้ใช้เพื่อเลือก ข้อมูลเอาต์พุตจะสอดคล้องกับมุมมองที่เลือก

ค่าที่รองรับ:

  • OS_PUBLIC หากต้องการเลือกข้อมูลจาก Android เวอร์ชันที่เผยแพร่ต่อสาธารณะทั้งหมด โดยตัวเลือกนี้คือค่าเริ่มต้น รองรับมิติข้อมูลทั้งหมดข้างต้น
  • APP_TESTERS หากต้องการเลือกข้อมูลจากผู้ใช้ที่เลือกเข้าร่วมเป็นผู้ทดสอบ รองรับมิติข้อมูลทั้งหมดข้างต้น
  • OS_BETA หากต้องการเลือกข้อมูลจาก Android เวอร์ชันเบต้าเท่านั้น โดยไม่รวมข้อมูลจาก Android เวอร์ชันที่เผยแพร่แล้ว รองรับเฉพาะมิติข้อมูลต่อไปนี้

  • versionCode (int64): เวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้

  • osBuild (string): เวอร์ชันของระบบปฏิบัติการของอุปกรณ์ผู้ใช้ เช่น "T1B2.220916.004"

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ lmkrate.query

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "rows": [
    {
      object (MetricsRow)
    }
  ],
  "nextPageToken": string
}
ช่อง
rows[]

object (MetricsRow)

แถวข้อมูลที่แสดงผล
nextPageToken

string

โทเค็นการต่อเนื่องเพื่อดึงข้อมูลหน้าถัดไป

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

ดูข้อมูลเพิ่มเติมได้ที่OAuth 2.0 Overview