Sesi - Android SDK v2 (Lama)

Dokumen ini memberikan ringkasan tingkat tinggi tentang sesi di Google Mobile App Analytics dan Google Analytics SDK untuk Android v2 serta menjelaskan berbagai metode yang tersedia untuk mengelola sesi di aplikasi Anda.

Ringkasan

Sesi mewakili satu periode interaksi pengguna dengan aplikasi Anda. Sesi berfungsi sebagai penampung aktivitas terukur yang berguna, yang mencakup tampilan layar, peristiwa, dan transaksi e-commerce.

Secara default, Google Analytics akan mengelompokkan hit yang diterima dalam waktu 30 menit satu sama lain ke dalam sesi yang sama. Namun, banyak developer mungkin ingin menerapkan lapisan pengelolaan sesi tambahan yang mempertimbangkan status aplikasi mereka, seperti saat aplikasi berada di latar belakang dan durasinya.

Bagian lain dari dokumen ini akan menjelaskan metode yang tersedia untuk menerapkan logika tersebut. Opsi Anda bervariasi, mulai dari pengelolaan sesi yang sepenuhnya otomatis, yang disediakan oleh EasyTracker, hingga membuat logika pengelolaan sesi Anda sendiri secara manual, atau menggunakan kombinasi keduanya.

Mengelola Sesi

Bagian berikut akan menjelaskan metode yang tersedia bagi Anda untuk mengelola sesi di aplikasi.

Pengelolaan sesi otomatis menggunakan EasyTracker

EasyTracker menyediakan pengelolaan sesi otomatis yang dapat menangani pekerjaan memulai sesi baru untuk Anda. Berikut adalah ringkasan cara kerja pengelolaan sesi otomatis:

Penerapan default memiliki periode waktu tunggu sesi 30 detik. Anda dapat mengubah periode waktu tunggu dengan mengubah parameter ga_sessionTimeout di file analytics.xml:
```
  <-- Set session time out to 60 seconds -- >
  <integer name="ga_sessionTimeout">60</integer>
```
Jika aplikasi tetap berada di latar belakang selama lebih dari periode waktu tunggu sesi, EasyTracker akan menandai perlunya sesi baru dan hit berikutnya akan menjadi bagian dari sesi baru.

Pengelolaan sesi manual

Meskipun Anda menggunakan pengelolaan sesi otomatis EasyTracker, sebaiknya memulai sesi baru secara manual pada peristiwa penting dalam siklus proses aplikasi.

Misalnya, Anda mungkin ingin memulai sesi baru secara manual setiap kali pengguna berhasil login ke aplikasi Anda. Karena niat pengguna dalam menggunakan aplikasi mungkin telah berubah, atau mungkin alternatif pengguna yang berbeda, memulai sesi baru saat login akan membantu menjaga data penggunaan tetap terpisah dan lebih mudah dipahami dalam laporan Anda.

Untuk memulai sesi baru, panggil setStartSession(true) . Tindakan ini akan menambahkan parameter ke hit terkirim berikutnya yang menunjukkan bahwa sesi harus dimulai.

Pada contoh di bawah, kami asumsikan bahwa onSignIn() dipanggil setiap kali pengguna berhasil login ke aplikasi Anda:

// Called after a user successfully signs in to your app.
private void onSignIn() {
  ... // The rest of your onSignIn() code.
  myTracker.setStartSession(true); // Where myTracker is an instance of Tracker.
  myTracker.sendEvent("app_flow", "sign_in", "", null); // First activity of new session.
}