أوقات المستخدم - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS

يصف دليل المطوِّر هذا كيفية قياس توقيتات المستخدم باستخدام الإصدار 3 من حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS.

نظرة عامة

إنّ قياس توقيتات المستخدم يوفّر طريقة أصلية لقياس الفترة الزمنية في "إحصاءات Google". ويمكن أن يكون ذلك مفيدًا لقياس أوقات تحميل الموارد، على سبيل المثال.

تحتوي توقيتات المستخدم على الحقول التالية:

اسم الحقل	حقل أداة التتبُّع	النوع	مطلوبة	الوصف
الفئة	kGAITimingCategory	NSString	نعم	فئة الحدث المحدد زمنيًا
القيمة	kGAITimingValue	NSNumber	نعم	قياس التوقيت بالمللي ثانية
الاسم	kGAITimingVar	NSString	نعم	اسم الحدث المحدد زمنيًا
التصنيف	kGAITimingLabel	NSString	لا	تسمية الحدث المحدد زمنيًا

يمكن الاطّلاع على بيانات توقيت المستخدم بشكل أساسي في تقرير "توقيتات المستخدم لسرعة التطبيقات".

التنفيذ

لإرسال توقيت المستخدم إلى "إحصاءات Google"، أنشئ نتيجة توقيت باستخدام GAIDictionaryBuilder.createTimingWithCategory:interval:name:label:، ثم أرسِله باستخدام send:.

/*
 * Called after a list of high scores finishes loading.
 *
 * @param loadTime The time it takes to load a resource.
 */
- (void)onLoad:(NSTimeInterval)loadTime {

  // May return nil if a tracker has not already been initialized with a
  // property ID.
  id tracker = [[GAI sharedInstance] defaultTracker];

  [tracker send:[[GAIDictionaryBuilder createTimingWithCategory:@"resources"
                                                      interval:@((NSUInteger)(loadTime * 1000))
                                                          name:@"high scores"
                                                         label:nil] build]];
}