Cookie dan identifikasi pengguna dengan gtag.js

gtag.js menggunakan cookie untuk mengidentifikasi pengguna unik di seluruh sesi penjelajahan. Halaman ini menjelaskan cara menyesuaikan setelan cookie.

Tabel berikut menunjukkan nilai kolom cookie default yang digunakan oleh gtag.js:

Nama kolom Jenis nilai Nilai default
cookie_domain string auto
cookie_expires integer 63072000 (dua tahun, dalam detik)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

Untuk mengubah salah satu nilai ini, perbarui config untuk properti Anda agar dapat menentukannya dalam daftar parameter. Contoh:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'MyCookie',
  'cookie_domain': 'blog.example.com',
  'cookie_expires': 28 * 24 * 60 * 60  // 28 days, in seconds
});

Secara default, konfigurasi domain cookie otomatis diaktifkan di gtag.js. Saat diaktifkan, gtag.js akan menetapkan cookie pada domain tingkat tertinggi yang dimungkinkan. Misalnya, jika alamat situs Anda adalah blog.example.com, gtag.js akan menetapkan cookie di domain example.com. Jika gtag.js mendeteksi bahwa Anda menjalankan server secara lokal (misalnya dengan localhost), gtag.js akan otomatis menetapkan cookie_domain ke 'none', yang akan menyebabkan gtag.js menetapkan cookie menggunakan domain lengkap dari lokasi dokumen.

Untuk menonaktifkan konfigurasi domain cookie otomatis, perbarui config untuk properti Anda agar dapat menentukan nilai untuk parameter cookie_domain:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_domain': 'blog.example.com'
});

Untuk menghindari konflik dengan cookie lain, Anda mungkin perlu mengubah awalan cookie, yang akan ditambahkan ke cookie yang ditetapkan oleh gtag.js. Misalnya, nama default cookie ID yang digunakan oleh Google Analytics adalah _ga. Kode ini akan menyebabkan cookie diberi nama example_ga:

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_prefix': 'example'
});

Pada setiap pemuatan halaman, waktu habis masa berlaku cookie diperbarui menjadi waktu saat ini dan nilai kolom cookie_expires. Artinya, jika cookie_expires ditetapkan ke satu minggu, dan pengguna berkunjung menggunakan browser yang sama dalam lima hari, cookie akan tersedia selama satu minggu lagi, dan pengguna akan muncul sebagai pengunjung yang sama di Google Analytics. Jika pengguna yang sama tersebut berkunjung setelah cookie asli berakhir masa berlakunya, cookie baru akan dibuat dan kunjungan pertama dan kedua mereka akan muncul sebagai berasal dari pengunjung yang berbeda di Google Analytics.

Jika Anda menetapkan nilai cookie_expires ke 0 (nol) detik, cookie akan berubah menjadi cookie berbasis sesi dan habis masa berlakunya setelah sesi browser saat ini berakhir.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_expires': 0
});

Jika cookie_update ditetapkan ke true (nilai default), gtag.js akan memperbarui cookie pada setiap pemuatan halaman. Hal ini akan memperbarui masa berlaku cookie agar ditetapkan secara relatif terhadap kunjungan terbaru ke situs. Misalnya, jika masa berlaku cookie ditetapkan menjadi satu minggu dan pengguna berkunjung setiap lima hari sekali dengan browser yang sama, masa berlaku cookie akan diperbarui pada setiap kunjungan, sehingga masa berlaku tersebut tidak pernah habis.

Jika ditetapkan ke false, cookie tidak akan diperbarui di setiap pemuatan halaman. Hal ini mengakibatkan masa berlaku cookie menjadi relatif terhadap saat pertama kali pengguna mengunjungi situs.

gtag('config', 'GA_MEASUREMENT_ID', {
  'cookie_update': false
});

Menambahkan tanda tambahan ke cookie saat ditetapkan. Tanda harus dipisahkan dengan titik koma.

gtag('set', {
  'cookie_flags': 'SameSite=None;Secure'
});

Menetapkan User-ID

User-ID adalah string ID unik, persisten, dan tidak dapat diidentifikasi secara pribadi yang mewakili pengguna. ID ini memungkinkan analisis grup sesi di seluruh perangkat. Untuk mengetahui alasan Anda harus menerapkan User-ID, lihat Manfaat menggunakan fitur User-ID.

Untuk menerapkan User-ID dengan gtag.js, perbarui config agar properti Anda menetapkan User-ID:

gtag('config', 'GA_MEASUREMENT_ID', {
  'user_id': 'USER_ID'
});

Anda dapat mengonfigurasi gtag.js agar tidak membaca atau menulis cookie sebelum izin diberikan oleh pengguna. Untuk mempelajari lebih lanjut, lihat Menyesuaikan perilaku tag berdasarkan izin