Hata ayıklama

Bu kılavuzda, uygulamalarınızın düzgün ç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, ayrıntılı iletileri JavaScript konsoluna günlüğe çalışırken kaydettiği bir hata ayıklama sürümünü sunar. Bu iletiler, başarıyla yürütülen komutların yanı sıra, etiketinizin yanlış ayarlandığını size bildiren uyarılar ve hata mesajlarını içerir. Ayrıca, Google Analytics'e gönderilen her isabetin bir dökümünü de sunar. Böylece, tam olarak hangi verilerin yakalandığını görebilirsiniz.

JavaScript etiketindeki URL'yi https://www.google-analytics.com/analytics.js yerine https://www.google-analytics.com/analytics_debug.js olarak 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');

Not: analytics.js'nin hata ayıklama sürümü, yalnızca geliştirme ve test sırasında kullanılmalıdır. Çünkü bu sürüm, analytics.js'den oldukça büyüktür ve sayfanızın yüklenmesini yavaşlatır.

İsabet göndermeden uygulamanızı test etme

analytics.js'nin hata ayıklama sürümü, verileri Google Analytics'e tam olarak hata ayıklama yapmayan sürüm gibi gönderir. Bu, analytics.js kodunu çalıştıran bir web sitesini ziyaret etmenize ve verilerin yakalanma şekline müdahale etmeden uygulamayı incelemenize olanak tanır.

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ıklaması

İz hatalarını ayıklama etkinleştirildiğinde konsola daha ayrıntılı bilgiler sunulur.

İ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 sırasına yapılan çağrılardan önce aşağıdaki JavaScript satırını ekleyin.

window.ga_debug = {trace: true};

İzde 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 Hata Ayıklayıcısı 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, kendi sitelerinizdeki hataları ayıklamanıza ve diğer sitelerin Google Analytics'i analytics.js ile nasıl uyguladığına bakmanıza olanak sağlar.

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ın yerel olarak test edilmesini ve test edilmesini sağlamak ve kodunuzu üretime dağıtmadan önce her şeyin doğru olmasını sağlamak için ideal bir araçtır.

Tag Assistant, normal bir kullanıcı akışını kaydetmenize izin vererek çalışır. Gönderdiğiniz tüm isabetleri toplar, sorunları kontrol eder ve etkileşimler hakkında size kapsamlı bir rapor sunar. Herhangi bir sorun veya iyileştirme belirlerse bunu size bildirir.

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