الجلسات

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

نظرة عامة

تمثل الجلسة فترة واحدة من تفاعل المستخدم مع تطبيقك. وتعمل الجلسات كحاويات مفيدة للنشاط الذي تم قياسه، بما في ذلك مرات مشاهدة الشاشة والأحداث ومعاملات التجارة الإلكترونية.

إدارة الجلسة

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

إدارة الجلسات اليدوية

يمكنك بدء جلسة جديدة يدويًا عند إرسال نتيجة إلى "إحصاءات Google" باستخدام طريقة setNewSession. يوضّح المثال التالي كيفية بدء جلسة جديدة عند إرسال مشاهدة صفحة في التطبيق:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Set screen name.
t.setScreenName(screenName);

// Start a new session with the hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setNewSession()
    .build());

راجِع الإعداد المتقدّم للحصول على تفاصيل عن طريقة getTracker.

الإدارة التلقائية للجلسة

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

<resources>
  <integer name="ga_sessionTimeout">300</integer>
</resources>

لتعيين مهلة الجلسة آليًا:

t.setSessionTimeout(300L);