REST Resource: vitals.stuckbackgroundwakelockrate

ทรัพยากร: StuckBackgroundWakelockRateMetricSet

ทรัพยากร Singleton ที่นําเสนอชุดของเมตริก Wake Lock ในพื้นหลังที่ค้างอยู่

ชุดเมตริกนี้มีข้อมูลช่วง Wake Lock ของ PowerManager รวมกับข้อมูลสถานะกระบวนการเพื่อสร้างเมตริกมาตรฐานที่ไม่ขึ้นกับจํานวนผู้ใช้

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

  • DAILY: ระบบจะรวบรวมเมตริกในช่วงวันที่ตามปฏิทิน เนื่องจากข้อจํากัดที่ผ่านมา เขตเวลาที่รองรับมีเพียง America/Los_Angeles เท่านั้น

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

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

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

  • apiLevel (string): ระดับ API ของ Android ที่ทํางานอยู่ในอุปกรณ์ของผู้ใช้ เช่น 26.
  • versionCode (int64): เวอร์ชันของแอปที่ใช้งานในอุปกรณ์ของผู้ใช้
  • deviceModel (string): ตัวระบุที่ไม่ซ้ําของรุ่นอุปกรณ์ของผู้ใช้ รูปแบบของตัวระบุคือ "deviceBrand/device" โดยที่ deviceBrand สอดคล้องกับ Build.BRAND และอุปกรณ์สอดคล้องกับ Build.DEVICE เช่น google/coral
  • deviceBrand (string): ตัวระบุที่ไม่ซ้ําสําหรับแบรนด์อุปกรณ์ของผู้ใช้ เช่น Google
  • deviceType (string): ประเภท (หรือที่เรียกว่ารูปแบบของอุปกรณ์) สําหรับอุปกรณ์ของผู้ใช้ เช่น โทรศัพท์
  • countryCode (string): ประเทศหรือภูมิภาคของอุปกรณ์ของผู้ใช้ตามที่อยู่ IP ซึ่งแสดงเป็นรหัส ISO-3166 แบบ 2 ตัวอักษร (เช่น สหรัฐอเมริกาสําหรับสหรัฐอเมริกา)
  • deviceRamBucket (int64): RAM ของอุปกรณ์ในหน่วย MB ในที่เก็บข้อมูล (3GB, 4GB ฯลฯ)
  • deviceSocMake (string): ทําอุปกรณ์หลักบนชิป เช่น Samsung ข้อมูลอ้างอิง
  • deviceSocModel (string): รุ่นของชิประบบหลักในอุปกรณ์ เช่น "Exynos 2100" ข้อมูลอ้างอิง
  • deviceCpuMake (string): ผู้ผลิต CPU ของอุปกรณ์ เช่น คุณภาพ
  • 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

สิทธิ์ที่จําเป็น: ในการเข้าถึงทรัพยากรนี้ ผู้ใช้ที่โทรต้องมีสิทธิ์ดูข้อมูลแอป (อ่านอย่างเดียว) สําหรับแอป

การแสดง JSON 
{
  "name": string,
  "freshnessInfo": {
    object (FreshnessInfo)
  }
}
ช่อง
name

string

ชื่อทรัพยากร

รูปแบบ: apps/{app}/stuckBackgroundWakelockRateMetricSet
freshnessInfo

object (FreshnessInfo)

สรุปเกี่ยวกับความใหม่ของข้อมูลในทรัพยากรนี้

วิธีการ

get

 อธิบายคุณสมบัติของชุดเมตริก

query

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