Ringkasan
kelas tingkat teratas iOS Google Analytics.
Menyediakan fasilitas untuk membuat pelacak dan menetapkan tanda perilaku.
Mewarisi NSObject.
Metode Instance | |
(id< GAITracker >) | - trackerWithName:trackingId: |
Membuat atau mengambil implementasi GAITracker dengan nama dan ID pelacakan yang ditentukan. Lainnya... | |
(id< GAITracker >) | - trackerWithTrackingId: |
Membuat atau mengambil implementasi GAITracker dengan nama yang sama dengan ID pelacakan yang ditentukan. Lainnya... | |
(void) | - removeTrackerByName: |
Hapus pelacak dari kamus pelacak. Lainnya... | |
(void) | - pengiriman |
Mengirim informasi pelacakan yang tertunda. Lainnya... | |
(void) | - dispatchWithCompletionHandler: |
Mengirim beacon pelacakan berikutnya dalam antrean, memanggil completionHandler saat beacon pelacakan telah dikirim (menampilkan kGAIDispatchGood) atau terjadi error (menampilkan kGAIDispatchError). Lainnya... | |
Metode Kelas | |
(GAI *) | + sharedInstance |
Dapatkan instance bersama dari kelas Google Analytics untuk iOS. Lainnya... | |
Properti | |
id< GAITracker > | defaultTracker |
Untuk memudahkan, class ini mengekspos instance pelacak default. Lainnya... | |
id< GAILogger > | logger |
GAILogger yang akan digunakan. Lainnya... | |
BOOL | optOut |
Jika hal ini benar, tidak ada informasi pelacakan yang akan dikumpulkan; panggilan pelacakan akan menjadi tidak beroperasi secara efektif. Lainnya... | |
NSTimeInterval | dispatchInterval |
Jika nilai ini positif, informasi pelacakan akan otomatis dikirim setiap detik dispatchInterval. Lainnya... | |
BOOL | trackUncaughtExceptions |
Jika disetel ke benar (true), SDK akan mencatat pengendali pengecualian yang tidak tertangkap yang saat ini terdaftar, lalu mendaftarkan pengendali pengecualian yang tidak tertangkap yang melacak pengecualian yang terjadi menggunakan defaultTracker. Lainnya... | |
BOOL | dryRun |
Jika ini adalah 'YA', tidak ada informasi pelacakan yang akan dikirim. Lainnya... | |
Dokumentasi Metode
+ (GAI *) sharedInstance |
Dapatkan instance bersama dari kelas Google Analytics untuk iOS.
- (id<GAITracker>) trackerWithName: | (NSString *) | name | |
trackingId: | (NSString *) | trackingId | |
Membuat atau mengambil implementasi GAITracker dengan nama dan ID pelacakan yang ditentukan.
Jika pelacak untuk nama yang ditentukan belum ada, pelacak akan dibuat dan ditampilkan; jika tidak, pelacak yang ada akan ditampilkan. Jika pelacak yang ada untuk masing-masing nama memiliki ID pelacakan yang berbeda, ID pelacakan tersebut tidak diubah oleh metode ini. Jika defaultTracker tidak ditetapkan, parameter akan ditetapkan ke instance pelacak yang ditampilkan di sini.
- Parameter
-
name Nama pelacak ini. Tidak boleh nil
atau kosong.trackingID ID pelacakan yang akan digunakan untuk pelacak ini. Formatnya harus UA-xxxxx-y
.
- Hasil
- GAITracker yang terkait dengan nama yang ditentukan. Pelacak dapat digunakan untuk mengirim data pelacakan ke Google Analytics. Saat pertama kali metode ini dipanggil dengan nama tertentu, pelacak untuk nama tersebut akan ditampilkan, dan panggilan berikutnya dengan nama yang sama akan menampilkan instance yang sama. Anda tidak perlu menyimpan pelacak karena pelacak akan disimpan secara internal oleh library.
Jika terjadi error atau nama tidak valid, metode ini akan menampilkan nil
.
- (id<GAITracker>) trackerWithTrackingId: | (NSString *) | trackingId |
Membuat atau mengambil implementasi GAITracker dengan nama yang sama dengan ID pelacakan yang ditentukan.
Jika pelacak untuk masing-masing nama belum ada, pelacak telah dibuat, ID pelacakannya ditetapkan ke |trackingId|, dan ditampilkan; jika tidak, pelacak yang ada akan ditampilkan. Jika pelacak yang ada untuk masing-masing nama memiliki ID pelacakan yang berbeda, ID pelacakan tersebut tidak diubah oleh metode ini. Jika defaultTracker tidak disetel, pelacak akan ditetapkan ke instance pelacak yang ditampilkan di sini.
- Parameter
-
trackingID ID pelacakan yang akan digunakan untuk pelacak ini. Formatnya harus UA-xxxxx-y
. Nama pelacak akan sama dengan trackingID.
- Hasil
- GAITracker yang terkait dengan trackingID yang ditentukan. Pelacak dapat digunakan untuk mengirim data pelacakan ke Google Analytics. Saat pertama kali metode ini dipanggil dengan trackingID tertentu, pelacak untuk nama masing-masing akan ditampilkan, dan panggilan berikutnya dengan trackingID yang sama akan menampilkan instance yang sama. Anda tidak perlu menyimpan pelacak karena pelacak akan disimpan secara internal oleh library.
Jika terjadi error atau trackingId tidak valid, metode ini akan menampilkan nil
.
- (void) removeTrackerByName: | (NSString *) | name |
Hapus pelacak dari kamus pelacak.
Jika ini adalah pelacak default, hapus juga pelacak default.
- Parameter
-
name Nama pelacak.
- (void) pengiriman |
Mengirim informasi pelacakan yang tertunda.
Perhatikan bahwa ini tidak berpengaruh pada dispatchInterval, dan dapat digunakan bersama dengan pengiriman berkala.
- (void) dispatchWithCompletionHandler: | (void(^)(hasil GAIDispatchResult)) | completionHandler |
Mengirim beacon pelacakan berikutnya dalam antrean, memanggil completionHandler saat beacon pelacakan telah dikirim (menampilkan kGAIDispatchGood) atau terjadi error (menampilkan kGAIDispatchError).
Jika tidak ada koneksi jaringan atau tidak ada data untuk dikirim, kGAIDispatchNoData akan ditampilkan.
Perhatikan bahwa memanggil metode ini dengan penyelesaian handler non-nil akan menonaktifkan pengiriman berkala. Pengiriman berkala dapat diaktifkan kembali dengan menyetel dispatchInterval ke angka positif saat aplikasi dilanjutkan dari latar belakang.
Memanggil metode ini dengan nil completionHandler sama dengan memanggil pengiriman di atas.
Metode ini dapat digunakan untuk pengambilan data latar belakang di iOS 7.0 atau yang lebih baru. Sebaiknya panggil metode ini saat aplikasi keluar untuk memulai pengiriman informasi pelacakan yang belum dikirim.
- Parameter
-
completionHandler Blok yang akan dijalankan setelah satu permintaan pengiriman. Parameter GAIDispatchResult menunjukkan apakah pengiriman berhasil, mengalami error, atau tidak memiliki hit untuk dikirim.
Dokumentasi Properti
|
(baca tulis, nonatomik, tetapkan) |
Untuk memudahkan, class ini mengekspos instance pelacak default.
Ini diinisialisasi ke nil
dan akan ditetapkan ke pelacak pertama yang dibuat instance-nya di trackerWithTrackingId:. Kolom ini dapat diganti sesuai keinginan.
Class GAITrackedViewController akan menggunakan instance pelacak ini secara default.
|
(baca tulis, nonatomik, tetapkan) |
Jika hal ini benar, tidak ada informasi pelacakan yang akan dikumpulkan; panggilan pelacakan akan menjadi tidak beroperasi secara efektif.
Jika disetel ke benar (true), semua informasi yang menunggu upload akan dihapus. Nilai tanda ini akan dipertahankan secara otomatis oleh SDK. Developer dapat secara opsional menggunakan tanda ini untuk menerapkan setelan ketidakikutsertaan dalam aplikasi agar pengguna dapat memilih tidak ikut pelacakan Google Analytics.
Atribut ini ditetapkan ke NO
saat pertama kali Google Analytics SDK digunakan di perangkat, dan dipertahankan setelahnya.
|
(baca tulis, nonatomik, tetapkan) |
Jika nilai ini positif, informasi pelacakan akan otomatis dikirim setiap detik dispatchInterval.
Jika tidak, informasi pelacakan harus dikirim secara manual dengan memanggil petugas operator.
Secara default, atribut ini ditetapkan ke 120
, yang menunjukkan informasi pelacakan harus dikirim secara otomatis setiap 120 detik.
|
(baca tulis, nonatomik, tetapkan) |
Jika disetel ke benar (true), SDK akan mencatat pengendali pengecualian yang tidak tertangkap yang saat ini terdaftar, lalu mendaftarkan pengendali pengecualian yang tidak tertangkap yang melacak pengecualian yang terjadi menggunakan defaultTracker.
Jika defaultTracker bukan nil
, fungsi ini akan melacak pengecualian pada pelacak dan mencoba mengirim informasi pelacakan yang belum diproses selama 5 detik. Kemudian, pengendali pengecualian yang terdaftar sebelumnya akan dipanggil, jika ada. Jika disetel kembali ke salah (false), pengendali pengecualian yang tidak tertangkap sebelumnya akan dipulihkan.
|
(baca tulis, nonatomik, tetapkan) |
Jika ini adalah 'YA', tidak ada informasi pelacakan yang akan dikirim.
Nilai defaultnya adalah 'TIDAK'.