gtag.js ile çerezler ve kullanıcı tanımlama

gtag.js, tarayıcı oturumlarındaki tekil kullanıcıları tanımlamak için çerezleri kullanır. Bu sayfada, çerez ayarlarının nasıl özelleştirileceği açıklanmaktadır.

Aşağıdaki tabloda, gtag.js tarafından kullanılan varsayılan çerez alanı değerleri gösterilmektedir:

Alan adı Değer türü Varsayılan değer
cookie_domain string auto
cookie_expires integer 63072000 (saniye cinsinden iki yıl)
cookie_prefix string _ga
cookie_update boolean true
cookie_flags string

Bu değerlerden herhangi birini değiştirmek için mülkünüzün config özelliğini, parametre listesinde belirtecek şekilde güncelleyin. Örneğin:

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

Varsayılan olarak, gtag.js'de otomatik çerez alanı yapılandırması etkindir. Etkinleştirildiğinde, gtag.js çerezleri mümkün olan en üst düzey alanda ayarlar. Örneğin, web siteniz blog.example.com ise gtag.js, example.com alanında çerezler oluşturur. gtag.js, bir sunucuyu yerel olarak (ör.localhost) çalıştırdığınızı algılarsa cookie_domain öğesini otomatik olarak 'none' değerine ayarlar. Bu da gtag.js'nin, belge konumundan tam alanı kullanarak çerezler ayarlamasına neden olur.

Otomatik çerez alan yapılandırmasını devre dışı bırakmak için mülkünüzün config değerini, cookie_domain parametresi için bir değer belirtecek şekilde güncelleyin:

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

Diğer çerezlerle çakışma olmaması için çerez ön ekini değiştirmeniz gerekebilir. Bu ön ek, gtag.js tarafından ayarlanan çerezlerin başına eklenir. Örneğin, Google Analytics tarafından kullanılan kimlik çerezinin varsayılan adı _ga şeklindedir. Bu kod, çerezin bunun yerine example_ga olarak adlandırılmasına neden olur:

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

Her sayfa yüklemesinde çerezin geçerlilik süresi, geçerli süreye cookie_expires alanındaki değer eklenerek güncellenir. Diğer bir deyişle, cookie_expires bir hafta olarak ayarlanırsa ve kullanıcı beş gün içinde aynı tarayıcıyı kullanarak ziyaret ederse çerez bir hafta daha kullanılabilir ve Google Analytics'te aynı ziyaretçi olarak görünür. Aynı kullanıcı, orijinal çerezin süresi dolduktan sonra ziyaret gerçekleştirdiyse yeni bir çerez oluşturulur ve bu kullanıcının ilk ve ikinci ziyaretleri Google Analytics'te farklı ziyaretçilerden gelmiş olarak görünür.

cookie_expires değerini 0 (sıfır) saniye olarak ayarlarsanız çerez oturuma dayalı bir çereze dönüşür ve mevcut tarayıcı oturumu sona erdiğinde çerezin süresi dolar.

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

cookie_update, true (varsayılan değer) olarak ayarlandığında gtag.js, her sayfa yüklemesinde çerezleri günceller. Bu durumda çerez geçerlilik süresi siteye yapılan en son ziyarete göre ayarlanarak güncellenir. Örneğin, çerez geçerlilik süresi bir hafta olarak ayarlanırsa ve kullanıcı beş günde bir aynı tarayıcıyı kullanarak siteyi ziyaret ederse çerez geçerlilik süresi her ziyarette güncellenir ve geçerlilik süresi hiçbir zaman dolmaz.

Bu parametre false olarak ayarlandığında çerezler her sayfa yüklenişinde güncellenmez. Bu durumda çerez geçerlilik sonu, kullanıcının siteye yaptığı ilk ziyarete göre hesaplanır.

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

Ayarlandığında çereze ek işaretler ekler. İşaretler noktalı virgülle ayrılmalıdır.

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

Kullanıcı Kimliği Ayarla

User-ID, bir kullanıcıyı temsil eden benzersiz, kalıcı ve kimlik ifşa eden bilgiler içermeyen bir kimlik dizesidir. Cihazlar arasında oturum gruplarının analiz edilebilmesini sağlar. User ID'yi neden uygulamanız gerektiğini öğrenmek için User ID özelliğini kullanmanın avantajları bölümüne bakın.

User-ID'yi gtag.js ile uygulamak için mülkünüzün config değerini, User-ID'yi ayarlamak üzere güncelleyin:

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

gtag.js'yi, kullanıcıdan izin verilene kadar çerez okumayacak veya yazmayacak şekilde yapılandırabilirsiniz. Daha fazla bilgi için İzne göre etiket davranışını ayarlama başlıklı makaleyi inceleyin.