معلّمات الإعداد

يقدّم هذا المستند مرجعًا إلى القائمة الكاملة لمعلّمات الضبط المتوفّرة في الإصدار 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.
ga_dispatchPeriod integer معدل تكرار الإرسال التلقائي بالثواني المدة التلقائية هي 30 دقيقة (1800 ثانية).
ga_dryRun boolean إذا كان true، يمكنك تفعيل وضع التشغيل الجاف. في وضع التشغيل الجاف، يتم تنفيذ مسارات الرمز العادية محليًا، ولكن لا يتم إرسال النتائج إلى خوادم "إحصاءات Google". ويُعدّ هذا الإجراء مفيدًا لتصحيح أخطاء المكالمات الواردة إلى حزمة تطوير البرامج (SDK) في "إحصاءات Google"، بدون التعرّض للبيانات المسجّلة. والقيمة التلقائية هي false.
ga_reportUncaughtExceptions boolean إذا كانت true، تسجِّل "إحصاءات Google" تلقائيًا Exception في كل مرة يتم فيها طرح استثناء غير معروف في طلبك. والقيمة التلقائية هي false.
تكرار_ga_sample string معدّل العيّنة الذي يمكن استخدامه، والذي يمكن أن يكون أي قيمة بين 0.0 و100.0. القيمة التلقائية هي 100.0
انتهاء مهلة ga_session integer الوقت (بالثواني) الذي يمكن أن يظل فيه التطبيق في الخلفية قبل انتهاء الجلسة. في حال ضبط القيمة على رقم سالب، لن تبدأ حزمة تطوير البرامج (SDK) في جلسة جديدة مطلقًا. ومع ذلك، لا يزال من الممكن إدارة مهلة الجلسة في واجهة مشرف "إحصاءات Google". راجع معالجة مهلة الجلسة والحملة للحصول على التفاصيل. الإعداد التلقائي هو 30 ثانية.
ga_trackingId string رقم تعريف التتبّع في "إحصاءات Google" الذي تريد إرسال بياناتك إليه. يجب أن تكون الشرطات في رقم التعريف غير مشفّرة. يمكنك إيقاف التتبُّع من خلال عدم تقديم هذه القيمة.