İzleme Kodu: Alanlar ve Dizinler

ga.js eski bir kitaplıktır. Yeni bir uygulamaya başlıyorsanız bu kitaplığın en son sürümü olan analytics.js'yi kullanmanızı öneririz. Mevcut uygulamalar için ga.js'den analytics.js'ye nasıl geçeceğinizi öğrenin.

Bu referansta, Google Analytics raporlamasının alanlarda, farklı ana makinelerde veya bir web sitesinin alt dizinlerinde çalışma şeklini özelleştirmek için kullandığınız yöntemler açıklanmaktadır.

GATC Alan/Dizin Yöntemleri

• _cookiePathCopy(newPath)
• _getLinkerUrl(targetUrl, useHash)
• _link(targetUrl, useHash)
• _linkByPost(formObject, useHash)
• _setAllowHash(bool) kullanımdan kaldırıldı
• _setAllowLinker(bool)
• _setCookiePath(newCookiePath)
• _setDomainName(newDomainName)
• _storeGac(bool)

Yöntem Ayrıntıları

_cookiePathCopy()

_cookiePathCopy(newPath)

Tüm GATC çerezlerinin yollarını yeni belirtilen yolla değiştirir. Aynı alandaki bir dizin yapısından diğerine kullanıcı davranışını izlemek için bu özelliği kullanın.

Bu işlev çağrıldığında, çerezleri hemen yeni çerez yoluna kopyalar. Bu nedenle, _trackPageview() yöntemi çağrılmadıysa mevcut Analytics çerezlerinin değerleri sağlanır. Bu nedenle, bu yöntemin _trackPageview() ile birlikte _setCampaignCookieTimeout() veya _setReferrerOverride() gibi iletmek istediğiniz çerez değerlerini veya kampanya değerlerini etkileyebilecek diğer yapılandırma yöntemlerinden sonra çağrılmasını öneririz.

Eş Zamansız Snippet (önerilir)

_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

Geleneksel (ga.js) Snippet'i

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

Parametreler

String   newPath GATC çerezlerini depolamanın yeni yolu.

---

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Bu yöntem, özellikle yeni bir pencerede açılan iFrame'ler ve bağlantılar için web alanları arası kullanıcı izlemeyi etkinleştirmek üzere _setDomainName() ve _setAllowLinker() yöntemleriyle birlikte çalışır. Bu yöntem, URL parametresine ekleyerek başlangıç bağlantısındaki tüm GATC çerezi verilerini döndürür. Bu, daha sonra başka bir siteye veya iFrame'e aktarılabilir.

Eş Zamansız Snippet (önerilir)

  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

Geleneksel (ga.js) Snippet'i

pageTracker._getLinkerUrl("http://www.my-example-iframecontent.com/");

Bağlantının düzgün çalışması için hedef sitede (pageTracker._setAllowLinker(true);) bağlantıyı da etkinleştirmeniz gerekir.

Parametreler

String   targetUrl Çerez değerlerinin gönderileceği hedef sitenin URL'si.

Boolean   useHash İzleme kodu değişkenlerini iletmek için varsayılan değer yerine # bağlantı etiketi ayırıcısını kullanarak "true" değerine ayarlansın mı? sorgu dizesi ayırıcısını kullanın.

returns

String Bağlayıcı URL'si.

---

_link()

_link(targetUrl, useHash)

Bu yöntem, web alanları arası kullanıcı izlemeyi etkinleştirmek için _setDomainName() ve _setAllowLinker() yöntemleriyle birlikte çalışır. _link() yöntemi, URL parametreleri (HTTP GET) aracılığıyla GATC çerezlerini bu siteden başka bir siteye geçirir. Ayrıca document.location öğesini değiştirir ve kullanıcıyı yeni URL'ye yönlendirir.

Eş Zamansız Snippet (önerilir)

<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

Geleneksel (ga.js) Snippet'i

<a href="http://www.newsite.com" onclick="pageTracker._link('http://www.newsite.com');return false;">Go to our sister site</a>

