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

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

مقدمة

تسهِّل حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" لنظام التشغيل 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".

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

@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"، بما في ذلك قياس الحملات، والدفعات والمعاملات داخل التطبيق، وأحداث تفاعل المستخدم. راجِع أدلة المطوِّرين التالية لمعرفة كيفية إضافة هذه الميزات إلى طريقة التنفيذ:

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