إضافة "إحصاءات Google" إلى تطبيقك على iOS

يوضّح هذا الدليل كيفية إضافة "إحصاءات 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>
    ViewController.m
  • استخدِم طريقة viewWillAppear أو إلغاء الوظيفة لإدراج تتبُّع الشاشة.
  • أدخل اسمًا للشاشة ونفذ التتبع.
id<GAITracker> tracker = [GAI sharedInstance].defaultTracker;
[tracker set:kGAIScreenName value:name];
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];
ViewController.m

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