Bağlantının düzgün çalışması için hedef sitede (pageTracker._setAllowLinker(true);) bağlantıyı da etkinleştirmeniz gerekir.

Parametreler

String   targetUrl Çerez değerlerinin gönderileceği hedef sitenin URL'si.

Boolean   useHash İzleme kodu değişkenlerini iletmek için varsayılan değer yerine # bağlantı etiketi ayırıcısını kullanarak "true" değerine ayarlansın mı? sorgu dizesi ayırıcısını kullanın.

---

_linkByPost()

_linkByPost(formObject, useHash)

Bu yöntem, web alanları arası kullanıcı izlemeyi etkinleştirmek için _setDomainName() ve _setAllowLinker() yöntemleriyle birlikte çalışır. _linkByPost() yöntemi, GATC çerezlerini yönlendiren formdan, formun işlem değerine (HTTP POST) eklenmiş bir dizedeki başka bir siteye iletir. Bu yöntem genellikle bir siteden üçüncü taraf alışveriş sepeti sitesine kullanıcı davranışını izlerken kullanılır, ancak çerez verilerinin, pop-up'lardaki veya iFrame'lerdeki diğer alanlara gönderilmesi için de kullanılabilir.

Eş Zamansız Snippet (önerilir)

    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>
  

Geleneksel (ga.js) Snippet'i

<form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
        name="f" method="post" onsubmit="pageTracker._linkByPost(this)">
        . . .
        </form>

Ayrıca, bağlantı oluşturmanın işe yaraması için _setAllowLinker() hedef web sayfasında true olarak ayarlanmalıdır.

Parametreler

HTMLFormElement   formObject POST isteğini kapsülleyen form nesnesi.

Boolean   useHash İzleme kodu değişkenlerini iletmek için varsayılan değer yerine # bağlantı etiketi ayırıcısını kullanarak "true" değerine ayarlansın mı? sorgu dizesi ayırıcısını kullanın.

---

_setAllowHash()

_setAllowHash(bool)

Bu yöntem kullanımdan kaldırılmıştır ve web alanları arası izleme için artık gerekli değildir.

İzin verilen alan karması işaretini ayarlar. Bu değer, varsayılan olarak true şeklinde ayarlanmıştır. Google Analytics'teki alan karma oluşturma işlevi, alanınızdan bir karma değeri oluşturur ve bu sayıyı ziyaretçiler için çerez bütünlüğünü kontrol etmek için kullanır. example1.example.com ve example2.example.com gibi birden fazla alt alanınız varsa ve bu alt alanların her ikisinde de kullanıcı davranışını izlemek istiyorsanız çerez bütünlüğü denetiminin bir alandan diğerine giden kullanıcı çerezini reddetmemesi için alana karma oluşturma işlemini devre dışı bırakmanız gerekir. Ayrıca, sayfa başına izleme performansını optimize etmek için bu özelliği kapatabilirsiniz.

Parametreler

Boolean   true veya false Varsayılan değer true'dir. Bu parametre true olarak ayarlanırsa alana karma oluşturma etkinleştirilir. Aksi takdirde, alan karması devre dışı bırakılır.

---

_setAllowLinker()

_setAllowLinker(bool)

Bağlayıcı işlev işaretini, web alanları arası kullanıcı izlemeyi etkinleştirmenin bir parçası olarak ayarlar. Varsayılan olarak bu yöntem false değerine ayarlanmıştır ve bağlantı devre dışı bırakılmıştır. Web alanları arası izlemeyi etkinleştirmek için _link(), _linkByPost() ve _setDomainName() yöntemlerini de inceleyin. Hedef sitenin, standart oturum mantığı yerine URL parametresindeki çerez verilerini kullanması için hedef sitede _setAllowLinker yöntemini kullanın.

Eş Zamansız Snippet (önerilir)

_gaq.push(['_setAllowLinker', true]); 

Geleneksel (ga.js) Snippet'i

pageTracker._setAllowLinker(true);

Parametreler

