Dimensi & Metrik Kustom - Android SDK v2 (Lama)

Panduan developer ini menjelaskan cara menerapkan dimensi dan metrik kustom menggunakan Google Analytics SDK untuk Android v2.

Ringkasan

Saat Anda menetapkan nilai dimensi atau metrik kustom menggunakan Google Analytics SDK untuk Android, nilai tersebut akan dikirim sebagai parameter dengan hit berikutnya yang dikirim. Nilai tersebut dapat diterapkan ke jenis hit Google Analytics apa pun, termasuk tampilan layar, peristiwa, transaksi e-commerce, waktu pengguna, dan interaksi sosial.

Ada dua langkah utama untuk menerapkan dimensi atau metrik kustom:

  1. Tentukan dimensi atau metrik kustom menggunakan antarmuka web Google Analytics.
    Tetapkan indeks, nama, dan cakupan dimensi atau metrik kustom di bagian setelan properti pada antarmuka web.
    Pelajari cara menentukan dimensi atau metrik kustom.
  2. Terapkan kode untuk menetapkan dan mengumpulkan nilai dimensi dan metrik kustom.
    Tambahkan kode ke aplikasi Anda untuk menetapkan nilai dimensi atau metrik kustom untuk hit Google Analytics pada indeks yang Anda tentukan di langkah sebelumnya.

Bagian selanjutnya dari artikel ini akan menjelaskan cara menerapkan kode untuk menetapkan dan mengirim nilai dimensi atau metrik kustom ke Google Analytics.

Dimensi Kustom

Nilai dimensi kustom dapat ditetapkan pada semua jenis hit Google Analytics. Tetapkan nilai dimensi kustom tepat sebelum panggilan kirim tempat Anda ingin menerapkan nilai.

Cakupan dimensi kustom yang telah ditentukan akan menentukan pada waktu pemrosesan hit tambahan mana yang mungkin dikaitkan dengan nilai tersebut.

Kolom berikut diperlukan untuk menetapkan nilai dimensi kustom:

  • Integer Indeks – indeks definisi dimensi kustom. Indeks ini berbasis 1.
  • String Nilai – nilai dimensi kustom.

Menetapkan Nilai Dimensi Kustom

Untuk menetapkan nilai dimensi kustom, panggil setCustomDimension sebelum melakukan panggilan kirim yang ingin Anda kaitkan dengan nilai:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Pertimbangan Penerapan

Bagian ini menguraikan pertimbangan tambahan yang perlu diingat saat menerapkan dimensi kustom.

Cakupan Tingkat Sesi dan Pengguna Bersifat Greedy

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 sebelumnya di sesi saat ini, mulai sesi baru sebelum menerapkan nilai tersebut ke hit.

Misalnya, jika menggunakan jenis keanggotaan sebagai dimensi kustom tingkat pengguna, dan pengguna mengupgrade keanggotaannya di tengah sesi, Anda dapat memulai sesi baru sebelum menetapkan nilai dimensi kustom baru. Hal ini memastikan bahwa 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 dengannya 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.

Menetapkan Nilai dengan Pengukuran Layar Otomatis

Untuk menerapkan nilai dimensi kustom ke tampilan layar yang dikirim melalui pengukuran layar otomatis EasyTracker, tetapkan nilai sebelum activityStart() dipanggil selama onStart().

Perhatikan bahwa jika nilai tidak diketahui pada saat onStart() dieksekusi, sebaiknya gunakan pengukuran layar manual.

Jangan mengirim informasi identitas pribadi (PII) sebagai nilai

Persyaratan Layanan Google Analytics melarang pengiriman informasi identitas pribadi (PII) ke server Google Analytics. Untuk mengetahui informasi selengkapnya, baca Persyaratan Layanan.

Custom Metrics

Meskipun dimensi kustom harus diterapkan dengan cermat ke hit tertentu dan dikelola dengan cakupan, hit yang dengannya metrik kustom diterapkan umumnya tidak akan memengaruhi pelaporan, sehingga dapat ditetapkan setiap kali nilai metrik diketahui.

Kolom berikut diperlukan untuk menetapkan nilai metrik kustom:

  • Integer Indeks – indeks definisi metrik kustom.
  • Integer Nilai – nilai metrik kustom. Nilainya mungkin negatif.

Menetapkan Nilai Metrik Kustom

Untuk menetapkan nilai metrik kustom, panggil setCustomMetric sebelum panggilan kirim lainnya:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Atau, untuk menetapkan metrik kustom mata uang:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Pertimbangan Penerapan

Bagian berikut menguraikan pertimbangan tambahan yang perlu diingat saat merencanakan penerapan dimensi atau 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 khusus umumnya dapat ditetapkan kapan saja, hindari menetapkan nilai metrik khusus pada klik yang kemungkinan akan difilter dari tampilan (profil). Jika hit difilter menurut filter tampilan (profil), nilai metrik kustom terkait juga akan difilter. Pelajari dimensi dan metrik kustom serta filter tampilan (profil) lebih lanjut.