نظرة عامة

فئة المستوى الأعلى لنظام التشغيل iOS في "إحصاءات Google"

تتوفر مرافق لإنشاء أجهزة التتبّع ووضع الأعلام السلوكية.

يكتسب NSObject.

طرق المثيل
(id< GAITracker >)	- trackerWithName:trackingId:
	تُنشئ عملية تنفيذ GAITracker أو يستردّها بالاسم المحدّد ورقم تعريف التتبّع. المزيد...

(id< GAITracker >)	- trackerWithTrackingId:
	تعمل على إنشاء أو استرداد عملية تنفيذ GAITracker باسم يساوي رقم تعريف التتبّع المحدّد. المزيد...

(void)	- removeTrackerByName:
	إزالة جهاز تتبُّع من قاموس أجهزة التتبُّع المزيد...

(void)	- dispatch (إرسال)
	يرسل أي معلومات تتبُّع في انتظار المراجعة. المزيد...

(void)	- dispatchWithCompleteHandler:
	تُرسِل إشارة التتبع التالية في قائمة الانتظار، مع استدعاءcompleteHandler عند إرسال إشارة التتبع إما (إرجاع kGAIDispatch Good) أو عند حدوث خطأ (عرض kGAIDispatchError). المزيد...

طرق الفئة
(GAI *)	+ sharedInstance
	احصل على المثيل المشترك لفئة "إحصاءات Google" لنظام التشغيل iOS. المزيد...

المواقع
id< GAITracker >	defaultTracker
	ولتسهيل الأمر، تعرض هذه الفئة مثيلاً تلقائيًا للتتبُّع. المزيد...

id< GAILogger >	logger
	GAILogger المراد استخدامه. المزيد...

قيمة منطقية	optOut
	عندما يكون ذلك صحيحًا، لن يتم جمع أي معلومات تتبع، وبالتالي فإن تتبع مكالمات التتبع سيصبح عمليات غير مفعلة. المزيد...

NSTimeInterval	dispatchInterval
	إذا كانت هذه القيمة موجبة، سيتم إرسال معلومات التتبّع تلقائيًا كل ثوانٍ إرسال. المزيد...

قيمة منطقية	trackUncaughtExceptions
	عند ضبط هذه الحزمة على "صحيح"، ستسجِّل حزمة تطوير البرامج (SDK) معالج الاستثناء غير المرصود حاليًا، ثم تسجِّل معالج استثناء غير مرصود يتتبّع الاستثناءات التي حدثت باستخدام طريقة التتبُّع التلقائية. المزيد...

قيمة منطقية	dryRun
	عندما تكون الإجابة "نعم"، لن يتمّ إرسال أي معلومات تتبُّع. المزيد...

توثيق المنهج

+ (GAI *) SharedInstance

احصل على المثيل المشترك لفئة "إحصاءات Google" لنظام التشغيل iOS.

- (id<GAITracker>) trackerWithName:	(NSString *)	name
رقم تعريف التتبع:	(NSString *)	trackingId

تُنشئ عملية تنفيذ GAITracker أو يستردّها بالاسم المحدّد ورقم تعريف التتبّع.

إذا لم يتم العثور على جهاز التتبُّع الخاص بالاسم المحدَّد، سيتم إنشاؤه وإعادته، وإلا سيتم إرجاع جهاز التتبُّع الحالي. إذا كان جهاز التتبُّع الحالي للاسم ذي الصلة يتضمّن رقم تعريف تتبُّع مختلفًا، لن يتم تغيير رقم تعريف التتبُّع بهذه الطريقة. إذا لم يتم ضبط defaultTracker، سيتم ضبطه على مثيل جهاز التتبُّع المعروض هنا.

المَعلمات

اسم	اسم جهاز التتبُّع هذا يجب ألا يكون `nil` أو فارغًا.
trackingID	رقم تعريف التتبُّع الذي سيتم استخدامه في جهاز التتبُّع هذا. يجب أن يكون بالشكل `UA-xxxxx-y`.

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

وفي حال حدوث خطأ أو كان الاسم غير صالح، ستعرض هذه الطريقة الرمز nil.

- (id<GAITracker>) trackerWithTrackingId: (NSString *) trackingId

تعمل على إنشاء أو استرداد عملية تنفيذ GAITracker باسم يساوي رقم تعريف التتبّع المحدّد.

إذا لم يسبق لك استخدام جهاز التتبُّع للاسم المعني، يتم إنشاؤه وضبط رقم تعريف التتبُّع عليه على |trackingId|، ثم إعادته. وإلا، سيتم عرض جهاز التتبُّع الحالي. إذا كان جهاز التتبُّع الحالي للاسم ذي الصلة يتضمّن رقم تعريف تتبُّع مختلفًا، لن يتم تغيير رقم تعريف التتبُّع بهذه الطريقة. إذا لم يتم ضبط defaultTracker، سيتم ضبطه على مثيل جهاز التتبُّع المعروض هنا.

المَعلمات

