Kode Pelacakan: Konfigurasi Dasar

Referensi ini menjelaskan metode yang Anda gunakan untuk menyesuaikan semua aspek pelaporan Google Analytics.

Metode Dasar ga.js

Detail Metode

{i>_deleteCustomVar<i}()

_deleteCustomVar(index)

Metode ini menghapus variabel yang ditetapkan ke indeks yang disediakan, jika ada. Misalnya, Anda dapat menetapkan variabel kustom tingkat pengunjung, lalu memutuskan bahwa Anda tidak ingin lagi menggunakan variabel tingkat pengunjung ini.

Cuplikan Asinkron (direkomendasikan)

_gaq.push(['_deleteCustomVar', 1]);

parameter

Int   index Indeks variabel kustom yang akan dihapus.

_getName()

_getName()

Menampilkan nama yang diberikan pelacak saat dibuat.

Cuplikan Asinkron (direkomendasikan)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

akan menampilkan

String Nama pelacak.

_getAccount()

_getAccount()

Menampilkan ID Google Analytics untuk objek pelacak ini. Jika melacak halaman di situs dalam beberapa akun, Anda dapat menggunakan metode ini untuk menentukan akun yang terkait dengan objek pelacak tertentu.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

akan menampilkan

String ID Akun yang digunakan untuk membuat instance objek pelacak ini.

_getVersion()

_getVersion()

Menampilkan nomor versi GATC.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

akan menampilkan

String nomor versi GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Menampilkan nilai variabel kustom tingkat pengunjung yang ditetapkan untuk indeks tertentu.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

parameter

Int   index Indeks variabel kustom tingkat pengunjung.

akan menampilkan

String Nilai variabel kustom tingkat pengunjung. Menampilkan tidak terdefinisi jika tidak dapat mengambil variabel untuk indeks yang ditentukan.

_initData()

_initData()Tidak digunakan lagi. initData() sekarang dieksekusi secara otomatis di kode pelacakan ga.js.

Melakukan inisialisasi atau menginisialisasi ulang objek GATC (Google Analytics Tracker Code).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

Digunakan secara eksklusif dalam pelacakan asinkron. Menetapkan ID properti web untuk objek pelacakan.

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

parameter

String accountID ID properti web lengkap (misalnya, UA-65432-1) untuk objek pelacak.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan _setVisitorCookieTimeout(cookieTimeoutMillis).

Menetapkan masa berlaku cookie pengunjung Google Analytics dalam milidetik. Secara default, cookie pengunjung ditetapkan masa berlakunya berakhir dalam 2 tahun. Jika ingin, Anda dapat mengubah tanggal habis masa berlaku cookie pengunjung menggunakan metode ini. Misalnya, untuk menetapkan masa berlaku cookie pengunjung ke 7 hari, Anda harus menggunakan kode berikut:

pageTracker._setCookiePersistence(604800000);

parameter

Number   milliseconds Waktu habis masa berlaku cookie pengunjung baru.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Menetapkan variabel kustom dengan nama, nilai, dan cakupan yang diberikan untuk variabel tersebut. Ada batas karakter 128 byte untuk gabungan name dan value.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

akan menampilkan

Boolean Metode ini menampilkan true jika variabel kustom berhasil ditetapkan, dan false jika belum (misalnya jika panjang string nama/nilai Anda melebihi 128 byte, atau jika Anda menggunakan slot yang salah).

parameter

Int      index       Wajib. Slot yang digunakan untuk variabel kustom. Nilai yang memungkinkan adalah 1-5, inklusif.

String   name        Wajib. Nama untuk variabel kustom.

String   value       Wajib. Nilai untuk variabel kustom.

Int      opt_scope   Opsional. Cakupan yang digunakan untuk variabel kustom. Nilai yang mungkin adalah 1 untuk tingkat pengunjung, 2 untuk tingkat sesi, dan 3 untuk tingkat halaman.

{i>_setSampleRate()<i}.

_setSampleRate(newRate)

Menetapkan frekuensi sampel baru. Jika situs Anda sangat besar dan mengalami lonjakan traffic yang tinggi, menetapkan frekuensi sampel akan memastikan pelacakan laporan tidak terganggu. Pengambilan sampel di Google Analytics terjadi secara konsisten pada seluruh pengunjung unik, sehingga terdapat integritas dalam tren dan pelaporan meskipun pengambilan sampel diaktifkan, karena pengunjung unik tetap disertakan atau dikecualikan dari sampel, sebagaimana ditetapkan dari awal pengambilan sampel.

