Bağlayıcı eklentisi, web alanları arası ölçümü uygulama işlemini analytics.js için Web alanları arası ölçüm kılavuzunda açıklandığı gibi basitleştirir.
Genel bakış
Web alanları arası ölçüm, kaynak alan ve hedef alan arasında benzersiz bir istemci kimliği paylaşarak çalışır. Bu, iki adımlı bir işlemdir:
- Kaynak alan adında, hedef alana yönlendiren tüm URL'lerin, kaynak alanın istemci kimliğini içermesi gerekir.
- Kullanıcı URL'ye gittiğinde, hedef alan adının URL'de bir istemci kimliği olup olmadığını kontrol edebilmesi gerekir.
Bağlayıcı eklentisi bunu, hedef alana yönlendiren URL'lere bir linker parametresi ekleyerek gerçekleştirir. Bağlayıcı parametresi, istemci kimliğinin yanı sıra içinde kodlanmış olan geçerli zaman damgasını ve tarayıcı meta verilerini içerir. Zaman damgası ve meta veriler, URL paylaşımıyla ilgili sorunları önlemek için kullanılır.
Bağlayıcı parametresi aşağıdaki gibi görünür:
_ga=1.199239214.1624002396.1440697407
Hedef alan adında allowLinker alanı sağlanır. Bu alan, true olduğunda analytics.js'ye URL'de bağlayıcı parametreleri olup olmadığını kontrol etmesini bildirir. Bağlayıcı parametresi bulunur ve geçerliyse parametreden Client-ID değerini çıkarıp depolar.
Bağlayıcı eklentisi, sayfadaki bağlantılardaki ve formlardaki URL'lere bağlayıcı parametresinin hem otomatik hem de manuel olarak eklenmesine olanak tanır. Çoğu durumda, otomatik yöntem önerilir.
Bağlayıcı parametrelerini otomatik olarak ekleme
Hedef alan adına işaret eden URL'ler için kaynak alan adında web alanları arası otomatik bağlantı oluşturmak üzere bağlayıcı eklentisini require ve autoLink yöntemini çağırmanız gerekir.
autoLink
autoLink yöntemi, komut sırası aracılığıyla çağrılabilir.
Çalıştırıldığında analytics.js, hedef alana (veya alanlara) yönlendiren bağlantılara yapılan tıklamaları izler ve navigasyon başlamadan hemen önce bağlayıcı parametresini bu bağlantılara ekler. Bağlayıcı parametrelerinin süresi iki dakika sonra dolduğundan, bağlayıcı parametresini eklemek için kullanıcının bir bağlantıyı tıklamasını beklemek gerekir.
Sitenizde hedef alan adına yönlendiren formlar varsa isteğe bağlı decorateForms parametresi belirtilmeli ve true olarak ayarlanmalıdır.
Kullanım
ga('[trackerName.]linker:autoLink', domains, [useAnchor], [decorateForms]);
Parametreler
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
domains |
Array[RexExp|string] |
evet | Otomatik bağlantı özelliğinin hangi alan adlarına uygulanması gerektiğini belirten, URL'nin hostname değeriyle eşleşecek dize veya normal ifadeler dizisi. Bir dize iletilirse analytics.js bir alt dize eşleşmesi gerçekleştirir. Diğer bir deyişle, example.com, blog.example.com adresine işaret eden bağlantıları eşleştirir. |
useAnchor |
boolean |
no | Doğru olduğunda bağlayıcı parametresi, sorgu kısmı yerine URL'nin bağlayıcı bölümüne eklenir. |
decorateForms |
boolean |
no | Doğru olduğunda bağlayıcı eklentisi, domain parametresiyle eşleşen hedeflere yönlendiren form gönderimlerine bir bağlayıcı parametresi ekler. |
Örnek
// Loads the Linker plugin
ga('require', 'linker');
// Instructs the Linker plugin to automatically add linker parameters
// to all links and forms pointing to the domain "destination.com".
ga('linker:autoLink', ['destination.com'], false, true);
Bağlayıcı parametrelerini manuel olarak ekleme
Bağlayıcı parametresini, decorate yöntemiyle belirli bir <a> veya <form> öğesine manuel olarak ekleyebilirsiniz. Bu yöntem yalnızca yukarıda açıklanan autoLink yöntemi kullanılmadığında gereklidir.
decorate
decorate yöntemi, komut sırası aracılığıyla çağrılabilir.
Bağlayıcı parametrelerinin süresi iki dakika sonra dolduğu için süsleme yönteminin, gezinmenin mümkün olduğunca yakın zamanda çağrılmasını sağlamak önemlidir. Çoğu zaman bu yöntem bir etkinlik işleyicide çağrılmalıdır.
Kullanım
ga('[trackerName.]linker:decorate', element, [useAnchor]);
Parametreler
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
element |
HTMLElement |
evet | Bağlayıcı parametresinin ekleneceği <a> veya <form> öğesidir. |
useAnchor |
boolean |
no | Doğru olduğunda bağlayıcı parametresi, sorgu kısmı yerine URL'nin bağlayıcı bölümüne eklenir. |
Örnek
// Loads the Linker plugin
ga('require', 'linker');
// Gets a reference to a link pointing to an external domain.
var destinationLink = document.getElementById('destination-link');
// Adds click handler that decorates `destinationLink`.
destinationLink.addEventListener('click', function() {
ga('linker:decorate', destinationLink);
});
linkerParam
decorate yöntemine ek olarak, bir izleyicinin kullanacağı bağlayıcı parametresini linkerParam alanı üzerinden manuel olarak alabilirsiniz.
ga(function(tracker) {
var linkerParam = tracker.get('linkerParam');
});
Bir siteyi bağlayıcı parametrelerini kabul edecek şekilde yapılandırma
Bir kullanıcı, hedef alanda, URL'sinde bağlayıcı parametresi olan bir sayfaya ulaştığında, analytics.js'nin bu parametreyi aramayı bilmesi gerekir.
İzleyiciyi oluştururken allowLinker alanını true değerine ayarlayarak hedef sayfaya bağlayıcı parametrelerini aramasını söyleyebilirsiniz:
ga('create', 'UA-XXXXXX-X', 'auto', {
allowLinker: true
});
Web alanları arası çift yönlü ölçüm
Kullanıcıların her zaman kaynak alanda başladığı ve daha sonra tek yönlü web alanları arası ölçüm olarak kabul edilen hedef alan adına geçtiği bir kullanıcı işlemleri akışı. Yukarıdaki talimatlarda bu tür bir kullanıcı işlemleri akışı varsayılmaktadır.
Kullanıcılarınızın ilk olarak hangi alan adını ziyaret edeceğinin bilinmediği durumlarda, her alanın kaynak veya hedef olarak çalışacak şekilde yapılandırıldığı iki yönlü web alanları arası ölçüm uygulamanız gerekir.
İki yönlü web alanları arası ölçüm uygulamak için her iki alanda da otomatik bağlantıyı etkinleştirin ve her ikisini de bağlayıcı parametrelerini kabul edecek şekilde yapılandırın.
source.com tarihinde:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['destination.com']);
destination.com tarihinde:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com']);
Tüm alanlarda tek bir snippet kullanma
Bunu daha da basitleştirmek için autoLink yönteminde ölçmek istediğiniz tüm olası alanları listeleyerek her alanda aynı kod snippet'ini kullanabilirsiniz:
ga('create', 'UA-XXXXX-Y', 'auto', {allowLinker: true});
ga('require', 'linker');
ga('linker:autoLink', ['source.com', 'destination.com']);