الجلسات - حزمة تطوير البرامج (SDK) لنظام التشغيل Android

ملاحظة مُهمة: يوضِّح هذا المستند إصدارًا قديمًا من حزمة تطوير البرامج (SDK). على المستخدمين الجُدد استخدام أحدث إصدار من حزمة تطوير البرامج (SDK).

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

نظرة عامة

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

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

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

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

لبدء جلسة أو إنهائها يدويًا، اضبط معلَمة التحكّم في الجلسة في "الخريطة" التي تُدخلها في طريقة الإرسال في أداة التتبُّع.

// May return null if a tracker has not yet been initialized.
Tracker tracker = GoogleAnalytics.getInstance(this).getDefaultTracker();

// Start a new session with an AppView hit.
MapBuilder builder = MapBuilder.createAppView();
builder.set(Fields.SESSION_CONTROL, "start");
tracker.set(Fields.SCREEN_NAME, "My Screen");
tracker.send(builder.build());

// There should be no need to end a session explicitly.  However, if you do
// need to indicate end of session with a hit, simply add the following line
// of code to add the parameter to the builder:
builder.set(Fields.SESSION_CONTROL, "end");

إدارة الجلسات تلقائيًا (EasyTracker)

يمكن أن تبدأ EasyTracker جلسات جديدة تلقائيًا لك عندما يوضع المستخدمون تطبيقك في الخلفية لفترة من الوقت. يتم تحديد فترة مهلة الجلسة هذه من خلال المَعلمة ga_sessionTimeout في ملف analytics.xml.

<!-- analytics.xml -->

<!-- Set a session timeout period of 30 seconds -->
<integer name="ga_sessionTimeout">30</integer>