يصف دليل المطوِّر هذا كيفية قياس توقيتات المستخدم باستخدام الإصدار الثالث من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل Android.
نظرة عامة
إنّ قياس توقيتات المستخدم يوفّر طريقة أصلية لقياس الفترة الزمنية في "إحصاءات Google". ويمكن أن يكون ذلك مفيدًا لقياس أوقات تحميل الموارد، على سبيل المثال.
تحتوي توقيتات المستخدم على الحقول التالية:
| اسم الحقل | حقل أداة التتبُّع | النوع | مطلوبة | الوصف |
|---|---|---|---|---|
| الفئة | Fields.TIMING_CATEGORY
|
String
|
نعم | فئة الحدث المحدد زمنيًا |
| القيمة | Fields.TIMING_VALUE
|
long
|
نعم | قياس التوقيت بالمللي ثانية |
| الاسم | Fields.TIMING_VAR
|
String
|
نعم | اسم الحدث المحدد زمنيًا |
| التصنيف | Fields.TIMING_LABEL
|
String
|
لا | تسمية الحدث المحدد زمنيًا |
يمكن الاطّلاع على بيانات توقيت المستخدم بشكل أساسي في تقرير "توقيتات المستخدم لسرعة التطبيقات".
التنفيذ
لإرسال توقيت المستخدم إلى "إحصاءات Google"، أنشئ نتيجة توقيت باستخدام 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()
);
}