حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل iOS - الإصدار 2 (الإصدار القديم) - نظرة عامة

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

مقدمة

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

  • عدد المستخدمين النشطين الذين يستخدمون تطبيقاتهم.
  • من أي مكان في العالم يتم استخدام التطبيق.
  • اعتماد واستخدام ميزات محددة.
  • عمليات الشراء والمعاملات داخل التطبيق
  • عدد أعطال التطبيق ونوعها.
  • مقاييس مفيدة أخرى

قبل البدء

قبل بدء تنفيذ حزمة تطوير البرامج (SDK)، تأكّد من توفُّر ما يلي:

البدء

هناك ثلاث خطوات لبدء استخدام حزمة تطوير البرامج (SDK):

  1. إضافة العناوين والمكتبات إلى مشروعك
  2. إعداد جهاز التتبُّع
  3. إضافة ميزة قياس أداء الشاشة

بعد إكمال هذه الخطوات، يمكنك قياس ما يلي باستخدام "إحصاءات Google":

  • عمليات تثبيت التطبيقات
  • المستخدمون النشطون والخصائص الديمغرافية
  • الشاشات وتفاعل المستخدم
  • الأعطال والاستثناءات

1- إضافة ملفات العناوين وتهيئة مشروعك

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

  • GAI.h
  • GAITracker.h
  • GAITrackedViewController.h
  • GAITransaction.h
  • GAITransactionItem.h
  • libGoogleAnalytics.a

تستخدم حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" إطارَي العمل CoreData وSystemConfiguration، لذا عليك إضافة المعلومات التالية إلى المكتبات المرتبطة لاستهداف التطبيقات:

  • libGoogleAnalytics.a
  • CoreData.framework
  • SystemConfiguration.framework

2. إعداد جهاز التتبُّع

لإعداد أداة التتبُّع، عليك استيراد العنوان GAI.h في ملف التفويض .m في تطبيقك وإضافة هذا الرمز إلى طريقة application:didFinishLaunchingWithOptions: الخاصة بمفوّض التطبيق:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Optional: automatically send uncaught exceptions to Google Analytics.
  [GAI sharedInstance].trackUncaughtExceptions = YES;
  // Optional: set Google Analytics dispatch interval to e.g. 20 seconds.
  [GAI sharedInstance].dispatchInterval = 20;
  // Optional: set debug to YES for extra debugging information.
  [GAI sharedInstance].debug = YES;
  // Create tracker instance.
  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithTrackingId:@"UA-YOUR-TRACKING-ID"];

}
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

تجدر الإشارة إلى أنّه في المثال أعلاه، يمثّل "UA-YOUR-tracking-ID" هنا عنصرًا نائبًا لرقم تعريف التتبّع الذي تمّ تعيينه لك عند إنشاء ملفك الشخصي للتطبيق في "إحصاءات Google". إذا كنت تستخدم رقم تعريف تتبُّع واحدًا فقط في تطبيقك، من الأفضل استخدام طريقة التتبُّع التلقائية.

3. تنفيذ قياس الشاشة

لقياس مرات المشاهدة في تطبيقك تلقائيًا، اطلب من وحدات التحكم في الملفات الشخصية تمديد GAITrackedViewController، وهي فئة بسيطة تمتد إلى UIViewController، وتقديم اسم الملف الشخصي لمنحه لكل وحدة تحكم في الملفات الشخصية في تقاريرك. وكلما يتم تحميل طريقة العرض هذه، سيتم إرسال مشاهدة شاشة إلى Google Analytics.

على سبيل المثال، لنفترض أن لديك طريقة عرض "حول" تريد قياسها باستخدام عنوان وحدة التحكم في الملف الشخصي الذي يبدو على النحو التالي:

@interface AboutViewController : UIViewController

يمكنك تحديث هذا العنوان ليقول:

#import "GAITrackedViewController.h"

@interface AboutViewController : GAITrackedViewController

يجب أيضًا تقديم اسم الملف الشخصي المطلوب استخدامه في تقارير "إحصاءات Google". ومن الأفضل إضافة هذه القيمة إلى طريقة مبدئ وحدة التحكم في العرض، إذا توفرت لديك، أو طريقة viewDidAppear::

- (void)viewDidAppear:(BOOL)animated {
  [super viewDidAppear:animated];
  self.trackedViewName = @"About Screen";
}
}

طالما تم ضبط trackedViewName قبل طلب sendView:، سيتم إجراء قياس تلقائي للشاشة. كلما ظهر العرض، سيتم إنشاء مكالمة إلى sendView: باسم الملف الشخصي المقدّم.

للتعرّف على مزيد من المعلومات عن قياس الشاشة، اطّلع على دليل مطوّري برامج الشاشات.

تهانينا! تم إعداد تطبيقك الآن لإرسال البيانات إلى "إحصاءات Google".

الخطوات التالية

يمكنك إنجاز المزيد باستخدام Google Analytics، بما في ذلك قياس الحملات، والدفعات والمعاملات داخل التطبيقات، وأحداث تفاعل المستخدمين. يُرجى الاطّلاع على أدلة المطوّرين التالية للتعرّف على كيفية إضافة هذه الميزات إلى التنفيذ:

  • الضبط المتقدّم: تعرَّف على المزيد من المعلومات عن خيارات الضبط المتقدّمة، بما في ذلك استخدام أجهزة تتبُّع متعدّدة.
  • قياس الحملات – تعرَّف على كيفية تنفيذ قياس أداء الحملات لمعرفة القنوات والحملات التي تزيد من عمليات تثبيت التطبيق.
  • قياس الأحداث: تعرَّف على كيفية قياس تفاعل المستخدم مع المحتوى التفاعلي مثل الأزرار والفيديوهات والوسائط الأخرى باستخدام الأحداث.
  • قياس الدفعات ضمن التطبيق – تعرَّف على كيفية قياس الدفعات والمعاملات داخل التطبيق.
  • توقيتات المستخدم: تعرَّف على كيفية قياس توقيتات المستخدمين في تطبيقك لقياس أوقات التحميل والتفاعل مع الوسائط والمزيد.