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.

Catatan: Anda dapat melihat panduan Penggunaan cookie untuk mengetahui detail tentang cara gtag.js menggunakan cookie.

Mengonfigurasi setelan kolom 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
});

Konfigurasi domain cookie

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'
});

Catatan: Saat Anda menggunakan konfigurasi domain cookie otomatis, aktivitas akan diukur di seluruh subdomain tanpa konfigurasi tambahan.

Perhatian: cookie_domain harus merupakan ancestor domain saat ini. Jika tidak, cookie tidak akan ditetapkan. Misalnya, jika domain Anda adalah one.two.three.root.com, Anda dapat mengonfigurasi cookie agar ditetapkan di root.com, tetapi tidak di someotherdomain.com. Penetapan domain cookie yang salah akan mengakibatkan tidak ada hit yang dikirim ke Google Analytics.

Awalan cookie

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'
});

Perhatian: Jika situs diberi tag dengan gtag.js atau Google Analytics, dan cookie_prefix diubah setelah pengguna mengunjungi situs, pengunjung tersebut akan muncul sebagai pengunjung baru ke gtag.js dan Google Analytics, karena konteks yang disimpan dalam cookie yang tanpa awalan akan hilang. Oleh karena itu, jika Anda ingin menggunakan awalan cookie, sebaiknya gunakan sejak pertama kali situs diberi tag.

Masa berlaku cookie

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
});

Perhatian: Jika Anda menetapkan masa berlaku cookie yang terlalu singkat, Anda akan meng-inflate jumlah pengguna Anda dan mengurangi kualitas pengukuran.

Update cookie

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
});

Tanda cookie

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

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

Perhatian: Menetapkan samesite ke None dan menghapus tanda Secure atau menayangkan situs melalui HTTP akan berdampak negatif pada pengukuran.

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'
});

Menyesuaikan perilaku tag berdasarkan izin

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