Eklentiler, kullanıcı etkileşimlerini ölçmeye yardımcı olmak için analytics.js'nin işlevlerini iyileştiren komut dosyalarıdır. Eklentiler genellikle e-ticaret veya web alanları arası ölçüm gibi tüm Google Analytics kullanıcıları için gerekli olmayabilecek bir dizi özelliğe özgüdür ve bu nedenle, varsayılan olarak analytics.js'ye dahil edilmez.
Bu kılavuzda, analytics.js eklentilerinin nasıl zorunlu tutulacağı ve kullanılacağı açıklanmaktadır.
Eklentileri zorunlu kılma
require komutu, bir eklentinin adını alır ve ga() komut kuyruğuyla kullanılmak üzere kaydeder. Eklenti yapılandırma seçeneklerini kabul ederse bu seçenekler require komutuna son bağımsız değişken olarak aktarılabilir.
Aşağıda tam require komutunun imzası bulunmaktadır:
ga('[trackerName.]require', pluginName, [pluginOptions]);
Örneğin, Geliştirilmiş E-ticaret eklentisini varsayılan izleyiciyle kullanmak için nasıl isteyeceğiniz aşağıda açıklanmıştır:
ga('require', 'ec');
Aşağıda, "MyTracker&" olarak adlandırılan bir izleyici için Reklamcılık Özellikleri eklentisinin nasıl isteneceği ve varsayılan çerez adı değerini geçersiz kılan bir yapılandırma seçeneğinin nasıl iletileceği açıklanmıştır:
ga('myTracker.require', 'displayfeatures', {
cookieName: 'display_features_cookie'
});
Eklenti kodu yükleniyor
require komutu, ga() komut kuyruğuyla kullanılacak eklenti yöntemlerini başlatır ancak eklenti komut dosyasının kendisini yüklemez. Üçüncü taraf bir eklenti kullanıyorsanız veya kendiniz bir yazım yazmak istiyorsanız eklenti kodunu sayfaya manuel olarak eklemeniz gerekir.
Sayfaya eklenti kodu eklemek için önerilen yöntem, sitenizdeki diğer özelliklerin yüklenmesini engellememesi için async özelliği ayarlanmış bir <script> etiketidir.
Aşağıdaki kod, varsayıma dayalı bağlantı izleme eklentisi gerektirir ve yükler:
<script>
ga('create', 'UA-XXXXX-Y', 'auto');
ga('require', 'linkTracker');
ga('send', 'pageview');
</script>
<!--Note: plugin scripts must be included after the tracking snippet. -->
<script async src="/path/to/link-tracker-plugin.js"></script>
Eklentilerin yüklenmesi bekleniyor
Hem analytics.js kitaplığı hem de analytics.js eklentileri eşzamansız olarak yüklendiğinden, eklentilerin tam olarak ne zaman yüklendiğini ve kullanıma hazır olduğunu bilmek zor olabilir.
analytics.js kitaplığı, henüz yüklenmemiş bir eklenti için require komutuyla karşılaştığında komut sırasının çalıştırılmasını durdurarak bu sorunu çözer. Eklenti yüklendikten sonra, sıra çalıştırma her zamanki gibi devam eder.
Bu nedenle, doğru şekilde yüklenip çalıştıklarından emin olmak için kullandığınız eklentileri test etmeniz son derece önemlidir. Bir eklenti yüklenemezse veya hata oluşursa sonraki tüm analytics.js komutlarının çalıştırılması engellenir.
Eklenti yöntemlerini çağırma
Eklenti istendikten sonra, yöntemleri ga() komut kuyruğuyla kullanılabilir hale gelir. Eklenti yöntemlerini çağırmak için komut imzasını aşağıda bulabilirsiniz:
ga('[trackerName.][pluginName:]methodName', ...args);
Örneğin, Geliştirilmiş E-ticaret eklentisi addProduct yöntemi şu şekilde çağrılabilir:
ga('ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Alternatif olarak, izleyici adını komut dizesine ekleyerek adlandırılmış bir izleyicide:
ga('myTracker.ec:addProduct', {
'id': 'P12345',
'quantity': 1
});
Sonraki adımlar
Bu bölümdeki tüm kılavuzları okuduysanız, analytics.js özelliklerinin çoğu hakkında bilgi sahibi olmanız gerekir. Bir sonraki kılavuzda, hataları daha kolay tespit etmek ve kodunuzun tam olarak ne yaptığını görmek için analytics.js uygulamalarınızda hata ayıklamanız açıklanmaktadır.