مَعلمات الإعداد

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

نظرة عامة

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

المَعلمات

المَعلمة	النوع	الغرض
ga_anonymizeIp	boolean	في حال توجيه true إلى "إحصاءات Google" لإخفاء هوية المعلومات المُرسَلة من عناصر جهاز التتبُّع، وذلك من خلال إزالة آخر ثماني بتات من عنوان IP قبل تخزينها. يُرجى العِلم بأنّ ذلك سيقلل قليلاً من دقة إعداد التقارير الجغرافية. والقيمة التلقائية هي false.
ga_appName	string	اسم تطبيقك المستخدَم في سمة اسم التطبيق في تقاريرك. يمكنك العثور على القيمة التلقائية في الحزمة.
ga_appVersion	string	إصدار تطبيقك المستخدَم في سمة إصدار التطبيق ضمن تقاريرك. يتم ضبط هذه السياسة تلقائيًا على الإصدار المتوفّر في الحزمة.
ga_autoActivityTracking	boolean	إذا كان الفيديو "true"، سيتم تتبُّع المشاهدات (الأنشطة) تلقائيًا. والقيمة التلقائية هي false. تنبيه: راجِع الإعدادات بعناية عند ضبط هذه القيمة على true. في حال كان جهاز تتبُّع آخر يستخدم الإعدادات نفسها مع رقم تعريف تتبُّع متطابق، ستُرسِل كلتا الأداتين نتائج مشاهدة الشاشة، ما يؤدي إلى حدوث زيادة في العدّ.
ga_dispatchPeriod	integer	تكرار الإرسال التلقائي بالثواني. القيمة التلقائية هي 30 دقيقة (1,800 ثانية).
ga_dryRun	boolean	إذا تم true، فعِّل وضع التشغيل التجريبي. في وضع التشغيل التجريبي، يتم تنفيذ مسارات الرموز العادية محليًا، ولكن لا يتم إرسال النتائج إلى خوادم "إحصاءات Google". يفيد ذلك في تصحيح أخطاء الطلبات الواردة إلى حزمة تطوير البرامج (SDK) لخدمة "إحصاءات Google" بدون التأثير سلبًا في البيانات المسجّلة. القيمة التلقائية هي false.
ga_reportUncaughtExceptions	boolean	إذا كانت true، ستسجِّل "إحصاءات Google" تلقائيًا Exception في كل مرة يتم فيها طرح استثناء غير مرصود في تطبيقك. والقيمة التلقائية هي false. ملاحظة: يمكن ضبط هذه القيمة على true فقط في جهاز تتبُّع واحد. وفي حال تحديدها لعدة أجهزة تتبُّع، سيتم استخدام آخر جهاز تتبُّع تم إعداده.
ga_sampleFrequency	string	معدل العينة المراد استخدامه، والذي يمكن أن يكون أي قيمة بين 0.0 و100.0. القيمة التلقائية هي 100.0.
ga_sessionTimeout	integer	الوقت (بالثواني) الذي يمكن أن يظل فيه تطبيقك في الخلفية قبل انتهاء الجلسة. وعند ضبط ذلك على رقم سالب، لن تبدأ حزمة SDK في بدء جلسة جديدة أبدًا. مع ذلك، لا يزال من الممكن إدارة مهلة الجلسة في واجهة مشرف "إحصاءات Google". اطّلِع على معالجة مهلة الجلسة والحملة للحصول على التفاصيل. المدة التلقائية هي 30 ثانية.
ga_trackingId	string	رقم تعريف التتبّع في "إحصاءات Google" المطلوب إرسال البيانات إليه. ويجب أن تكون الشرطات في المعرّف غير مرمّزة. يمكنك إيقاف التتبّع من خلال عدم إدخال هذه القيمة.