Hata ayıklama

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ü nasıl kullanacağınız 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ünü sağlar. Bu mesajlar arasında, başarıyla yürütülen komutların yanı sıra etiketinizin yanlış ayarlandığını söyleyebilen uyarılar ve hata mesajları bulunur. Ayrıca, Google Analytics'e gönderilen her isabetin dökümünü de sağlar. Böylece, tam olarak hangi verilerin yakalandığını görebilirsiniz.

JavaScript etiketindeki https://www.google-analytics.com/analytics.js URL'sini 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 hata ayıklama olmayan sürümde olduğu gibi 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 ayrıntılı bilgi sağlanır.

İ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 olan 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ştirebilen bir Chrome uzantısı da sağlar. Bu sayede kendi sitelerinizde hata ayıklayabilir ve diğer sitelerin analytics.js ile Google Analytics'i 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 ve test etmek, ayrıca kodunuzu üretime 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 etkileşimlerin tam bir raporunu sunar. Herhangi bir sorun veya potansiyel iyileştirme tespit ederse size haber verir.

Daha fazla bilgi edinmek için yardım merkezini ziyaret edip Tag Assistant hakkında ve Tag Assistant Kayıtları hakkında başlıklı makaleleri okuyun. Ayrıca, Tag Assistant'ın hataları yakalamak ve web alanları arası ölçüm gibi gelişmiş uygulamaların geçerliliğini kontrol etmek için kullanımını gösteren bu demo videosunu da izleyebilirsiniz.