يوضّح هذا الدليل كيفية إضافة "إحصاءات Google" إلى تطبيق iOS لقياس نشاط المستخدم على الشاشات المسماة. إذا لم يكن لديك تطبيق بعد وكنت تريد فقط الاطّلاع على آلية عمل "إحصاءات Google"، يمكنك إلقاء نظرة على نموذج التطبيق.
تستخدم "إحصاءات Google" نظام CocoaPods لتثبيت التبعيات وإدارتها. افتح نافذة طرفية وانتقل إلى موقع مشروع Xcode لتطبيقك. إذا لم تكن قد أنشأت ملف Podfile من قبل لتطبيقك، فأنشئ واحدًا الآن:
pod init
افتح Podfile الذي تم إنشاؤه لتطبيقك وأضف ما يلي:
pod 'GoogleAnalytics'
احفظ الملف وشغِّل:
pod install
يؤدي هذا إلى إنشاء ملف .xcworkspace
لتطبيقك. استخدم هذا الملف لجميع
التطويرات المستقبلية لتطبيقك.
إعداد "إحصاءات Google" لتطبيقك
الآن بعد أن أصبح لديك ملف التهيئة لمشروعك، أصبحت جاهزًا لبدء التنفيذ. أولاً، عليك إعداد عنصر "إحصاءات Google" المشترك داخل
AppDelegate
. يتيح ذلك لتطبيقك إرسال البيانات إلى "إحصاءات Google". يمكنك إجراء ما يلي:
- قم بتضمين العناوين الضرورية.
- يجب إعداد أداة تتبُّع "إحصاءات Google" في
didFinishLaunchingWithOptions
. - استبدِل
YOUR_TRACKING_ID
برقم تعريف التتبّع الخاص بك في "إحصاءات Google"، مثلUA-47605289-8
. - إرسال معلومات الاستثناءات والتسجيل (اختياري).
لإجراء هذه التغييرات، عليك أولاً إضافة "إحصاءات Google" في AppDelegate
:
#import <GoogleAnalytics/GAI.h> #import <GoogleAnalytics/GAIDictionaryBuilder.h>
بعد ذلك، ألغِ طريقة didFinishLaunchingWithOptions
لضبط "إحصاءات Google":
GAI *gai = [GAI sharedInstance]; [gai trackerWithTrackingId:@"YOUR_TRACKING_ID"]; // Optional: automatically report uncaught exceptions. gai.trackUncaughtExceptions = YES; // Optional: set Logger to VERBOSE for debug information. // Remove before app release. gai.logger.logLevel = kGAILogLevelVerbose;
إضافة ميزة "تتبُّع الشاشة"
يمكنك هنا إرسال مشاهدة شاشة مُسماة إلى "إحصاءات Google" كلما فتح المستخدم أو يغير الشاشات في تطبيقك. افتح "وحدة تحكّم طرق العرض" التي تريد تتبُّعها. وإذا كان هذا تطبيقًا جديدًا، افتح وحدة التحكّم التلقائية في الملف الشخصي. يجب أن تقوم التعليمة البرمجية بما يلي:
- أضِف العناوين المطلوبة:
#import <GoogleAnalytics/GAI.h> #import <GoogleAnalytics/GAIDictionaryBuilder.h> #import <GoogleAnalytics/GAIFields.h>
- استخدِم طريقة
viewWillAppear
أو إلغاء الوظيفة لإدراج تتبُّع الشاشة. - أدخل اسمًا للشاشة ونفذ التتبع.
id<GAITracker> tracker = [GAI sharedInstance].defaultTracker; [tracker set:kGAIScreenName value:name]; [tracker send:[[GAIDictionaryBuilder createScreenView] build]];
الخطوات التالية
- اقرأ دليل تنفيذ التطبيقات المتوافقة مع الأجهزة الجوّالة لمعرفة كيفية استخدام "إحصاءات Google" لقياس تفاعلات المستخدمين والإجابة عن الأسئلة المتعلقة باستخدام التطبيق.
- راجِع خيارات الضبط الإضافية مثل أخذ العينات والاختبار وتصحيح الأخطاء وإعدادات الإيقاف وما إلى ذلك.
- إذا كان تطبيقك يتطلب ذلك، فعِّل الميزات الاختيارية مثل التجارة الإلكترونية المحسَّنة ومعرِّف المعلِنين (IDFA) وقياس أداء حملات iAd install.