Rozwiązywanie problemów z kodem śledzenia

Jeśli chcesz rozwiązać problemy ze śledzeniem Google Analytics, najpierw upewnij się, że podstawowa konfiguracja jest prawidłowa zgodnie z opisem w sekcji Weryfikowanie konfiguracji w Centrum pomocy.

Rozwiązywanie problemów ze śledzeniem Analytics koncentruje się na dwóch kluczowych kwestiach:

  1. Składnia błędów i typowych literówek w kodzie śledzenia (np. odstępy, dostosowania napisane w nieprawidłowy sposób, niepoprawne nazwy parametrów)
  2. Brak danych w raportach

W dalszej części tego dokumentu opisujemy, jak korzystać z narzędzi do rozwiązywania problemów, które pomogą im zidentyfikować i rozwiązać te 2 podstawowe problemy.

Typowe błędy w kodzie śledzenia

Niezależnie od tego, czy używasz składni asynchronicznej czy tradycyjnej, pamiętaj o poniższych kwestiach, które pozwolą uniknąć najczęstszych błędów przy dostosowywaniu lub dostosowywaniu kodu śledzenia. Aby dowiedzieć się, jak łatwo sprawdzić te błędy, przeczytaj artykuł Debugowanie za pomocą pliku ga_debug.js.

  • W nazwach metod jest rozróżniana wielkość liter.
    Pamiętaj, że w metodach rozróżniana jest wielkość liter. Jeśli używasz nazwy metody bez odpowiedniej wielkości liter, wywołania metody nie będą działać. Przykłady:
      _gaq.push(['_trackpageview']);   // wrong
      _gaq.push(['_trackPageView']);   // wrong
      _gaq.push(['_trackPageview']);   // correct
  • Nieprawidłowe nazwy metod.
    Jeśli śledzenie nie działa prawidłowo, sprawdź, czy używasz prawidłowej nazwy metody. Przykłady:
      _gaq.push(['_setDomain', 'example.com']);       // wrong
      _gaq.push(['_setDomainName', 'example.com']);   // correct
  • Przekazywanie wartości niebędącej ciągiem znaków w cudzysłowie.
    Podawaj w cudzysłowach tylko ciągi tekstowe. Pozostałe typy należy pozostawić bez cudzysłowu.
    Wszystkie wartości, które nie są ciągiem znaków, takie jak wartości logiczne, literały obiektów, funkcje czy tablice, należy przekazywać bez cudzysłowu. Jeśli przekazujesz coś, co ma być interpretowane jako ciąg znaków, używaj tylko cudzysłowów. Jeśli przenosisz dane ze składni tradycyjnej, wszystkie parametry funkcji przekazane bez cudzysłowu powinny pozostać bez cudzysłowów w składni asynchronicznej. Przykłady:
      _gaq.push(['_setAllowLinker', 'false']);    // wrong
      _gaq.push(['_setAllowLinker', false]);      // correct
  • Ciągi znaków zawierają spacje na początku lub na końcu.
    Przykłady:
      _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
      _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

Powrót do góry

Typowe problemy z danymi w raportach

Jeśli w Twoich raportach brakuje danych, przeczytaj tę sekcję, aby poznać najczęstsze błędy i zalecane działania.

Zmiana kodu śledzenia lub nie wykryto konfiguracji

Gdy instalujesz kod śledzenia po raz pierwszy na stronie lub dodajesz dodatkowe funkcje kodu (np. e-commerce), możesz łatwo sprawdzić, czy żądanie strony jest prawidłowo skonfigurowane, sprawdzając te elementy:

  • Strona wysyła żądanie JavaScriptu ga.js
  • Strona prosi o __utm.gif
  • Zmienne utmac i utmcc są wysyłane w żądaniu __utm.gif
  • W przypadku dodatkowych danych, które zamierzasz przesłać, dostępne są wszystkie istotne parametry śledzenia (zobacz poniżej listę parametrów żądania GIF).

Jeśli wszystkie te elementy są wysyłane prawidłowo, dane powinny pojawić się w raportach najpóźniej w ciągu 24 godzin. Aby jednak sprawdzić, czy dane pojawią się szybciej, możesz zmienić zakres dat w raportach na „Dzisiaj”.

Powrót do góry

Strona lub zdarzenie nie pojawia się w raportach

