Eklentileri Kullanma

Eklentiler, kullanıcı etkileşimini ölçmeye yardımcı olmak için analytics.js'nin işlevselliğini geliştiren komut dosyalarıdır. Eklentiler genellikle ecommerce veya web alanları arası ölçüm gibi tüm Google Analytics kullanıcıları tarafından gerekli görülmeyebilecek bir dizi özelliğe özgüdür ve bu nedenle analytics.js'ye varsayılan olarak dahil edilmez.

Bu kılavuzda, analytics.js eklentilerinin nasıl zorunlu tutulacağı ve kullanılacağı açıklanmaktadır.

Eklenti gerektirme

require komutu, bir eklentinin adını alır ve eklentiyi 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 geçirilebilir.

Aşağıda require komutunun imzasının tamamı verilmiştir:

ga('[trackerName.]require', pluginName, [pluginOptions]);

Örneğin, Geliştirilmiş E-ticaret eklentisinin varsayılan izleyiciyle kullanılmasını nasıl zorunlu kılacağınız aşağıda açıklanmıştır:

ga('require', 'ec');

"myTracker" adlı bir izleyici için Reklamcılık Özellikleri eklentisini nasıl zorunlu kılacağınız ve varsayılan çerez adı değerini geçersiz kılan bir yapılandırma seçeneğini nasıl ileteceğiniz aşağıda açıklanmıştır:

ga('myTracker.require', 'displayfeatures', {
  cookieName: 'display_features_cookie'
});

Eklenti kodunu yükleme

require komutu, ga() komut sırasında kullanılacak eklenti yöntemlerini başlatır, ancak eklenti komut dosyasının kendisini yüklemez. Üçüncü taraf eklentisi kullanıyorsanız veya eklentiyi kendiniz yazıyorsanız eklenti kodunu sayfaya manuel olarak eklemeniz gerekir.

Eklenti kodunu sayfaya eklemek için önerilen yöntem, sitenizdeki diğer özelliklerin yüklenmesini engellememek için async özelliği ayarlanmış bir <script> etiketi kullanmaktır.

Aşağıdaki kod, varsayımsal bir 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>

Not: analytics.js için resmi Google Analytics eklentileri, gerektiğinde otomatik olarak yüklenir. Bu eklentiler için komut dosyası etiketleri eklemeniz gerekmez. Resmi analytics.js eklentilerinin tam listesini sol taraftaki gezinme menüsündeki Resmi eklentiler bölümünde bulabilirsiniz.

Eklentilerin yüklenmesi bekleniyor

Hem analytics.js kitaplığı hem de analytics.js eklentileri eşzamansız olarak yüklendiğinden, eklentilerin ne zaman tam olarak yüklendiğini ve kullanıma hazır olduğunu bilmek zor olabilir.

analytics.js kitaplığı, henüz yüklenmemiş bir eklenti için bir require komutuyla karşılaştığında komut sırası, yürütülmesini durdurarak bu sorunu çözer. Eklenti yüklendikten sonra sıra yürütme normal şekilde devam eder.

Sonuç olarak, kullandığınız eklentileri test ederek doğru şekilde yüklenip çalıştıklarından emin olmanız son derece önemlidir. Bir eklenti yüklenmezse veya hata verirse sonraki tüm analytics.js komutlarının yürütülmesi engellenir.

Arama eklentisi yöntemleri

Bir eklenti gerekli kılındıktan sonra, bu eklentinin yöntemleri ga() komut sırasında kullanılabilir. Eklenti yöntemlerini çağırmak için gereken komut imzası aşağıda verilmiştir:

ga('[trackerName.][pluginName:]methodName', ...args);

Örneğin, Geliştirilmiş E-ticaret eklentisinin addProduct yöntemi şu şekilde çağrılabilir:

ga('ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Alternatif olarak, adlandırılmış bir izleyicide izleyici adını komut dizesine ekleyerek:

ga('myTracker.ec:addProduct', {
  'id': 'P12345',
  'quantity': 1
});

Sonraki adımlar

Bu bölümdeki tüm kılavuzları okuduysanız, analytics.js'nin çoğu özelliği hakkında bilgi sahibisiniz demektir. 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 nasıl hata ayıklayacağınız açıklanmaktadır.