Anda hanya perlu menentukan metode ini pada saat yang sama ketika _setAccount() dipanggil, biasanya sekali per halaman atau aplikasi (di mana pun Anda melakukan inisialisasi kode pelacakan itu sendiri). Perhatikan bahwa nilai frekuensi sampel yang Anda tentukan tetap berlaku selama objek pelacakan itu sendiri tetap ada.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setSampleRate', '2.5']);

parameter

String newRate Frekuensi sampel baru untuk ditetapkan. Berikan {i>string<i} numerik antara 0 dan 100 (tepat dengan dua angka desimal).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan _setSessionCookieTimeout(cookieTimeoutMillis).

Menetapkan waktu tunggu sesi baru dalam detik. Secara default, waktu tunggu sesi ditetapkan ke 30 menit (1800 detik). Waktu tunggu sesi digunakan untuk menghitung kunjungan (lihat Cara sesi ditentukan di Analytics). Jika ingin mengubah definisi "sesi" untuk kebutuhan khusus, Anda dapat meneruskan jumlah detik untuk menentukan nilai baru. Hal ini akan memengaruhi laporan Kunjungan di setiap bagian tempat jumlah kunjungan dihitung, dan tempat kunjungan digunakan dalam menghitung nilai lainnya. Misalnya, jumlah kunjungan umumnya akan meningkat jika Anda mempersingkat waktu tunggu sesi, dan umumnya akan menurun jika Anda menambah waktu tunggu sesi.

parameter

String newTimeout Waktu tunggu sesi baru ditetapkan dalam detik.

{i>_setSessionCookieTimeout()<i}

_setSessionCookieTimeout(cookieTimeoutMillis)

Menetapkan waktu tunggu cookie sesi baru dalam milidetik. Secara default, waktu tunggu sesi ditetapkan ke 30 menit. Waktu tunggu sesi digunakan untuk menghitung kunjungan, karena kunjungan berakhir setelah 30 menit tidak ada aktivitas browser atau setelah browser keluar. Jika Anda ingin mengubah definisi "sesi" untuk kebutuhan khusus Anda, Anda dapat meneruskan jumlah milidetik untuk menentukan nilai baru. Hal ini akan memengaruhi laporan Kunjungan di setiap bagian tempat jumlah kunjungan dihitung dan tempat kunjungan digunakan dalam menghitung nilai lainnya. Misalnya, jumlah kunjungan akan meningkat jika Anda mempersingkat waktu tunggu sesi, dan akan berkurang jika Anda menambah waktu tunggu sesi. Anda dapat mengubah waktu tunggu habis masa berlaku ke 0 untuk menunjukkan bahwa cookie ini harus dihapus saat browser ditutup.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setSessionCookieTimeout', 1800000]);


parameter

Number cookieTimeoutMillis Waktu tunggu sesi baru dalam milidetik atau 0 untuk menghapus cookie saat browser ditutup.

{i>_setSiteSpeedSampleRate()<i}.

_setSiteSpeedSampleRate(sampleRate)

Menentukan ukuran kumpulan sampel baru untuk pengumpulan data Kecepatan Situs. Secara default, pengambilan sampel tetap sebesar 1% dari pengunjung situs membentuk kumpulan data tempat metrik Kecepatan Situs berasal. Jika situs Anda memiliki jumlah pengunjung harian yang relatif sedikit, misalnya 100.000 atau kurang, sebaiknya sesuaikan pengambilan sampel dengan rasio yang lebih besar. Hal ini akan memberikan peningkatan perincian untuk waktu muat halaman dan metrik Kecepatan Situs lainnya. (Lihat Kecepatan Situs di Pusat Bantuan untuk mengetahui detail tentang laporan Kecepatan Situs.)

Metode _setSiteSpeedSampleRate() harus dipanggil sebelum _trackPageview() agar efektif.

Analytics membatasi hit pengumpulan Kecepatan Situs untuk satu properti hingga lebih dari 1% pengguna atau 10 ribu hit per hari guna memastikan distribusi resource sistem yang setara untuk fitur ini.

Catatan: Kami sangat menyarankan situs yang memiliki lebih dari 1 juta hit per hari agar pemilihan sampel mereka tetap disetel ke rasio default 1%. Menyesuaikan ukuran sampel ke jumlah yang lebih besar tidak akan meningkatkan ukuran sampel Anda.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

parameter

