İzleme Kodu: Temel Yapılandırma

Bu referansta, Google Analytics raporlamasının tüm özelliklerini özelleştirmek için kullandığınız yöntemler açıklanmaktadır.

ga.js Temel Yöntemleri

Yöntem Ayrıntıları

_deleteCustomVar()

_deleteCustomVar(index)

Bu yöntem, sağlanan dizine atanan değişkeni (varsa) siler. Örneğin, ziyaretçi düzeyinde bir özelleştirilebilen değişken ayarlayıp daha sonra bu ziyaretçi düzeyindeki değişkeni artık kullanmak istemediğinize karar verebilirsiniz.

Eş Zamansız Snippet (önerilir)

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

Parametreler

Int   index Silinecek özelleştirilebilen değişkenin dizini.

_getName()

_getName()

İzleyiciye, oluşturulduğunda verilen adı döndürür.

Eş Zamansız Snippet (önerilir)

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

returns

String Takip cihazının adı.

_getAccount()

_getAccount()

Bu izleyici nesnesi için Google Analytics kimliğini döndürür. Web sitenizdeki sayfaları birden çok hesapta izliyorsanız belirli bir izleme nesnesiyle ilişkilendirilmiş hesabı belirlemek için bu yöntemi kullanabilirsiniz.

Eş Zamansız Snippet (önerilir) 

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

returns

String Bu izleyici nesnesinin örneklendiği hesap kimliği.

_getVersion()

_getVersion()

GATC sürüm numarasını döndürür.

Eş Zamansız Snippet (önerilir) 

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

returns

String GATC sürüm numarası.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

Belirtilen dizin için atanan ziyaretçi düzeyinde özelleştirilebilen değişken değerini döndürür.

Eş Zamansız Snippet (önerilir) 

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

Parametreler

Int   index Ziyaretçi düzeyi özelleştirilebilen değişkeninin dizini.

returns

String Ziyaretçi düzeyinde özelleştirilebilen değişkenin değeri. Belirtilen dizin için değişken alınamıyorsa tanımlanmamış değerini döndürür.

_initData()

_initData()Kullanımdan kaldırıldı. initData() artık ga.js izleme kodunda otomatik olarak çalışıyor.

GATC (Google Analytics İzleyici Kodu) nesnesini başlatır veya yeniden başlatır.

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

_setAccount()

_setAccount(accountId)

Yalnızca eşzamansız izlemede kullanılır. İzleme nesnesinin web mülkü kimliğini ayarlar.

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

Parametreler

String accountID İzleyici nesnesinin tam web mülkü kimliği (ör. UA-65432-1).

_setCookiePersistence()

_setCookiePersistence(milliseconds)

Bu yöntem kullanımdan kaldırılmıştır. Lütfen bunun yerine _setVisitorCookieTimeout(cookieTimeoutMillis) kullanın.

Google Analytics ziyaretçi çerezinin geçerlilik süresini milisaniye cinsinden belirler. Ziyaretçi çerezinin süresi varsayılan olarak 2 yıl içinde dolacak şekilde ayarlanmıştır. Dilerseniz bu yöntemi kullanarak ziyaretçi çerezinin geçerlilik bitiş tarihini değiştirebilirsiniz. Örneğin, ziyaretçi çerezinin geçerlilik süresini 7 güne ayarlamak için aşağıdaki kodu kullanmanız gerekir:

pageTracker._setCookiePersistence(604800000);

parametreler

Number   milliseconds Yeni ziyaretçi çerezinin geçerlilik süresi.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Değişken için sağlanan ad, değer ve kapsamla özelleştirilebilen bir değişken ayarlar. name ve value için toplam 128 bayt karakter sınırlaması vardır.

Eş Zamansız Snippet (önerilir) 

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

returns

Boolean Bu yöntem, özelleştirilebilen değişken başarıyla ayarlanmışsa true ve ayarlanmamışsa false değerini döndürür (ör. ad/değer dizesi uzunluğu 128 baytı aşıyorsa veya yanlış alan kullanıyorsanız).

Parametreler

Int      index       Zorunlu. Özelleştirilebilen değişken için kullanılan alan. Olası değerler 1-5 (bu değerler dahil) şeklindedir.

String   name        Zorunlu. Özelleştirilebilen değişkenin adı.

String   value       Zorunlu. Özelleştirilebilen değişkenin değeri.

Int      opt_scope   İsteğe bağlı. Özelleştirilebilen değişken için kullanılan kapsam. Olası değerler ziyaretçi düzeyi için 1, oturum düzeyi için 2 ve sayfa düzeyi için 3'dir.

_setSampleRate()

_setSampleRate(newRate)

Yeni örnek hızını ayarlar. Web siteniz özellikle büyükse ve yoğun trafik artışları yaşanıyorsa, örnek hızını ayarlamak kesintisiz rapor izleme sağlar. Google Analytics'te örnekleme işlemi farklı ziyaretçiler arasında tutarlı bir şekilde gerçekleştiğinden, benzersiz ziyaretçiler örneklemenin başlangıcında olduğu gibi örneğe dahil edilme veya örneğin dışında tutulmaya devam ettiği için, örnekleme etkin olsa bile, trend ve raporlama açısından bütünlük mevcuttur.

