Panduan developer ini menjelaskan cara menggunakan Google Analytics SDK v4 untuk Android guna menerapkan dimensi dan metrik kustom.
Ringkasan
Anda dapat:
- Menggunakan antarmuka web Google Analytics untuk mengonfigurasi dimensi atau metrik kustom. Pelajari cara mengonfigurasi dimensi atau metrik kustom (Pusat Bantuan).
- Menetapkan dan mengirim nilai dimensi dan metrik kustom dari aplikasi.
Dimensi dan metrik kustom terdiri dari dua kolom:
Nama Kolom | Jenis | Deskripsi |
---|---|---|
Indeks | Integer |
Indeks dimensi atau metrik kustom. Indeks ini berbasis 1. |
Nilai | String |
Nilai dimensi atau metrik kustom. Dalam kasus metrik, akan diuraikan sebagai bilangan bulat, atau nilai desimal titik tetap, jika metrik dikonfigurasi ke jenis mata uang. |
Menetapkan dan Mengirim Nilai
Untuk menetapkan dan mengirim nilai dimensi kustom:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomDimension(1, "premiumUser") .build() );
Nilai dimensi kustom dapat dikirim bersama jenis hit Google Analytics apa pun, termasuk tampilan layar, peristiwa, transaksi e-commerce, waktu pengguna, dan interaksi sosial. Cakupan dimensi kustom yang telah ditentukan akan menentukan, pada waktu pemrosesan, hit mana yang akan dikaitkan dengan nilai dimensi.
Untuk menetapkan dan mengirim nilai metrik kustom:
// Get tracker. Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker( TrackerName.APP_TRACKER); t.setScreenName("Home Screen"); // Send the custom dimension value with a screen view. // Note that the value only needs to be sent once. t.send(new HitBuilders.ScreenViewBuilder() .setCustomMetric(1, 5) .build() );
Lihat
Konfigurasi Lanjutan untuk detail tentang metode getTracker
.
Pertimbangan Penerapan
Bagian ini menguraikan pertimbangan tambahan yang perlu diingat saat menerapkan dimensi atau metrik kustom.
Pertimbangan untuk Dimensi Kustom
Nilai dengan Cakupan Tingkat Sesi dan Pengguna Berlaku untuk Hit Sebelumnya
- Nilai dimensi kustom dengan cakupan tingkat pengguna atau sesi akan diterapkan ke semua hit di sesi saat ini, termasuk hit sebelumnya. Jika Anda tidak ingin nilai dimensi kustom dengan cakupan tingkat pengguna atau sesi diterapkan ke hit terdahulu dalam sesi saat ini, mulai sesi baru sebelum menerapkan nilai tersebut ke hit.
- Misalnya, jika Anda menggunakan jenis keanggotaan sebagai dimensi kustom tingkat pengguna, dan pengguna mengupgrade keanggotaannya di tengah sesi, sebaiknya Anda memulai sesi baru sebelum menetapkan nilai dimensi kustom baru. Hal ini memastikan hit sebelum upgrade akan dikaitkan dengan nilai keanggotaan lama, sedangkan hit baru akan dikaitkan dengan nilai baru.
Dimensi Kustom dan Filter Tampilan (Profil)
- Nilai dimensi kustom tingkat pengguna atau sesi akan tetap diterapkan ke semua hit pada sesi saat ini dan/atau sesi mendatang meskipun hit yang dikirim bersamanya difilter dari tampilan (profil) .
- Saat memfilter nilai dimensi kustom, hit difilter sesuai dengan cakupan nilai dimensi kustom tersebut. Pelajari lebih lanjut cara filter dan nilai dimensi kustom berinteraksi saat data Anda diproses.
Pertimbangan untuk Metrik Kustom
Nilai Metrik Kustom Digabungkan dalam Laporan
- Nilai metrik kustom digabungkan dalam laporan seperti halnya metrik standar lainnya di Google Analytics. Oleh karena itu, Anda perlu menetapkan nilai metrik kustom
1
untuk meningkatkan total agregat metrik dalam laporan.
Metrik Kustom dan Filter Tampilan (Profil)
- Meskipun nilai metrik kustom umumnya dapat ditetapkan kapan saja, jangan tetapkan nilai metrik kustom pada hit yang kemungkinan akan difilter dari tampilan (profil). Jika hit difilter menurut filter tampilan (profil), semua nilai metrik kustom terkait juga akan difilter. Pelajari dimensi dan metrik kustom serta filter tampilan (profil) lebih lanjut.
Menetapkan Nilai dengan Pengukuran Layar Otomatis
- Untuk menerapkan nilai dimensi kustom ke tampilan layar yang dikirim melalui
pengukuran layar otomatis, tetapkan nilai sebelum
activityStart()
dipanggil selamaonStart()
. Perhatikan bahwa jika nilai tidak diketahui pada saatonStart()
dieksekusi, sebaiknya gunakan pengukuran layar manual.
Jangan mengirim informasi identitas pribadi (PII) sebagai nilai
- Persyaratan Layanan Google Analytics melarang pengiriman informasi identitas pribadi (PII) apa pun ke server Google Analytics. Untuk mengetahui informasi selengkapnya, baca Persyaratan Layanan.