Number sampleRate Nilai antara 0 - 100 untuk menentukan persentase pengunjung situs Anda yang akan diukur untuk tujuan Kecepatan Situs. Misalnya, nilai 5 menetapkan contoh pengumpulan Kecepatan Situs ke 5%.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Menetapkan masa berlaku cookie pengunjung Google Analytics dalam milidetik. Secara default, cookie pengunjung ditetapkan masa berlakunya akan berakhir dalam 2 tahun. Jika ingin, Anda dapat mengubah tanggal habis masa berlaku cookie pengunjung menggunakan metode ini. Anda dapat mengubah waktu tunggu habis masa berlaku menjadi 0 untuk menunjukkan bahwa cookie ini harus dihapus saat browser ditutup.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

parameter

Number cookieTimeoutMillis Waktu habis masa berlaku cookie pengunjung baru dalam milidetik atau 0 untuk menghapus cookie saat browser ditutup.

_setVar().

_setVar(newVal)

Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan _setCustomVar().

Menetapkan atau menentukan segmen pengunjung kustom dengan string yang disediakan. Anda dapat menggunakan nilai ini untuk memberikan segmentasi tambahan pada pengguna ke situs Anda. Misalnya, Anda dapat memiliki halaman login atau formulir yang memicu nilai berdasarkan input pengunjung, seperti preferensi yang dipilih pengunjung, atau opsi privasi. Variabel ini kemudian diperbarui dalam cookie untuk pengunjung tersebut. Ketika diterapkan pada situs Anda dan data dikumpulkan melalui metode ini, segmen yang baru ditentukan akan muncul di laporan Buatan Pengguna di bagian Pengunjung pada Laporan Analytics. Selain itu, Anda dapat mengakses segmen Nilai Buatan Pengguna di laporan Detail Konten untuk melihat persentase pengunjung halaman yang termasuk dalam segmen tertentu yang Anda tetapkan.

parameter

String newVal Nilai buatan pengguna baru yang akan ditetapkan.

_trackPageLoadTime()

_trackPageLoadTime()

Metode ini tidak digunakan lagi karena pelaporan Kecepatan Situs diaktifkan secara otomatis untuk semua pengguna. Harap gunakan _setSiteSpeedSampleRate() untuk menyesuaikan frekuensi sampling untuk pelaporan Kecepatan Situs.

Mengaktifkan laporan Kecepatan Situs untuk halaman ini. Masukkan metode ini untuk setiap halaman di situs yang Anda inginkan untuk pelaporan Kecepatan Situs. Untuk informasi selengkapnya tentang laporan Kecepatan Situs di Analytics, lihat artikel Kecepatan Situs di Pusat Bantuan kami.

Memverifikasi Perubahan Anda

Jika Anda melihat data muncul dalam laporan, berarti penyiapan Anda sudah benar. Jika tidak ada data setelah 24 jam, periksa penyesuaian Anda untuk memastikan tidak ada error. Lihat Memecahkan Masalah Kode Pelacakan untuk daftar error kode pelacakan umum. Panduan pemecahan masalah ini juga berisi Langkah-Langkah Proses Debug Dasar dan informasi selengkapnya tentang proses debug.

Perhatikan bahwa mengaktifkan pelacakan Kecepatan Situs pada situs mengakibatkan permintaan bertambah pada server Google Analytics, terpisah dari permintaan GIF pelacakan laman yang dibuat untuk tayangan laman. Untuk meminimalkan dampak pada keseluruhan latensi situs, permintaan ini hanya dikirim pada contoh tayangan laman di situs. Untuk alasan ini, Anda mungkin tidak selalu melihat permintaan GIF kecepatan situs saat mencoba melakukan debug pada fitur ini di Firebug atau alat lain. Kondisi ini normal dan sesuai perkiraan.

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

_trackPageview()

_trackPageview(opt_pagePath)

Logika utama untuk GATC (Kode Pelacak Analisis Google). Jika diaktifkan, fungsi penaut akan mencoba mengekstrak nilai cookie dari URL. Jika tidak, parser akan mencoba mengekstrak nilai cookie dari document.cookie. Langkah ini juga memperbarui atau membuat cookie sesuai kebutuhan, lalu menulisnya kembali ke objek dokumen. Mengumpulkan semua metrik yang sesuai untuk dikirim ke UCFE (Urchin Collector Front-end).

Cuplikan Asinkron (direkomendasikan) 

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

parameter

String opt_pagePath Parameter opsional untuk menunjukkan jalur halaman yang metriknya akan dilacak. Saat menggunakan opsi ini, gunakan garis miring (/) di awal untuk menunjukkan jalur halaman.