Z tego przewodnika dowiesz się, jak korzystać z wersji do debugowania biblioteki analytics.js, aby mieć pewność, że implementacje działają prawidłowo.
Wersja biblioteki analytics.js do debugowania.
Google Analytics udostępnia wersję biblioteki analytics.js do debugowania, która podczas działania rejestruje w konsoli JavaScript szczegółowe komunikaty. Te komunikaty obejmują pomyślnie wykonane polecenia, a także ostrzeżenia i komunikaty o błędach, które informują o nieprawidłowej konfiguracji tagu. Udostępnia też zestawienie każdego działania wysyłanego do Google Analytics, dzięki czemu dokładnie widać, jakie dane są rejestrowane.
Aby włączyć wersję analytics.js do debugowania, zmień adres URL w tagu JavaScript z https://www.google-analytics.com/analytics.js na https://www.google-analytics.com/analytics_debug.js:
(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');
Testowanie implementacji bez wysyłania działań
Wersja analytics.js do debugowania będzie przesyłać dane do Google Analytics dokładnie tak samo jak wersja bez debugowania. Dzięki temu możesz odwiedzić witrynę z kodem analytics.js i sprawdzić implementację bez ingerencji w sposób zbierania danych.
Jeśli w niektórych przypadkach nie chcesz wysyłać danych do Google Analytics (np.ze środowisk programistycznych lub testowych), możesz wyłączyć zadanie sendHitTask. Żadne dane nie będą wysyłane.
W przypadku uruchomienia lokalnego hosta poniższy kod zapobiegnie wysyłaniu działań do Google Analytics:
(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');
Debugowanie logu czasu
Włączenie debugowania logu czasu spowoduje wygenerowanie bardziej szczegółowych informacji do konsoli.
Aby włączyć debugowanie logu czasu, załaduj wersję analytics.js do debugowania w sposób opisany powyżej i dodaj ten wiersz kodu JavaScript przed wywołaniami w kolejce poleceń ga().
window.ga_debug = {trace: true};
Pełny tag z włączonym debugowaniem śledzenia wygląda tak:
(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');
Rozszerzenie Google Analytics Debugger do przeglądarki Chrome
Google Analytics udostępnia też rozszerzenie do Chrome, które może włączyć wersję analytics.js do debugowania bez konieczności zmiany tagu. Dzięki temu możesz debugować własne witryny i sprawdzać, jak w innych witrynach zaimplementowano Google Analytics za pomocą tagu analytics.js.
Google Tag Assistant
Google Tag Assistant to rozszerzenie do Chrome, które pomaga sprawdzać tag w witrynie i rozwiązywać typowe problemy. To idealne narzędzie do debugowania i testowania implementacji kodu analytics.js lokalnie. Przed wdrożeniem kodu w środowisku produkcyjnym możesz sprawdzić, czy wszystko jest w porządku.
Tag Assistant umożliwia rejestrowanie typowego zachowania użytkownika. Zbiera wszystkie wysyłane przez Ciebie działania, sprawdza je pod kątem problemów i generuje pełny raport interakcji. Powiadomimy Cię, jeśli wykryje problemy lub potencjalne ulepszenia.
Aby dowiedzieć się więcej, odwiedź Centrum pomocy i przeczytaj artykuły Tag Assistant oraz Informacje o Rejestratorze Tag Assistant. Możesz też obejrzeć ten film demonstracyjny, w którym pokazano korzystanie z rozszerzenia Tag Assistant do wykrywania błędów i sprawdzania poprawności implementacji zaawansowanych, takich jak pomiar w wielu domenach.