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): ประเภท (หรือที่เรียกว่าฟอร์มแฟกเตอร์) ของอุปกรณ์ของผู้ใช้ เช่น PHONE
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์เป็น MB ในบัคเก็ต (เช่น 1024 สำหรับ 1-1.5 GB, 4096 สำหรับ 4-6 GB)
  • deviceSocMake (string): ผู้ผลิตระบบหลักบนชิปของอุปกรณ์ เช่น Samsung Reference
  • deviceSocModel (string): รุ่นของระบบหลักบนชิปของอุปกรณ์ เช่น "Exynos 2100" Reference
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น Qualcomm
  • deviceCpuModel (string): รุ่น CPU ของอุปกรณ์ เช่น "Kryo 240"
  • deviceGpuMake (string): ผู้ผลิต GPU ของอุปกรณ์ เช่น ARM
  • deviceGpuModel (string): รุ่น GPU ของอุปกรณ์ เช่น Mali
  • deviceGpuVersion (string): เวอร์ชัน GPU ของอุปกรณ์ เช่น T750
  • deviceVulkanVersion (string): เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400"
  • deviceGlEsVersion (string): เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610"
  • deviceScreenSize (string): ขนาดหน้าจอของอุปกรณ์ เช่น NORMAL, LARGE
  • 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