Bu yöntemi, _setAccount() çağrısıyla aynı anda belirtmeniz yeterlidir. Bu genellikle sayfa veya uygulama başına bir defa (izleme kodunu başlattığınız her yerde). Belirttiğiniz örnek oranı değerinin, izleme nesnesinin kendisi var olduğu sürece geçerli kalacağını unutmayın.

Eş Zamansız Snippet (önerilir) 

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

Parametreler

String newRate Ayarlanacak yeni örnek hızı. 0 ile 100 arasında (iki ondalık basamağa kadar kesin) sayısal bir dize girin.

_setSessionTimeout()

_setSessionTimeout(newTimeout)

Bu yöntem kullanımdan kaldırılmıştır. Lütfen bunun yerine _setSessionCookieTimeout(cookieTimeoutMillis) kullanın.

Yeni oturum zaman aşımı süresini saniye cinsinden ayarlar. Oturum zaman aşımı varsayılan olarak 30 dakikaya (1.800 saniye) ayarlanmıştır. Oturum zaman aşımı, ziyaretleri hesaplamak için kullanılır (Analytics'te bir oturum nasıl tanımlanır? bölümünü inceleyin). Belirli ihtiyaçlarınız için "oturum"un tanımını değiştirmek istiyorsanız yeni bir değer tanımlamak üzere saniye sayısını belirtebilirsiniz. Bu değişiklik, ziyaret sayısının hesaplandığı ve diğer değerlerin hesaplanmasında ziyaretlerin kullanıldığı her bölümdeki Ziyaret raporlarını etkileyecektir. Örneğin, oturum zaman aşımını kısaltırsanız ziyaret sayısı genellikle artar, oturum zaman aşımını artırdığınızda ise genellikle azalır.

parametreler

String newTimeout Saniye olarak ayarlanacak yeni oturum zaman aşımı.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Yeni oturum çerezi zaman aşımı süresini milisaniye cinsinden ayarlar. Varsayılan olarak, oturum zaman aşımı 30 dakikaya ayarlanmıştır. Ziyaret, 30 dakika boyunca tarayıcı kullanılmadığında veya tarayıcıdan çıkıldıktan sonra sona erdiği için oturum zaman aşımı ziyaretleri hesaplamak için kullanılır. Belirli ihtiyaçlarınız için bir "oturum"un tanımını değiştirmek istiyorsanız yeni bir değer tanımlamak üzere milisaniye cinsinden geçiş yapabilirsiniz. Bu durum, ziyaret sayısının hesaplandığı ve diğer değerlerin hesaplanmasında ziyaretlerin kullanıldığı her bölümdeki Ziyaret raporlarını etkileyecektir. Örneğin, oturum zaman aşımını kısaltırsanız ziyaret sayısı artar, oturum zaman aşımını artırırsanız ziyaret sayısı azalır. Tarayıcı kapatıldığında bu çerezin silinmesi gerektiğini belirtmek için süre sonu zaman aşımını 0 olarak değiştirebilirsiniz.

Eş Zamansız Snippet (önerilir) 

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


Parametreler

Number cookieTimeoutMillis Tarayıcı kapalıyken çerezi silmek için milisaniye cinsinden yeni oturum zaman aşımı veya 0.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

Site Hızı veri toplama işlemi için yeni bir örneklem kümesi boyutu tanımlar. Varsayılan olarak, site ziyaretçilerinizin sabit% 1'lik bir örneklemesi, Site Hızı metriklerinin elde edildiği veri havuzunu oluşturur. Sitenize gelen nispeten az sayıda günlük ziyaretçi varsa (ör. 100.000 veya daha az) örneklemeyi daha yüksek bir orana ayarlayabilirsiniz. Bu, sayfa yükleme süresi ve diğer Site Hızı metrikleri için daha yüksek ayrıntı düzeyi sağlar. (Site Hızı raporlarıyla ilgili ayrıntılar için Yardım Merkezi'ndeki Site Hızı bölümüne bakın.)

_setSiteSpeedSampleRate() yöntemi, etkili olması için _trackPageview() tarihinden önce çağrılmalıdır.

Analytics, bu özellik için sistem kaynaklarının adil bir şekilde dağıtılmasını sağlamak amacıyla tek bir mülke ilişkin Site Hızı toplama isabetlerini, kullanıcıların% 1'i veya günde 10.000 isabetle sınırlandırır.

Not: Günde 1 milyondan fazla isabet alan sitelerin, örnek seçimlerini varsayılan% 1 oranında tutmalarını kesinlikle öneririz. Örneklem boyutunun daha büyük bir sayıya ayarlanması, örneklem boyutunuzu artırmaz.

Eş Zamansız Snippet (önerilir) 

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

Parametreler

Number sampleRate Site Hızı amacıyla ölçülecek, sitenize gelen ziyaretçilerin yüzdesini tanımlamak için kullanılan 0-100 arası değer. Örneğin, 5 değeri, Site Hızı toplama örneğini %5'e ayarlar.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

