Bu kılavuzda, uygulamalarınızın doğru çalıştığından emin olmak için analytics.js kitaplığının hata ayıklama sürümünün nasıl kullanılacağı açıklanmaktadır.
analytics.js kitaplığının hata ayıklama sürümü
Google Analytics, analytics.js kitaplığının, çalışırken ayrıntılı mesajları JavaScript konsoluna kaydeden bir hata ayıklama sürümü sağlar. Bu mesajlar, başarıyla yürütülen komutların yanı sıra, etiketinizin yanlış ayarlandığını size söyleyen uyarılar ve hata mesajları içerir. Ayrıca, tam olarak hangi verilerin yakalandığını görebilmeniz için Google Analytics'e gönderilen her isabetin dökümünü de sağlar.
JavaScript etiketindeki https://www.google-analytics.com/analytics.js olan URL'yi https://www.google-analytics.com/analytics_debug.js olarak değiştirerek analytics.js'nin hata ayıklama sürümünü etkinleştirebilirsiniz:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Uygulamanızı isabet göndermeden test etme
analytics.js'nin hata ayıklama sürümü, verileri Google Analytics'e aynen hata ayıklama olmayan sürümle aynı şekilde gönderir. Böylece analytics.js kodunu çalıştıran bir web sitesini ziyaret edebilir ve verilerin yakalanma şeklini etkilemeden uygulamayı inceleyebilirsiniz.
Belirli durumlarda (ör.geliştirme veya test ortamları) Google Analytics'e veri göndermek istemiyorsanız sendHitTask görevini devre dışı bırakabilirsiniz. Bu durumda hiçbir şey gönderilmez.
localhost'ta çalışırken, aşağıdaki kod isabetlerin Google Analytics'e gönderilmesini engeller:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
ga('create', 'UA-XXXXX-Y', 'auto');
if (location.hostname == 'localhost') {
ga('set', 'sendHitTask', null);
}
ga('send', 'pageview');
İz hata ayıklama
İzlemede hata ayıklama etkinleştirildiğinde, konsolda daha fazla ayrıntılı bilgi görüntülenir.
İzde hata ayıklamayı etkinleştirmek için analytics.js'nin hata ayıklama sürümünü yukarıda açıklandığı gibi yükleyin ve ga() komut kuyruğuna yapılan tüm çağrılardan önce aşağıdaki JavaScript satırını ekleyin.
window.ga_debug = {trace: true};
İzlemede hata ayıklama etkin halde tam etiket aşağıdaki gibidir:
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');
window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');
Google Analytics Debugger Chrome uzantısı
Google Analytics, etiketinizi değiştirmenize gerek kalmadan analytics.js'nin hata ayıklama sürümünü etkinleştirebilecek bir Chrome uzantısı da sağlar. Bu sayede kendi sitelerinizde hata ayıklayabilirsiniz. Ayrıca, diğer sitelerin Google Analytics'i analytics.js ile nasıl uyguladığını görebilirsiniz.
Google Tag Assistant
Google Tag Assistant, web sitenizdeki etiketi doğrulamanıza ve sık karşılaşılan sorunları gidermenize yardımcı olan bir Chrome Uzantısıdır. Analytics.js uygulamalarınızı yerel olarak hata ayıklamak, test etmek ve kodunuzu üretim kanalına dağıtmadan önce her şeyin doğru olduğundan emin olmak için ideal bir araçtır.
Tag Assistant, tipik bir kullanıcı işlemleri akışını kaydetmenizi sağlayarak çalışır. Gönderdiğiniz tüm isabetleri toplar, bunlarda sorun olup olmadığını kontrol eder ve size etkileşimlerin tam bir raporunu sunar. Herhangi bir sorun veya potansiyel iyileştirme tespit ederse sizi bilgilendirir.
Daha fazla bilgi edinmek için yardım merkezini ziyaret edip Tag Assistant hakkında ve Tag Assistant Recordings hakkında başlıklı makaleleri okuyun. Hataları yakalamak ve gelişmiş uygulamaların geçerliliğini kontrol etmek için (ör. web alanları arası ölçüm) Tag Assistant'ın nasıl kullanıldığını gösteren bu demo videosunu da izleyebilirsiniz.