الضبط المتقدّم - iOS SDK

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

نظرة عامة

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