İzleme Kodu: Temel Yapılandırma

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

ga.js Temel Yöntemleri

Yöntem Ayrıntıları

_deleteÖzelVar()

_deleteCustomVar(index)

Bu yöntem, sağlanan dizine atanan değişkeni (varsa) siler. Örneğin, ziyaretçi düzeyinde özelleştirilebilen bir değişken belirleyip daha sonra bu ziyaretçi düzeyindeki değişkeni 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 verildiği 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 İzleyicinin adı.

_getAccount()

_getAccount()

Bu izleyici nesnesi için Google Analytics kimliğini döndürür. Web sitenizdeki sayfaları birden fazla hesapta izliyorsanız belirli bir izleyici 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.

_getSürüm()

_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üzeyindeki özelleştirilebilen değişkenin dizini.

returns

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

_initVeri()

_initData()Kullanımdan kaldırıldı. initData() artık ga.js izleme kodunda otomatik olarak yürütülmektedir.

GATC (Google Analytics İzleyici Kodu) nesnesini ilk kullanıma hazırlar 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 belirler.

_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. Onun yerine lütfen _setVisitorCookieTimeout(cookieTimeoutMillis) kullanın.

Google Analytics ziyaretçi çerezi geçerlilik süresini milisaniye cinsinden ayarlar. Ziyaretçi çerezinin geçerlilik süresi varsayılan olarak 2 yıldır. Dilerseniz ziyaretçi çerezinin geçerlilik bitiş tarihini bu yöntemi kullanarak değiştirebilirsiniz. Örneğin, ziyaretçi çerezinin geçerlilik süresini 7 gün olarak ayarlamak için aşağıdaki kodu kullanın:

pageTracker._setCookiePersistence(604800000);

parametreler

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

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

Değişken için sağlanan ad, değer ve kapsamı içeren bir özelleştirilebilen değişken ayarlar. name ve value için toplam 128 baytlık bir karakter sınırı 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ılı şekilde ayarlanmışsa true değerini, ayarlanmamışsa (ör. ad/değer dizesi uzunluğu 128 baytı aşıyorsa veya yanlış alan kullanırsanız) false değerini döndürür.

Parametreler

Int      index       Zorunlu. Özelleştirilebilen değişken için kullanılan alan. Olası değerler, 1-5 dahildir.

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ı belirler. Web siteniz özellikle büyükse ve trafikteki ani artışlar söz konusuysa örnek hızını ayarlamak, kesintisiz rapor izleme olanağı sağlar. Google Analytics'te örnekleme, tekil ziyaretçiler arasında tutarlı bir şekilde gerçekleşir. Bu nedenle, örnekleme örnek alınırken, örneğin örnekleme başlangıcından itibaren örneğin içinde bulunduğu veya hariç tutulduğu için örnekleme ve raporlamada bütünlük vardır.

Bu yöntemi yalnızca _setAccount() çağrısıyla aynı anda, genellikle sayfa veya uygulama başına bir kez (izleme kodunun kendisi başlatıldığı yerde) belirtmeniz gerekir. Belirttiğiniz örnek ücret değerinin, izleme nesnesinin kendisi olduğu sürece geçerli olacağı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) sayısal bir dize sağlayın.

_setSessionTimeout()

_setSessionTimeout(newTimeout)

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