Jeśli strona zawierająca kod śledzenia nie pojawia się w raportach dotyczących treści, sprawdź następujące kwestie:

  • Czy szukasz właściwej strony?
  • Google Analytics wykorzystuje wartość parametru utmp jako żądania strony, więc jeśli adres URL Twojej strony to /test/myPage.html, sprawdź, czy w raportach dotyczących treści wyszukujesz plik myPage.html. Sprawdź wartość parametru utmp, by zobaczyć, jakie żądanie strony jest wysyłane.
  • Czy szukasz właściwego wydarzenia?
  • Google Analytics korzysta z wartości parametru utme do śledzenia zdarzeń w postaci 5(object*action*label)(value):
    • 5 to stała
    • obiekt i działanie są wymagane
    • etykieta i wartość to opcje
    Więcej informacji znajdziesz w dokumentacji zdarzenia śledzenia.
  • Czy śledzisz więcej niż 50 000 niepowtarzalnych adresów URL lub stron wirtualnych dziennie?
  • Google Analytics zbiera wszystkie dane wysyłane z witryny i generuje raporty dotyczące 50 tys. najlepszych stron (posortowanych według odsłon) dziennie. Wszystkie pozostałe strony są zbierane w oddzielnej sekcji oznaczonej jako (inne) w raportach dotyczących treści. Aby wyświetlić szczegółowe informacje z raportów dotyczące wyświetleń stron o mniejszym natężeniu ruchu, możesz skonfigurować nowy widok (profil) z filtrem, który usuwa wszystkie wyświetlenia strony o większym natężeniu ruchu. W efekcie pozostałe strony mogą zostać zaliczone do 50 000 adresów URL o największym ruchu.
  • Sprawdź, czy korzystasz z właściwego konta i widoku (profilu) w interfejsie raportowania.
  • Google Analytics rozróżnia różne konta według identyfikatorów domen, które mają postać UA-123456-1. Ten identyfikator domeny jest wstawiany do kodu śledzenia, co oznacza, że dane ze strony są kojarzone z danym kontem. Upewnij się, że konto i widok (profil), które widzisz (Ustawienia Analytics -> edytuj -> sprawdź stan), mają ten sam identyfikator domeny co identyfikator domeny wysyłanej w parametrze utmac w żądaniu GIF.

Powrót do góry

Problemy ze śledzeniem kampanii

Aby śledzić kampanię reklamową w Google Analytics, linki reklamowe prowadzące do Twojej witryny muszą mieć dołączone parametry śledzenia. Następnie kod GATC wykorzystuje kombinację parametrów adresu URL strony i odesłania, aby zidentyfikować wysyłaną kampanię. Informacje te są następnie przechowywane w pliku cookie Twojej witryny i wysyłane w parametrze utmcc żądania GIF. W wielu przypadkach przekierowania adresów URL witryn usuwają z tych linków parametry śledzenia lub dane dotyczące odesłań, co prowadzi do generowania nieprawidłowych raportów kampanii.

Aby sprawdzić, czy przekierowania powodują problemy ze śledzeniem kampanii, kliknij witrynę odsyłającą lub otagowany link kierujący do Twojej witryny i odszukaj odpowiednie dane kampanii w parametrze utmcc. Więcej informacji o znajdowaniu i odczytywaniu parametru utmcc znajdziesz w artykułach Parametry żądania GIF i Debugowanie z użyciem ga_debug.js.

Nieprawidłowe przypisanie celu (konwersji)

Konwersja to cel powiązany z konkretną kampanią. Aby upewnić się, że cel jest prawidłowo powiązany z daną kampanią lub odesłaniem:

  1. Kliknięcie odesłania do Twojej witryny spowoduje utworzenie plików cookie kampanii.
  2. Przejdź w witrynie do strony konwersji lub celu.
  3. Sprawdź dane wysyłane w parametrze utmcc, aby upewnić się, że plik cookie kampanii jest utrzymywany.

Gdy kod śledzenia przechwyci wszystkie informacje o kampanii, jest przechowywany w pliku cookie, który utrzymuje się użytkownika przez wiele sesji. Informacje o kampanii są wysyłane w żądaniu GIF do każdej strony, która wykonuje funkcje śledzenia. Dlatego z każdym wyświetleniem strony są powiązane dane kampanii lub odesłań. Jeśli 1 z tych odsłon jest skonfigurowany jako cel, powiązana kampania „Wyświetlenie strony” jest z nim powiązana. Więcej informacji o znajdowaniu i odczytywaniu parametru utmcc znajdziesz w artykułach Parametry żądania GIF i Debugowanie z użyciem ga_debug.js.

