ระยะเวลาของผู้ใช้ - Android SDK

สำคัญ: เอกสารนี้อธิบาย SDK เวอร์ชันเดิม ผู้ใช้ใหม่ควรใช้ SDK เวอร์ชันล่าสุด

คู่มือนักพัฒนาซอฟต์แวร์นี้จะอธิบายวิธีวัดระยะเวลาของผู้ใช้ด้วย Google Analytics SDK สำหรับ Android v3

ภาพรวม

การวัดระยะเวลาของผู้ใช้เป็นวิธีดั้งเดิมในการวัดระยะเวลาใน Google Analytics ซึ่งอาจมีประโยชน์ในการวัดเวลาที่ใช้ในการโหลดทรัพยากร เป็นต้น

ระยะเวลาของผู้ใช้จะมีช่องต่อไปนี้

ชื่อช่อง	ฟิลด์เครื่องมือติดตาม	ประเภท	จำเป็น	คำอธิบาย
หมวดหมู่	Fields.TIMING_CATEGORY	String	ใช่	หมวดหมู่ของเหตุการณ์ที่มีกำหนดเวลา
ค่า	Fields.TIMING_VALUE	long	ใช่	การวัดเวลาในหน่วยมิลลิวินาที
ชื่อ	Fields.TIMING_VAR	String	ใช่	ชื่อของเหตุการณ์ที่กําหนดเวลาไว้
ค่ายเพลง	Fields.TIMING_LABEL	String	ไม่ได้	ป้ายกำกับของเหตุการณ์ที่มีกำหนดเวลา

ข้อมูลเวลาของผู้ใช้จะอยู่ในรายงานการจับเวลาผู้ใช้ในรายงานความเร็วแอปเป็นหลัก

การใช้งาน

หากต้องการส่งเวลาของผู้ใช้ไปยัง Google Analytics ให้สร้าง Hit ตามเวลาโดยใช้ MapBuilder.createTiming() จากนั้นส่งโดยใช้ send():

/*
 * Called after a list of high scores finishes loading.
 *
 * @param loadTime The time it takes, in milliseconds, to load a resource.
 */
public void onLoad(long loadTime) {

  // May return null if EasyTracker has not been initialized with a property
  // ID.
  Tracker easyTracker = EasyTracker.getInstance(this);

  easyTracker.send(MapBuilder
      .createTiming("resources",    // Timing category (required)
                    loadTime,       // Timing interval in milliseconds (required)
                    "high scores",  // Timing name
                    null)           // Timing label
      .build()
  );
}