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

gtag.js, tarama oturumları genelindeki benzersiz 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 sitesi adresiniz blog.example.com ise gtag.js, example.com alanında çerezleri ayarlar. gtag.js, yerel olarak bir sunucu (ör.localhost) çalıştırdığınızı algılarsa cookie_domain öğesini otomatik olarak 'none' değerine ayarlar. Bu da gtag.js'nin, belge konumundaki tam alanı kullanarak çerezler ayarlamasına neden olur.

Otomatik çerez alan yapılandırmasını devre dışı bırakmak üzere mülkünüzün config özelliğini, 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, gtag.js tarafından ayarlanan çerezlerin başına eklenecek çerez ön ekini değiştirmeniz gerekebilir. Örneğin, Google Analytics tarafından kullanılan kimlik çerezinin varsayılan adı _ga'dir. Bu kod, çerezin 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ının değeri eklenecek şekilde güncellenir. Bu, 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 ettiyse, yeni bir çerez oluşturulur ve bu kullanıcının ilk ve ikinci ziyaretleri Google Analytics'te farklı ziyaretçilerden geliyormuş gibi görünür.

cookie_expires değerini 0 (sıfır) saniye olarak ayarlarsanız çerez, oturuma dayalı ç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 ayar 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'
});

User-ID ayarla

User ID, bir kullanıcıyı temsil eden benzersiz, kalıcı ve kişisel olarak tanımlanamayan 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ı'na göz atın.

User-ID'yi gtag.js ile uygulamak için mülkünüzün config değerini, User ID'yi ayarlayacak şekilde 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 edinmek için İzne göre etiket davranışını ayarlama başlıklı makaleyi inceleyin.