Google Analytics ziyaretçi çerezinin geçerlilik süresini milisaniye cinsinden belirler. Ziyaretçi çerezinin süresi, varsayılan olarak 2 yıl içinde dolacak şekilde ayarlanmıştır. İsterseniz bu yöntemi kullanarak ziyaretçi çerezinin son kullanma tarihini değiştirebilirsiniz. Tarayıcı kapatıldığında bu çerezin silinmesi gerektiğini belirtmek için geçerlilik süresi zaman aşımını 0 olarak değiştirebilirsiniz.

Eş Zamansız Snippet (önerilir) 

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

Parametreler

Number cookieTimeoutMillis Tarayıcı kapalıyken çerezi silmek için milisaniye cinsinden yeni ziyaretçi çerezi geçerlilik süresi veya 0.

_setVar()

_setVar(newVal)

Bu yöntem kullanımdan kaldırılmıştır. Lütfen bunun yerine _setCustomVar() sütunlarını kullanın.

Sağlanan dizeyle özel bir ziyaretçi segmenti belirler veya tanımlar. Bu değeri, web sitenizin kullanıcıları hakkında ek segmentasyon sağlamak için kullanabilirsiniz. Örneğin, ziyaretçinin seçtiği bir tercih ya da bir gizlilik seçeneği gibi ziyaretçinin girişine göre bir değeri tetikleyen bir giriş sayfanız veya formunuz olabilir. Bu değişken, daha sonra söz konusu ziyaretçinin çerezinde güncellenir. Sitenizde uygulandığında ve veriler bu yöntemle toplandığında, yeni tanımlanan segment Analytics Raporları'nın Ziyaretçiler bölümündeki Kullanıcı Tanımlı raporlarında görünür. Ayrıca, bir sayfayı ziyaret edenlerin yüzde kaçının tanımladığınız belirli bir segmente ait olduğunu görmek için İçerik Ayrıntısı raporundaki Kullanıcı Tanımlı Değer segmentine erişebilirsiniz.

parametreler

String newVal Ayarlanacak yeni kullanıcı tanımlı değer.

_trackPageLoadTime()

_trackPageLoadTime()

Site Hızı raporlaması tüm kullanıcılar için otomatik olarak etkinleştirildiğinden bu yöntem kullanımdan kaldırılmıştır. Site Hızı raporlaması için örnekleme hızını ayarlamak üzere lütfen _setSiteSpeedSampleRate() parametresini kullanın.

Bu sayfa için Site Hızı raporlarını etkinleştirir. Bu yöntemi, sitenizde Site Hızı raporlaması istediğiniz her sayfaya ekleyin. Analytics'teki Site Hızı raporları hakkında daha fazla bilgi için Yardım Merkezimizdeki Site Hızı adlı makaleyi inceleyin.

Değişikliklerinizi Doğrulama

Raporlarda veriler görüyorsanız ayarlarınız doğrudur. 24 saat geçmesine rağmen hiçbir veri görmüyorsanız hata yapmadığınızdan emin olmak için özelleştirmenizi kontrol edin. Sık karşılaşılan izleme kodu hatalarının bir listesi için İzleme Kodu Sorunlarını Giderme bölümünü inceleyin. Bu sorun giderme kılavuzu ayrıca, Temel Hata Ayıklama Adımları ve hata ayıklama hakkında daha fazla bilgi içerir.

Siteniz için Site Hızı izlemeyi etkinleştirmenin, Google Analytics sunucularına ekstra bir istek gönderilmesiyle sonuçlandığını unutmayın. Bu istek, sayfa görüntülemeler için gönderilen sayfa izleme GIF isteğinden ayrıdır. Sitenin genel gecikmesi üzerindeki etkiyi en aza indirmek amacıyla, bu istek yalnızca sitenize ait sayfa görüntülemelerin birkaç örneği için gönderilir. Bu nedenle, bu özelliğe Firebug veya diğer araçlarla hata ayıklama uygulamaya çalışırken site hızı GIF isteğini her zaman göremeyebilirsiniz. Bu normal ve beklenen bir durumdur.

Eş Zamansız Snippet (önerilir) 

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

_trackPageview()

_trackPageview(opt_pagePath)

GATC (Google Analytics Tracker Code) için ana mantık. Bağlayıcı işlevleri etkinleştirilirse çerez değerlerini URL'den çıkarmaya çalışır. Aksi takdirde, çerez değerlerini document.cookie kaynağından çıkarmaya çalışır. Ayrıca, gerektiğinde çerezleri günceller veya oluşturur, ardından bunları tekrar belge nesnesine yazar. UCFE'ye (Urchin Toplayıcı Ön Ucu) gönderilecek tüm uygun ölçümleri toplar.

Eş Zamansız Snippet (önerilir) 

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

Parametreler

String opt_pagePath Metriklerin izleneceği sayfanın yolunu belirtmek için isteğe bağlı parametre. Bu seçeneği kullanırken sayfa yolunu belirtmek için başlangıçtaki eğik çizgi (/) kullanın.