Powrót do góry

Podstawowe kroki debugowania

Za każdym razem, gdy kod śledzenia Google Analytics jest uruchamiany, wysyła z serwerów zbierających dane w Google Analytics żądanie o jednego piksela obrazu GIF o nazwie __utm.gif.Do ciągu żądania dotyczącego obrazu dołączone są wszystkie parametry przechwytywane przez Google dotyczące konkretnego żądania strony, m.in.:

  • Informacje o odsłonie strony pod adresem URL
  • Informacje o kampanii
  • Dane transakcji e-commerce
  • Właściwości przeglądarki
  • Identyfikatory klientów

Dane zawarte w żądaniu GIF odpowiadają dokładnie danym wysłanym na serwery Google Analytics, które następnie są przetwarzane i trafiają do raportów. Dzięki wyświetlaniu danych wysłanych w żądaniu __utm.gif możesz określić, czy kod śledzenia działa, a co ważniejsze, czy wysyła do Twoich raportów nieprawidłowe dane.

Aby debugować kod śledzenia, wykonaj te podstawowe czynności:

  1. Za pomocą zewnętrznego narzędzia do debugowania możesz sprawdzić żądanie GIF wysyłane do Google Analytics, klikając odpowiedni link w swojej witrynie.
  2. Sprawdź, czy kod śledzenia nie zawiera żadnych typowych błędów w kodzie śledzenia.
  3. Upewnij się, że jest obecny parametr utmp.
  4. Sprawdź, czy parametr utmcc jest obecny i nie jest pusty.
    W przypadku pustego parametru utmcc dane z plików cookie nie są wysyłane, a żądanie jest ignorowane.
  5. Powtórz test kilka razy, aby mieć pewność, że żądanie GIF zostanie wysłane za każdym razem.

Powrót do góry

Narzędzia do debugowania

Do adresu URL żądania GIF jest dołączone kilka parametrów nazwy/wartości. Zamiast oglądać ten ciąg znaków w całości, możesz skorzystać z bezpłatnego narzędzia, aby wyświetlić żądanie GIF w czytelniejszej formie. W poniższej tabeli podano szereg narzędzi do stosowania w najpopularniejszych przeglądarkach.

Dla Twojej wygody opracowaliśmy narzędzie Google Analytics Tracking Code Debugger, które pomaga rozwiązywać problemy z kodem śledzenia bez konieczności wprowadzania zmian w kodzie. Wystarczy, że włączysz to rozszerzenie, a możesz sprawdzić, czy na stronach produkcyjnych nie ma błędów. Więcej informacji o ga_debug.js.

Przeglądający Narzędzie
Wszystko Firebug Lite
Chrome Google Analytics Tracking Code Debugger Nowość
Chrome Wbudowane narzędzia dla programistów (np. zasoby)
Firefox Aktywne nagłówki HTTP
Firefox Firebug
Firefox Karol
Internet Explorer Skrzypce
Internet Explorer Karol
Safari Wbudowane okno Aktywność
Safari Karol

Po zainstalowaniu i skonfigurowaniu narzędzia możesz otworzyć stronę internetową, na której występuje problem, i wyświetlić w nim analizę GIF-ów. Najpierw musisz się upewnić, że strona, której dotyczy zgłoszenie, faktycznie wysyła żądanie __utm.gif. Dopóki widzisz żądanie, możesz mieć pewność, że serwery Google Analytics zbierają dane z tej strony. W pozostałej części tej sekcji znajdziesz podstawowe instrukcje korzystania z nagłówka Live HTTP Header i Firebuga, które pomogą Ci zorientować się, jak łatwo jest korzystać z wbudowanych narzędzi lub dodatków w przeglądarce.

Korzystanie z nagłówków HTTP w transmisji na żywo

  1. Pobierz i zainstaluj rozszerzenie LiveHTTPHeaders w przeglądarce Firefox. Uruchom ponownie przeglądarkę.
  2. Otwórz nagłówki HTTP Live (Narzędzia > LiveHTTPHeaders).
  3. Kliknij kartę Generator.
  4. Przejdź do swojej witryny (lub dowolnej strony, na której jest zainstalowany kod śledzenia Google Analytics).
  5. Sprawdź, czy żądanie dotyczy adresu urchin.js lub ga.js
  6. Sprawdź, czy wysłano żądanie dotyczące konta __utm.gif.

Korzystanie z narzędzia Firebug

