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

معلومة مهمة: يصف هذا المستند إصدارًا قديمًا من حزمة تطوير البرامج (SDK). على المستخدمين الجدد استخدام أحدث حزمة تطوير برامج (SDK).

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

هل تنقل البيانات من الإصدار 1.x؟ اطّلِع على دليل نقل البيانات للبدء باستخدام الإصدار 2.

المقدمة

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

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

قبل البدء

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

• الإصدار 4.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS أو إصدار أحدث
• الإصدار 2 من "إحصاءات Google" للتطبيقات المتوافقة مع الأجهزة الجوّالة التي تعمل بنظام التشغيل iOS
• تطبيق iOS الذي تريد قياسه باستخدام "إحصاءات Google"
• إصدار جديد من "إحصاءات Google" للموقع الشخصي والتطبيق في الملف الشخصي

البدء

ثمة ثلاث خطوات لبدء استخدام حزمة تطوير البرامج (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

إذا كان تطبيقك يستخدم إطار عمل CoreData: قد يؤدي الردّ على إشعار، مثل NSManagedObjectContextDidSaveNotification، من كائن CoreData "إحصاءات Google"، إلى حدوث استثناء. بدلاً من ذلك، تقترح Apple فلترة إشعارات CoreData عن طريق تحديد سياق الكائن المُدار كمَعلمة للمستمع. مزيد من المعلومات من Apple

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"];

}

ملاحظة: عند الحصول على أداة تتبّع لرقم تعريف تتبّع معيّن، يتم الاحتفاظ بنسخة احتياطية من أداة التتبّع في المكتبة. وعند طلب trackerWithTrackingId: باستخدام رقم تعريف التتبّع نفسه لاحقًا، سيتم عرض مثيل التتبّع نفسه. بالإضافة إلى ذلك، تعرض حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" نسخة افتراضية من أداة التتبُّع يتم ضبطها على أول مثيل أداة تتبُّع يتم إنشاؤه. ويمكن الوصول إليه من خلال:

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

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