الإعداد المتقدّم - حزمة تطوير البرامج (SDK) لنظام التشغيل iOS

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

نظرة عامة

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

  • GAI: هي وحدة معالجة مفردة تعالج الحالة العامة لعملية التنفيذ، بما في ذلك الحصول على عناصر GAITracker جديدة، بالإضافة إلى إعدادات الإيقاف على مستوى التطبيق وإعدادات الإرسال.
  • GAITracker – الفئة التي ترسل منها البيانات إلى "إحصاءات Google". يمكن إنشاء مثيل لأجهزة تتبُّع متعددة، بمعدل واحدة لكل رقم تعريف موقع فريد.

استخدام أجهزة تتبُّع متعددة

بدءًا من الإصدار 2 من حزمة SDK، يمكنك استخدام أدوات تتبع متعددة في عملية تنفيذ واحدة، واحدة لكل رقم تعريف تتبع فريد. تشترك جميع أجهزة التتبُّع في الولاية العالمية نفسها التي تحتفظ بها بطاقة GAI المفردة.

في المثال التالي، يتم إرسال مشاهدة الشاشة إلى موقعَين منفصلَين باستخدام أداتَي تتبُّع، لكلّ منهما رقم تعريف موقع فريد:

#import "RootViewController.h"
#import "GAI.h"

@interface RootViewController ()

@end

@implementation RootViewController
{
- (void)viewDidLoad {
  [super viewDidLoad];

  // Send a screen view to the first property.
  id tracker1 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Y"];
  [tracker1 sendView:@"/HomeScreen"];

  // Send another screen view to the second property.
  id tracker2 = [[GAI sharedInstance] trackerWithTrackingId:@"UA-XXXX-Z"];
  [tracker2 sendView:@"Home"];
}

@end

تجدر الإشارة إلى أنّ ميزات القياس التلقائي، مثل قياس الشاشة التلقائي وقياس الاستثناءات غير المرصود، ستستخدم أداة تتبُّع واحدة فقط لإرسال البيانات إلى "إحصاءات Google". إذا كنت تستخدم هذه الميزات وتريد إرسال البيانات باستخدام أجهزة تتبع أخرى، عليك إجراء ذلك يدويًا.

يُرجى العلم أنّ قياس الشاشة التلقائي يستخدم أداة التتبُّع المحدّدة في السمة tracker الخاصة بـ GAITrackedViewController. يستخدم قياس الاستثناء غير المتحدي أداة التتبُّع التلقائية المحدَّدة في مثيل GAI.

أداة التتبُّع التلقائية

على الرغم من أنّ عملية التنفيذ قد تستخدم أدوات تتبّع متعدّدة، إلّا أنّها تتضمّن أداة تتبُّع تلقائية واحدة في جميع أنحاء العالم. يصبح أوّل Tracker تم استرداده هو جهاز التتبُّع التلقائي.

للحصول على جهاز التتبُّع التلقائي، استخدِم:

// Get default tracker.
id myDefault = [GAI sharedInstance].defaultTracker;

لضبط جهاز التتبُّع التلقائي، استخدِم:

// Get a new tracker.
id newTracker = [[GAI sharedInstance]trackerWithTrackingId:@"UA-NEW-TRACKING-ID");

// Set the new tracker as the default tracker, globally.
[GAI sharedInstance].defaultTracker = newTracker;

أخذ العينات

يمكنك تفعيل أخذ العينات من جهة العميل للحدّ من عدد النتائج المرسَلة إلى "إحصاءات Google". إذا كان تطبيقك يضم عددًا كبيرًا من المستخدمين أو يرسل كمية كبيرة من البيانات إلى "إحصاءات Google"، سيساعد تفعيل أخذ العينات على ضمان إعداد التقارير بدون انقطاع.

على سبيل المثال، لتنفيذ أخذ العينات من جهة العميل بمعدل 50%، استخدِم الرمز التالي:

// Set a sample rate of 50%.
[tracker setSampleRate:50.0];  // Sample rate is a double.

الإيقاف على مستوى التطبيق

يمكنك تفعيل علامة إيقاف على مستوى التطبيق تؤدي إلى إيقاف "إحصاءات Google" في التطبيق بأكمله. وبعد ضبطها، ستستمر العلامة طوال مدة التطبيق أو حتى تتم إعادة ضبطه.

للحصول على إعداد الإيقاف على مستوى التطبيق، استخدِم:

// Get the app-level opt out preference.
if ([GAI sharedInstance].optOut) {
  ... // Alert the user they have opted out.
}

لضبط علامة الإيقاف على مستوى التطبيق، استخدِم:


// Set the app-level opt out preference.
[[GAI sharedInstance].setOptOut = YES];

الاختبار وتصحيح الأخطاء

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

// Enable debug mode.
[GAI sharedInstance].debug = YES;