Rozszerzenie Firebug zapewnia bardziej uporządkowany widok zarówno żądania kodu śledzenia (urchin.js lub ga.js), jak i żądania GIF (__utm.gif).  Poniżej znajdziesz instrukcje, jak za pomocą narzędzia Firebug wyświetlić szczegóły żądania GIF.

  1. Pobierz i zainstaluj Firebug do Firefoksa, a potem ponownie uruchom przeglądarkę.
  2. Otwórz swoją witrynę.
  3. W Firefoksie wybierz Narzędzia > Firebug > Otwórz Firebug > „Włącz Firebug dla tej witryny”.
  4. Kliknij kolejno Sieć i Obrazy.
  5. Załaduj ponownie stronę i sprawdź, czy na liście pojawi się nowe żądanie pliku __utm.gif.
  6. Sprawdź komponenty żądania na karcie Parametry.

Powrót do góry

Debugowanie za pomocą pliku ga_debug.js

Oprócz standardowej wersji ga.js zespół Analytics wdrożył alternatywną wersję kodu JavaScript Google Analytics o nazwie ga_debug.js. Ten skrypt pomaga użytkownikom Analytics rozwiązywać problemy z instalacjami. Jest to szczególnie przydatne, jeśli dopiero zaczynasz korzystać z Analytics lub przenosisz witrynę na nową składnię asynchroniczną.

Skrypt zawiera szczegółowe informacje o każdym żądaniu GIF. Rejestruje też ostrzeżenia i komunikaty o błędach, gdy wykryje problemy z kodem śledzenia. Aby to zrobić, drukujesz wiadomości w obiekcie window.console. Następnie możesz wyświetlić te błędy za pomocą jednego z tych narzędzi:

  • Firebug (przeglądarka Firefox)
  • Wbudowane narzędzia w Chrome i Safari
  • Firebug Lite (dla innych przeglądarek)

Aby użyć skryptu ga_debug.js, możesz zmodyfikować odniesienie kodu śledzenia do strony internetowej, do której masz dostęp i którą możesz edytować. Aby to zrobić, zastąp wszystkie odniesienia do /ga.js ciągiem /u/ga_debug.js w kodzie śledzenia tej strony. Jeśli używasz skryptu debugowania w przypadku dużej witryny, używaj go tylko w środowisku testowym. Jeśli debugujesz mniejszą witrynę, zalecamy również testowanie w ten sposób tylko wybranych stron zamiast całej witryny.

Ważne: nie modyfikuj witryny produkcyjnej, aby korzystała z tej wersji JavaScriptu. Skrypt ga_debug.js jest większy niż kod śledzenia ga.js i zwykle nie jest zapisywany w pamięci podręcznej. Dlatego użycie go w witrynie produkcyjnej spowalnia działanie witryny u wszystkich użytkowników. Przypominamy, że te informacje służą wyłącznie do celów testowych.

Jeśli do śledzenia witryn używasz Universal Analytics (analytics.js), możesz włączyć analytics_debug.js – wersję do debugowania kodu analytics.js, aby rozwiązywać problemy z kodem śledzenia. Więcej informacji o analytics_debug.js znajdziesz w sekcji Debugowanie.

Korzystanie z Debugera kodu śledzenia Google Analytics

Google Analytics Tracking Code Debugger to rozszerzenie do przeglądarki Chrome, które włącza ga_debug.js bez konieczności wprowadzania zmian w kodzie. Prawdopodobnie najprostszym sposobem korzystania z funkcji ga_debug.js jest rozwiązywanie problemów i analizowanie działania śledzenia witryny. Wystarczy, że włączysz to rozszerzenie, a możesz sprawdzić, czy na stronach produkcyjnych nie ma błędów bez konieczności modyfikowania odniesień do śledzenia w samym kodzie.

Aby korzystać z tego rozszerzenia, włącz je, klikając jego ikonę z prawej strony paska adresu. Następnie otwórz konsolę JavaScriptu w Chrome, aby wyświetlić komunikaty w konsoli.

  • W systemach Windows i Linux kliknij [Page icon] -> Programista -> Konsola JavaScript lub naciśnij Control+Shift-J.
  • W systemie Mac kliknij Widok -> Programista -> Konsola JavaScript lub naciśnij Command-Option-J.

Powrót do góry

Parametry żądania GIF

Żądanie GIF jest dość długie. Oto przykład tylko części żądania GIF:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...   