trackingID رقم تعريف التتبُّع الذي سيتم استخدامه في جهاز التتبُّع هذا. يجب أن يكون بالشكل UA-xxxxx-y. وسيكون اسم جهاز التتبُّع مطابقًا لاسم جهاز التتبُّع.

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

وفي حال حدوث خطأ أو كان رقم تعريف التتبع غير صالح، ستعرض هذه الطريقة الرمز nil.

- (ملء) removeTrackerByName: (NSString *) name

إزالة جهاز تتبُّع من قاموس أجهزة التتبُّع

إذا كان هو جهاز التتبُّع التلقائي، سيتم محو جهاز التتبُّع التلقائي أيضًا.

المَعلمات

اسم	اسم جهاز التتبُّع

- إرسال (باطل)

يرسل أي معلومات تتبُّع في انتظار المراجعة.

وتجدر الإشارة إلى أن هذا ليس له أي تأثير على dispatchInterval، ويمكن استخدامه مع الإرسال الدوري.

- (إبطال) dispatchWithcompleteHandler: (vit(^)(نتيجة GAIDispatchResult)) completionHandler

تُرسِل إشارة التتبع التالية في قائمة الانتظار، مع استدعاءcompleteHandler عند إرسال إشارة التتبع إما (إرجاع kGAIDispatch Good) أو عند حدوث خطأ (عرض kGAIDispatchError).

إذا لم يكن هناك اتصال بالشبكة أو لم تكن هناك بيانات لإرسالها، يتم عرض kGAIDispatchNoData.

لاحظ أن استدعاء هذه الطريقة باستخدام معالج إكمال بدون أخطاء يؤدي إلى إيقاف الإرسال الدوري. يمكن إعادة تفعيل الإرسال الدوري من خلال ضبط فاصل الإرسال على رقم موجب عند استئناف التطبيق من الخلفية.

إن استدعاء هذه الطريقة بمعالج إكمال صفر يشبه استدعاء الإرسال أعلاه.

يمكن استخدام هذه الطريقة لاسترجاع بيانات الخلفية في نظام التشغيل iOS 7.0 أو الإصدارات الأحدث. سيكون من الحكمة استخدام هذا الرمز عند خروج التطبيق لبدء إرسال أي معلومات تتبُّع لم يتم إرسالها.

المَعلمات

completionHandler الجزء الذي سيتم تشغيله بعد طلب إرسال واحد. تشير معلمة GAIDispatchResult إلى ما إذا كان الإرسال قد نجح أو حدث خطأ أو لم يكن لديه نتائج لإرسالها.

وثائق العقارات

- (id<GAITracker>) defaultTracker

(readwrite, nonatomic, assign)

ولتسهيل الأمر، تعرض هذه الفئة مثيلاً تلقائيًا للتتبُّع.

يتم إعداد هذه السمة على nil وسيتم ضبطها على أداة التتبُّع الأولى التي يتم إنشاء مثيل لها في trackerWithTrackingId: :. يمكن أن يتم تجاوزها على النحو المطلوب.

ستستخدم الفئة GAITrackedViewController مثيل جهاز التتبُّع هذا تلقائيًا.

- مسجّل (id<GAILogger>)

(read write, nonatomic, keep)

GAILogger المراد استخدامه.

- إيقاف (BOOL)

(readwrite, nonatomic, assign)

عندما يكون ذلك صحيحًا، لن يتم جمع أي معلومات تتبع، وبالتالي فإن تتبع مكالمات التتبع سيصبح عمليات غير مفعلة.

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

يتم ضبط هذا الإعداد على NO في المرة الأولى التي يتم فيها استخدام حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" على أحد الأجهزة، ويستمر هذا الإعداد بعد ذلك.

- (NSTimeInterval) dispatchInterval

(readwrite, nonatomic, assign)

إذا كانت هذه القيمة موجبة، سيتم إرسال معلومات التتبّع تلقائيًا كل ثوانٍ إرسال.

بخلاف ذلك، يجب إرسال معلومات التتبّع يدويًا من خلال طلب الإرسال.

ويتم ضبط السياسة تلقائيًا على 120، ما يعني أنّه يجب إرسال معلومات التتبُّع تلقائيًا كل 120 ثانية.

- (BOOL) trackUncaughtExceptions

(readwrite, nonatomic, assign)

عند ضبط هذه الحزمة على "صحيح"، ستسجِّل حزمة تطوير البرامج (SDK) معالج الاستثناء غير المرصود حاليًا، ثم تسجِّل معالج استثناء غير مرصود يتتبّع الاستثناءات التي حدثت باستخدام طريقة التتبُّع التلقائية.

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

- (BOOL) التشغيل الجاف

(readwrite, nonatomic, assign)

عندما تكون الإجابة "نعم"، لن يتمّ إرسال أي معلومات تتبُّع.

يتم ضبط القيمة التلقائية على "لا".

مرجع الصف GAI

نظرة عامة

طرق المثيل

طرق الفئة

المواقع

توثيق المنهج

وثائق العقارات