Boolean  true veya false Varsayılan değer false değeridir. Bu parametre true değerine ayarlanırsa bağlayıcı etkinleştirilir. Aksi takdirde, alan bağlama özelliği devre dışı bırakılır.

---

_setCookiePath()

_setCookiePath(newCookiePath)

Siteniz için yeni çerez yolunu ayarlar. Varsayılan olarak, Google Analytics çerez yolunu kök düzeyine (/) ayarlar. Çoğu durumda bu en uygun seçenektir ve web sitenize, blogunuza veya şirketinizin web dizinine yüklediğiniz izleme koduyla doğru şekilde çalışır. Ancak, kullanıcı erişiminin yalnızca alanın alt diziniyle sınırlı olduğu birkaç durumda bu yöntem, tüm izlemeler için varsayılan yol olarak bir alt dizin ayarlayarak izleme sorunlarını çözebilir.

Normalde, verileriniz izlenmiyorsa, bir blog hizmetine abone olduysanız ve yalnızca tanımladığınız alt dizine erişebiliyorsanız veya bir Şirket ya da Üniversite ağındaysanız ve yalnızca ana dizininize erişebiliyorsanız bunu kullanırsınız.

Dikkat: Çerez yolunun bir değerden diğerine değiştirilmesi yanlış analiz verilerine yol açabilir. Bu nedenle, belirli bir değeri kullandıktan sonra çerez yolunda değişiklik yapmaktan kaçınmanız önerilir.

Eş Zamansız Snippet (önerilir)

_gaq.push(['_setCookiePath', '/myBlogDirectory']); 

Geleneksel (ga.js) Snippet'i

pageTracker._setCookiePath("/myBlogDirectory");

Parametreler

String   newCookiePath Ayarlanacak yeni çerez yolu.

---

_setDomainName()

_setDomainName(newDomainName)

GATC çerezleri için alan adını ayarlar. Bu yöntemin üç modu vardır: ("auto" | "none" | [domain]). Yöntem, varsayılan olarak auto değerine ayarlanır. Bu yöntem, alan adını DOM'deki document.domain özelliğine göre çözümlemeyi dener.

Alan Adı Belirtme

Bu yöntemle bir alanın ne zaman ve nasıl belirtileceğini gösteren çeşitli örnekler için Web Alanları Arası İzleme Kılavuzu'nu inceleyin. Aşağıdaki örnekte, alan adını nasıl example.com olarak ayarlayacağınız gösterilmektedir:

Eş Zamansız Snippet (önerilir)

_gaq.push(['_setDomainName', 'example.com']); 

Geleneksel (ga.js) Snippet'i

pageTracker._setDomainName("example.com");

Not: Alanı ayarlarken baştaki noktanın kullanılması da işe yarar. Önemli olan _setDomainName, alan bağlantısına katılan tüm alanlarda aynı şekilde yapılandırılmasıdır. Bu, çerezlerin tüm katılımcı sitelerde kullanılabilmesini sağlayarak rapor verilerindeki hataları ve tutarsızlıkları önler.

Üst Düzey Alanları Yalıtma

Bu yöntemin none olarak ayarlanması, belirli bir alandaki çerezlere hiçbir alt alan tarafından erişilemez.

Eş Zamansız Snippet (önerilir)

_gaq.push(['_setDomainName', 'none']); 

Geleneksel (ga.js) Snippet'i

pageTracker._setDomainName("none");

Parametreler

String   newDomainName Ayarlanacak yeni varsayılan alan adı.

---

_storeGac(bool)

GAC çerezinin oluşturulup oluşturulmayacağını belirler. Varsayılan olarak GAC çerezi, komut dosyası tarafından yazılır ve çerezi yazmak için herhangi bir işlem yapmanız gerekmez. Aşağıdaki komutu kullanarak bu çerezin ayarlanmasını devre dışı bırakabilirsiniz.

Eş zamansız Snippet (önerilen)

_gaq.push(['_storeGac', false]);

Geleneksel Snippet

pageTracker._storeGac(false);

---