Ta tabela zawiera listę wielu parametrów przekazanych w żądaniu GIF. Nie wszystkie parametry są przekazywane przy każdym wykonaniu kodu śledzenia, ponieważ niektóre z nich mają zastosowanie tylko do określonych warunków, takich jak skierowania do kampanii lub koszyk na zakupy. Korzystając z tego odniesienia, pamiętaj, że szukasz zmiennych, które najczęściej mają zastosowanie do analizowanej strony lub żądania.

Zmienna Opis Przykładowa wartość
utmac Ciąg tekstowy konta. Pojawia się we wszystkich żądaniach. utmac=UA-2202604-2
utmcc
Wartości plików cookie. Ten parametr żądania wysyła wszystkie pliki cookie żądane ze strony.
utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(odesłanie)%7C utmcmd%3D(odesłanie)%7C
utmcn Rozpoczyna nową sesję kampanii. W każdym żądaniu jest podawany kod utmcn lub utmcr. Zmienia dane śledzenia kampanii, ale nie rozpoczyna nowej sesji
utmcn=1
utmcr
Oznacza powtórną wizytę w ramach kampanii. Wartość ta jest ustawiana, gdy ten sam link zostanie kliknięty później. W każdym żądaniu jest podawany kod utmcn lub utmcr.
utmcr=1
plik UTM
Kodowanie języka w przeglądarce. Niektóre przeglądarki tego nie ustawiają. W takim przypadku ma wartość „-”
utmcs=ISO-8859-1
utmdt
Tytuł strony, który jest ciągiem zakodowanym w adresie URL. utmdt=analytics%20strona%20test
utme Parametr rozszerzalny Wartość jest zakodowana. Używane w przypadku zdarzeń i zmiennych niestandardowych.
utmfl
Wersja Flash utmfl=9.0%20r48&
utmhn

Nazwa hosta, która jest ciągiem zakodowanym w adresie URL. utmhn=x343.gmodules.com
utmhid

Losowa liczba używana do łączenia żądań GIF Analytics z Google AdSense. utmhid=2059107202
utmipc
Kod produktu. To jest kod SKU danego produktu.

utmipc=989898ajssi
utmipn
Nazwa produktu, która jest ciągiem zakodowanym na potrzeby adresu URL. utmipn=koszula%20koszula
utmipr
Cena za sztukę. Ustawiono na poziomie elementu. Wartość jest ustawiona wyłącznie na liczby w formacie waluty amerykańskiej.
utmipr=17100,32
utmiqt
Ilość. utmiqt=4
utmiva
Odmiany elementu. Na przykład: duży, średni, mały, różowy, biały, czarny, zielony. Ciąg jest zakodowany na potrzeby adresu URL.
utmiva=red;
utmje
Wskazuje, czy przeglądarka obsługuje język Java. 1 to prawda. utmje=1
utmn
Unikalny identyfikator generowany dla każdego żądania GIF, aby zapobiec zapisywaniu obrazu GIF w pamięci podręcznej. utmn=1142651215
utmp:
Żądanie strony bieżącej strony. utmp=/testDirectory/myPage.html
utmr
Odesłanie, pełny adres URL. utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc
Głębia kolorów ekranu utmsc=24-bitowy
utmsr
Rozdzielczość ekranu. utmsr=2400x1920
utmt
Wskazuje typ żądania, do którego należą: zdarzenie, transakcja, produkt lub zmienna niestandardowa. Jeśli żądanie GIF nie zawiera tej wartości, ma postać page. utmt=zdarzenie
utmtci
Miasto do płatności utmtci=San%20Diego
utmtco
Kraj rozliczenia utmtco=Zjednoczone%20Królestwo
utmtid
Identyfikator zamówienia, ciąg zakodowany w adresie URL. utmtid=a2343898
utmtrg
Region rozliczeniowy, ciąg zakodowany w adresie URL. utmtrg=Nowość%20Brunswick
utmtsp
Koszt dostawy. Wartości takie jak jednostka i cena. utmtsp=23,95
utmtst
Powiązanie. Model zwykle używany w stacjonarnych e-commerce. utmtst=google%20mtv%20sklep
utmtto
Suma. Wartości takie jak jednostka i cena. utmtto=334,56
utmttx
Podatek. Wartości takie jak jednostka i cena. utmttx=29,16
utmul
Język przeglądarki. utmul=pt-br
utmwv
Wersja kodu śledzenia utmwv=1

 

Powrót do góry