Pengiriman - iOS SDK

Dokumen ini menjelaskan cara mengelola pengiriman data ke Google Analytics menggunakan Google Analytics SDK untuk iOS v2.

Ringkasan

Di Google Analytics SDK untuk iOS, data yang dikumpulkan seperti tampilan layar atau peristiwa disimpan secara lokal dalam antrean sebelum dikirim ke server Google Analytics. Proses pengiriman potongan-potongan data ini (disebut di sini sebagai "hit") dari SDK ke Google Analytics dikenal sebagai pengiriman.

Pengiriman bersifat unik untuk library koleksi seluler dan dirancang untuk mengurangi tantangan akses jaringan yang tidak dapat diandalkan dan masa pakai baterai yang terbatas.

Ada dua jenis pengiriman:

  • Pengiriman berkala – otomatis mengirim hit pada interval berulang yang Anda tentukan.
  • Pengiriman manual – mengirim hit secara manual untuk mengirim data pada waktu yang tepat bagi Anda, misalnya saat sudah ada koneksi HTTP.

Bagian selanjutnya dari dokumen ini akan memberikan pembahasan lebih mendalam tentang setiap jenis pengiriman dan cara menerapkannya di aplikasi Anda.

Pengiriman Berkala

Saat aplikasi Anda mengumpulkan data GA, data tersebut ditambahkan ke antrean dan dikirim secara berkala ke Google Analytics. Pengiriman berkala dapat terjadi saat aplikasi berjalan di latar depan atau di latar belakang.

Periode pengiriman default adalah 2 menit. Anda dapat memberikan interval sendiri dalam detik dengan memanggil setDispatchPeriod:(NSTimeInterval) seperti dalam contoh berikut:

[[GAI sharedInstance] setDispatchPeriod:60];

Menetapkan nilai negatif akan menonaktifkan pengiriman berkala, sehingga Anda harus menggunakan pengiriman manual jika ingin mengirim data apa pun ke Google Analytics. Di sisi lain, menetapkan nilai 0 akan segera mengirimkan setiap hit jika koneksi jaringan tersedia.

Setelah semua hit dikirim, pengiriman berkala akan memasuki mode hemat daya dan dinonaktifkan hingga panggilan kirim lainnya dilakukan.

Jika pengguna kehilangan akses jaringan atau keluar dari aplikasi Anda saat masih ada hit yang menunggu dikirim, hit tersebut akan dipertahankan di penyimpanan lokal. Fungsi ini akan dikirim pada saat berikutnya aplikasi Anda berjalan dan pengiriman dipanggil.

Pengiriman Manual

Selain mengandalkan pengiriman berkala, mungkin ada saatnya Anda ingin mengirim hit secara manual. Misalnya, Anda dapat memaketkan pengiriman dengan permintaan HTTP lain yang dibuat oleh aplikasi Anda untuk mengurangi overhead.

Hit dapat dikirim secara manual dengan memanggil dispatch seperti yang terlihat di bawah:

[[GAI sharedTracker] dispatch];