Google Play Developer Reporting API ช่วยให้คุณเข้าถึงเมตริก รายงาน และข้อมูลไทม์ไลน์เกี่ยวกับแอปได้ ชุดเมตริกจะกำหนดมาตรฐานการเข้าถึงเมตริกเพื่อให้การใช้ API ง่ายที่สุด ชุดเมตริกคือการจัดกลุ่มเชิงตรรกะของเมตริกที่เกี่ยวข้องซึ่งมีแอตทริบิวต์ร่วมกัน (เช่น ความใหม่และความละเอียด) และสามารถค้นหาพร้อมกันได้ ชุดเมตริกยังมีมิติข้อมูลจํานวนหนึ่งที่คุณใช้กรองหรือสร้างรายละเอียดได้ด้วย เว้นแต่จะระบุไว้เป็นอย่างอื่น คุณสามารถแบ่งหรือกรองเมตริกทั้งหมดตามมิติข้อมูลที่มีอยู่ทั้งหมดได้
ความใหม่
แหล่งข้อมูลชุดเมตริกแต่ละรายการมีGETวิธีมาตรฐานในการดึงข้อมูล
วันที่และเวลาของจุดข้อมูลล่าสุดที่พร้อมใช้งาน ซึ่งเรียกว่าความใหม่ เนื่องจากชุดเมตริกสามารถรองรับความละเอียดหลายระดับ (รายวัน รายชั่วโมง) การดำเนินการจึงแสดงค่าความใหม่ 1 ค่าต่อความละเอียดที่รองรับ
คุณใช้ค่าความใหม่เป็นปลายทางในช่วงเวลาการค้นหาได้โดยตรง
การค้นหาข้อมูล
หากต้องการเข้าถึงข้อมูลในชุดเมตริก คุณควรใช้QUERYวิธีการที่กำหนดเองเพื่อออกคำค้นหา
แต่ละคำค้นหาต้องระบุรายละเอียดและช่วงเวลา คุณควรระบุมิติข้อมูลที่ควรใช้ในการแบ่งการรวบรวมพร้อมกับเมตริกที่ต้องการเข้าถึง
คุณควรระมัดระวังเมื่อขอไทม์ไลน์เพื่อขอช่วงวันที่ เพื่อให้ขนาดของช่วงเวลาแปรผกผันกับขนาดของแอปและจำนวนการแบ่งย่อย ตัวอย่างเช่น แอปขนาดใหญ่ควรเลือกจำนวนวันให้น้อยลงในคำขอการค้นหาเดียว เพื่อหลีกเลี่ยงการหมดเวลาการค้นหาที่เกิดจากการอ่านข้อมูลมากเกินไป
ชุดเมตริกที่ใช้ได้
ดัชนีด้านล่างแสดงรายการปลายทางทั้งหมดและข้อมูลที่เกี่ยวข้องที่คุณขอได้
| ชุดเมตริก | คำอธิบาย | เมตริกที่รองรับ |
|---|---|---|
vitals.anrrate |
มีข้อมูล ANR ที่รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจำนวนผู้ใช้ |
anrRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวบรวม
ที่พบ ANR อย่างน้อย 1 ครั้ง anrRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก anrRate ในช่วง 7 วันจนถึงวันที่ระบุ anrRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก anrRate ในช่วง 28 วันจนถึงวันที่ระบุ userPerceivedAnrRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวม ที่พบ ANR ที่ผู้ใช้รับรู้อย่างน้อย 1 ครั้ง ปัจจุบันระบบจะนับเฉพาะ ANR ของ "การนำส่งอินพุต" userPerceivedAnrRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedAnrRate ในช่วง 7 วันจนถึงวันที่ระบุ userPerceivedAnrRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedAnrRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.crashrate |
มีข้อมูลการขัดข้องที่รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นอยู่กับจํานวนผู้ใช้ |
crashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในระยะเวลาการรวม
ที่พบการขัดข้องอย่างน้อย 1 ครั้ง crashRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักตามผู้ใช้ของเมตริก crashRate ในช่วง 7 วันจนถึงวันที่ระบุ crashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักตามผู้ใช้ของเมตริก crashRate ในช่วง 28 วันจนถึงวันที่ที่ระบุ userPerceivedCrashRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันในการรวบรวม ระยะเวลาที่พบข้อขัดข้องอย่างน้อย 1 ครั้งขณะที่แอปมีการใช้งานอยู่ userPerceivedCrashRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 7 วันจนถึงวันที่ระบุ userPerceivedCrashRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของเมตริก userPerceivedCrashRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.lmkrate
|
มีข้อมูล LMK (การหยุดทำงานเนื่องจากหน่วยความจำไม่เพียงพอ) ที่รวมกับข้อมูลการใช้งานเพื่อสร้างเมตริกมาตรฐาน โดยไม่ขึ้นอยู่กับจำนวนผู้ใช้ |
userPerceivedLmkRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน
ระยะเวลาการรวบรวมข้อมูลซึ่งพบ LMK (การหยุดทำงานเนื่องจากหน่วยความจำไม่เพียงพอ) อย่างน้อย 1 ครั้งขณะที่
ใช้งานแอปของคุณอยู่ ระบบจะถือว่าแอปมีการใช้งานอยู่หากแสดงกิจกรรมใดๆ
หรือเรียกใช้บริการที่ทำงานอยู่เบื้องหน้า userPerceivedLmkRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของ เมตริก userPerceivedLmkRate ในช่วง 7 วันจนถึงวันที่ระบุ userPerceivedLmkRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักตามผู้ใช้ ของเมตริก userPerceivedLmkRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.excessivewakeuprate |
มีข้อมูลจำนวนการปลุก AlarmManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกที่ได้มาตรฐานซึ่งไม่ขึ้นอยู่กับจำนวนผู้ใช้ |
excessiveWakeupRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน
ระยะเวลาการรวบรวมข้อมูลที่มีการปลุกระบบมากกว่า 10 ครั้งต่อชั่วโมง
excessiveWakeupRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักตามผู้ใช้ของ
เมตริก excessiveWakeupRate ในช่วง 7 วันจนถึงวันที่ระบุ excessiveWakeupRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักของผู้ใช้ของ เมตริก excessiveWakeupRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จํานวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.stuckbackgroundwakelockrate |
มีข้อมูลระยะเวลา WakeLock ของ PowerManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกที่ได้มาตรฐานซึ่งไม่ขึ้นอยู่กับจํานวนผู้ใช้ |
stuckBgWakelockRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน
ระยะเวลาการรวบรวมข้อมูลที่มี Wakelock ค้างไว้ในเบื้องหลังนานกว่า 1 ชั่วโมง
stuckBgWakelockRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ำหนักตามผู้ใช้
ของเมตริก stuckBgWakelockRate ในช่วง 7 วันจนถึงวันที่ระบุ stuckBgWakelockRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ำหนักตามผู้ใช้ ของเมตริก stuckBgWakelockRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.slowstartuprate |
มีข้อมูลการเริ่มต้นแอปช้าซึ่งแบ่งตามประเภทการเริ่มต้นแอป (เย็น อุ่น ร้อน) |
slowStartRate (google.type.Decimal): เปอร์เซ็นต์ของผู้ใช้ที่ไม่ซ้ำกันใน
ระยะเวลาการรวบรวมข้อมูลที่มีเหตุการณ์เริ่มต้นช้า
slowStartRate7dUserWeighted (google.type.Decimal): ค่าเฉลี่ยแบบถ่วงน้ำหนักตามผู้ใช้
ของเมตริก slowStartRate ในช่วง 7 วันจนถึงวันที่ระบุ slowStartRate28dUserWeighted (google.type.Decimal): ค่าเฉลี่ยที่ถ่วงน้ำหนักตามผู้ใช้ ของเมตริก slowStartRate ในช่วง 28 วันจนถึงวันที่ระบุ distinctUsers (google.type.Decimal): จำนวนผู้ใช้โดยประมาณที่มีข้อมูล ในช่วงการรวบรวม |
vitals.errors.counts |
มีจำนวนรายงานข้อผิดพลาดที่ไม่ได้ทำให้เป็นมาตรฐาน |
โปรดทราบ: ขณะนี้ทรัพยากรนี้ใช้ได้เฉพาะใน API เวอร์ชัน v1 อัลฟ่า errorReportCount (google.type.Decimal): จำนวนรายงานข้อผิดพลาดแต่ละรายการที่ได้รับสำหรับแอป |
ขนาด
ชุดเมตริกแต่ละชุดรองรับชุดมิติข้อมูลที่แตกต่างกันสำหรับการกรองและการแบ่งกลุ่ม ดูดัชนีมิติข้อมูลด้านล่างเพื่อดูรายการมิติข้อมูลที่ใช้ได้ใน API
| มิติข้อมูล | คำอธิบาย |
|---|---|
versionCode |
รหัสเวอร์ชันของแอปที่ทำงานในอุปกรณ์ของผู้ใช้ในขณะที่บันทึกข้อมูล ค่าสตริงของมิติข้อมูลนี้สามารถแยกวิเคราะห์เป็นจำนวนเต็มได้ ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีการกำหนดเวอร์ชันแอปใน Android ได้ที่นี่ |
countryCode |
ตัวระบุประเทศหรือภูมิภาคของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น US สำหรับสหรัฐอเมริกา) |
มิติข้อมูลอุปกรณ์
มิติข้อมูลเหล่านี้เป็นมิติข้อมูลเฉพาะของอุปกรณ์ รวมถึงลักษณะซอฟต์แวร์และฮาร์ดแวร์ของอุปกรณ์
| มิติข้อมูล | คำอธิบาย |
|---|---|
apiLevel |
ระดับ API ของ Android ที่ทำงานในอุปกรณ์ของผู้ใช้ ณ เวลาที่บันทึกข้อมูล ค่าสตริงของมิติข้อมูลนี้สามารถแยกวิเคราะห์เป็นจำนวนเต็มได้ ดูรายการรุ่น Android และวิธีจับคู่กับระดับ API ได้ที่นี่ |
deviceModel |
ตัวระบุของรุ่นอุปกรณ์หนึ่งๆ ตามที่กำหนดไว้ในแคตตาล็อกอุปกรณ์ของ Play Console |
deviceType |
ตัวระบุรูปแบบของอุปกรณ์หนึ่งๆ ตามที่แคตตาล็อกอุปกรณ์ของ Play Console ใช้ |
deviceRamBucket |
RAM ของอุปกรณ์เป็น MB ในกลุ่ม (3 GB, 4 GB ฯลฯ) |
deviceSocMake |
ผู้ผลิตระบบหลักบนชิปของอุปกรณ์ เช่น Samsung ดูที่นี่ |
deviceSocModel |
ชื่อรุ่นของระบบบนชิปหลักของอุปกรณ์ เช่น "Exynos 2100" ดูที่นี่ |
deviceCpuMake |
แบรนด์ของ CPU ของอุปกรณ์ เช่น Qualcomm |
deviceCpuModel |
รุ่นของ CPU ของอุปกรณ์ เช่น "Kryo 240" |
deviceGpuMake |
รุ่น GPU ของอุปกรณ์ เช่น ARM |
deviceGpuModel |
รุ่นของ GPU ของอุปกรณ์ เช่น มาลี |
deviceGpuVersion |
เวอร์ชันของ GPU ของอุปกรณ์ เช่น T750 |
deviceVulkanVersion |
เวอร์ชัน Vulkan ของอุปกรณ์ เช่น "4198400" |
deviceGlEsVersion |
เวอร์ชัน OpenGL ES ของอุปกรณ์ เช่น "196610" |
deviceScreenSize |
ขนาดหน้าจอของอุปกรณ์ เช่น ปกติ ใหญ่ |
deviceScreenDpi |
ความหนาแน่นของหน้าจออุปกรณ์ เช่น mdpi, hdpi |