Yeni oturum zaman aşımını saniye cinsinden ayarlar. Oturum zaman aşımı varsayılan olarak 30 dakikaya (1.800 saniye) ayarlıdır. Ziyaretleri hesaplamak için oturum zaman aşımı kullanılır (bkz. Analytics'te oturum nasıl tanımlanır?). Belirli bir "oturum"un tanımını değiştirmek isterseniz saniye cinsinden zaman harcayarak yeni bir değer tanımlayabilirsiniz. Bu, ziyaret sayısının hesaplandığı ve ziyaretlerin diğer değerlerin hesaplanmasında kullanıldığı her bölümdeki Ziyaret raporlarını etkiler. Örneğin, oturum zaman aşımını kısaltırsanız ziyaret sayısı genellikle artar ve oturum zaman aşımını artırdığınızda genellikle azalır.

parametreler

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

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

Yeni oturum çerezi zaman aşımını milisaniye cinsinden ayarlar. Oturum zaman aşımı varsayılan olarak 30 dakikaya ayarlanır. Ziyaret 30 dakika boyunca tarayıcıda işlem yapılmadığında veya tarayıcıdan çıktıktan sonra sona erdiği için ziyaretleri hesaplamak amacıyla oturum zaman aşımı kullanılır. Belirli bir ihtiyaçlarınız için "oturum" tanımını değiştirmek isterseniz milisaniye cinsinden iletilen değeri yeni bir değer olarak tanımlayabilirsiniz. Bu durum, ziyaret sayısının hesaplandığı ve ziyaretlerin diğer değerlerin hesaplanmasında kullanıldığı her bölümdeki Ziyaret raporlarını etkiler. Örneğin, oturum zaman aşımını kısaltırsanız ziyaret sayısı artar ve oturum zaman aşımını artırırsanız 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ı kapatıldığında çerezi silmek için milisaniye veya 0 saniye cinsinden yeni oturum zaman aşımı.

_setSiteHızıÖrnek Oranı()

_setSiteSpeedSampleRate(sampleRate)

Site Hızı veri toplaması için yeni bir örnek grup boyutu tanımlar. Varsayılan olarak, site ziyaretçilerinizin sabit% 1'lik bir kısmı, Site Hızı metriklerinin elde edildiği veri havuzunu oluşturur. Sitenizin nispeten az sayıda günlük ziyaretçisi varsa (ör. 100.000 veya daha az), örneklemeyi daha yüksek bir hıza göre ayarlamak isteyebilirsiniz. Bu, sayfa yüklenme süresi ve diğer Site Hızı metrikleri için daha yüksek bir ayrıntı düzeyi sağlar. (Site Hızı raporlarıyla ilgili ayrıntılar için Yardım Merkezi'nde Site Hızı bölümüne bakın.)

Etkili olması için _setSiteSpeedSampleRate() yönteminin _trackPageview() öncesinde çağrılması gerekir.

Analytics, tek bir mülk için Site Hızı toplama isabetlerini bu özelliğin sistem kaynaklarının eşit şekilde dağıtılmasını sağlamak amacıyla, kullanıcıların% 1'i veya günlük 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ı önemle tavsiye ederiz. Örnek boyutunu daha büyük bir sayıya ayarlamak, örnek boyutunuzu artırmaz.

Eşzamansız Snippet (önerilir) 

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

Parametreler

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

_setvisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

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

Eşzamansız Snippet (önerilir) 

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

Parametreler

Number cookieTimeoutMillis Tarayıcı kapatıldığında çerezi silmek için yeni ziyaretçi çerezi geçerlilik süresi (milisaniye 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ına ek segmentasyon sağlamak için kullanabilirsiniz. Örneğin, ziyaretçinin belirlediği bir tercihe (ör. ziyaretçinin seçtiği tercih) veya bir gizlilik seçeneğine göre değer tetikleyen bir giriş sayfanız ya da formunuz olabilir. Bu değişken, söz konusu ziyaretçi için çerezde güncellenir. Sitenizde uygulandığında ve bu yöntemle veriler 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. Buna ek olarak, bir sayfanın ziyaretçilerinin 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 Belirlenecek 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() kullanın.

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

Değişikliklerinizi Doğrulama

Raporlarda veriler gösteriliyorsa 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 listesi için İzleme Koduyla İlgili Sorunları Giderme sayfasını inceleyin. Bu sorun giderme kılavuzunda, Temel Hata Ayıklama Adımları ve hata ayıklama hakkında daha fazla bilgi yer almaktadır.

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 Analytic Tracker Code) için ana mantık. Bağlayıcı işlevleri etkinleştirilirse URL'den çerez değerlerini çıkarmaya çalışır. Aksi takdirde document.cookie, çerez değerlerini ayıklamaya çalışır. Ayrıca, gerektiğinde çerezleri günceller veya oluşturur, ardından bunları belge nesnesine tekrar yazar. UCFE'ye (IAM Toplayıcısı Ön Uç) göndermek için uygun tüm metrikleri 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ıç eğik çizgisi (/) kullanın.