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

إضافة "إحصاءات 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

الخطوات اللاحقة