W skrócie
8 min czytaniaAplikacja jednostronicowa wczytuje jeden dokument HTML i zmienia ekrany za pomocą JavaScriptu, więc tag uruchamiany tylko przy ładowaniu strony zapisuje jedną odsłonę na całą wizytę. Śledzenie SPA rozwiązuje ten problem wirtualną odsłoną przy każdej zmianie trasy, wysyłaną na podstawie zdarzeń History API (ustawienie GA4 "Page changes based on browser history events" nasłuchuje pushState, popState i replaceState) albo ręcznych wywołań page_view. Podwójne liczenie bierze się z jednoczesnego działania dwóch takich mechanizmów, a brakujące odsłony z routerów, które nie zmieniają adresu URL, lub z odsłon wysłanych przed jego aktualizacją.
Czym jest śledzenie SPA?
W aplikacji jednostronicowej (SPA) śledzenie polega na zapisywaniu wirtualnej odsłony za każdym razem, gdy aplikacja zmienia ekran za pomocą JavaScriptu, ponieważ przeglądarka wczytuje dokument HTML tylko raz i przy kolejnych zmianach trasy nie ładuje nowej strony. Google opisuje SPA jako "websites that load an HTML document once and fetch any additional content using JavaScript APIs" i jasno określa cel: "The key to measuring page views from SPAs correctly is to count page views for each screen a user interacts with and get the page referrer right, so you can correctly trace the user journey."
Wirtualna odsłona to zdarzenie odsłony wysyłane przez narzędzie analityczne bez faktycznego załadowania strony. Przeglądarka nie pobiera nowego dokumentu, ale raport pokazuje nową stronę z własnym adresem URL i odsyłaczem, tak jakby do tego doszło.
Dlaczego standardowy tag analityczny pomija odsłony w SPA?
Standardowy tag analityczny pomija odsłony w SPA, bo wysyła odsłonę przy pierwszym uruchomieniu skryptu, a w SPA skrypt uruchamia się raz na wizytę. Odwiedzający, który wchodzi na /, a potem przez linki w aplikacji otwiera /pricing i /signup, przechodzi przez trzy ekrany, podczas gdy tag działający tylko przy ładowaniu zapisuje jedną odsłonę dla /.
Szkody nie kończą się na liczbie odsłon. Google zaznacza, że bez wirtualnych odsłon "Google Analytics treats the SPA as a single page, leading to skewed metrics" oraz że "all engagement time is attributed to the initial page load, making it impossible to analyze time spent on individual screens." Kliknięcia i przewinięcia również trafiają pod adres strony wejścia. Przewodnik odsłony, sesje i użytkownicy wyjaśnia, dlaczego niska liczba odsłon na sesję w SPA jest najpierw sygnałem o śledzeniu, a dopiero potem o zachowaniu.
![]()
Jak History API sygnalizuje zmianę trasy?
History API sygnalizuje zmianę trasy przez metody wywoływane przez router i zdarzenia wysyłane przez przeglądarkę, a jedne nie odpowiadają drugim jeden do jednego. Z powodu tej rozbieżności narzędzia śledzące muszą nasłuchiwać w kilku miejscach.
| Zmiana | Co ją wywołuje | Zdarzenie przeglądarki |
|---|---|---|
history.pushState() | Twój router, po kliknięciu linku w aplikacji | Brak |
history.replaceState() | Twój router, gdy nadpisuje bieżący adres URL | Brak |
| Przycisk wstecz lub dalej | Odwiedzający | popstate |
history.back(), forward(), go() | Twój kod | popstate |
Zmiana fragmentu (#section) | Link lub kod zmieniający fragment | hashchange |
MDN wyraża się jasno co do dwóch pierwszych wierszy: "just calling history.pushState() or history.replaceState() won't trigger a popstate event." Narzędzie nasłuchujące tylko popstate widzi kliknięcia wstecz i dalej, ale pomija każde przejście przez twoje własne linki. Dlatego narzędzia śledzące opakowują lub obserwują bezpośrednio pushState i replaceState.
Jak GA4 śledzi aplikacje jednostronicowe?
GA4 śledzi aplikacje jednostronicowe dzięki ustawieniu pomiaru zaawansowanego, które wysyła page_view przy zmianie historii przeglądarki. Centrum pomocy Google opisuje wyzwalacz page_view jako "each time the page loads or the browser history state is changed by the active site" i podaje, że ustawienie zaawansowane "listens for pushState, popState, and replaceState." Google zaleca tę drogę "If your SPA uses the History API, specifically the pushState() and replaceState() method to update screens."
Aby to włączyć:
- W Google Analytics otwórz Admin.
- W sekcji Data collection and modification kliknij Data streams, a potem swój strumień internetowy.
- W sekcji Enhanced measurement włącz przełącznik.
- Kliknij ikonę ustawień, a w sekcji Page views kliknij Show advanced settings.
- Włącz Page loads oraz Page changes based on browser history events.
- Zapisz.
Druga droga jest ręczna. Google wymienia "Custom events" dla witryn, w których ekrany renderują się bez zmiany adresu URL, na przykład w aplikacji korzystającej z obiektów DocumentFragment. W takim przypadku sam wysyłasz z routera gtag('event', 'page_view', { page_title: '...', page_location: '...' }).
Co powoduje podwójne liczenie w śledzeniu SPA?
Podwójne liczenie w śledzeniu SPA pojawia się, gdy dwa mechanizmy wysyłają odsłonę dla tej samej zmiany trasy. Najczęstsze konfiguracje, które do tego prowadzą:
- Google Tag Manager razem ze zdarzeniami historii w GA4. Ostrzeżenie Google: "If you configure your tags using Google Tag Manager, don't enable automatic history tracking in Google Analytics, as this can lead to double-counting page views." Wyzwalacz History Change w GTM i tak uruchamia się "when the URL fragment changes or when a site uses the HTML5 pushstate API."
- Ręczne wywołania page_view razem z ustawieniem historii.
send_page_view: falsenie zatrzymuje odsłon opartych na historii. Google stwierdza: "If Enhanced Measurement is enabled, Google Analytics will sendpage_viewevents based on browser history changes even if you setsend_page_view: false." Wyłącz Page changes based on browser history events, gdy router wysyła własne odsłony. - replaceState używany do filtrów lub kart. GA4 wymienia replaceState wśród zmian historii, których nasłuchuje, więc lista produktów zapisująca
?sort=pricew adresie URL przezreplaceStatemoże generować odsłonę przy każdej zmianie filtra. Sprawdź to w DebugView, zanim zaufasz liczbie odsłon na ekranach z wieloma filtrami. - Dwa tagi Google z tym samym identyfikatorem. Wklejony na stałe fragment gtag i tag Google w GTM wskazujące ten sam identyfikator pomiaru wysyłają własne zdarzenia.
Co powoduje brakujące odsłony w śledzeniu SPA?
Brakujące odsłony w śledzeniu SPA wynikają ze zmian tras, które nigdy nie docierają do History API, oraz z odsłon wysyłanych w niewłaściwym momencie.
- Routery, które nie zmieniają adresu URL. Aplikacja podmieniająca komponenty w pamięci nie daje narzędziu nasłuchującemu historii niczego do wychwycenia. Użyj zdarzeń niestandardowych.
- Routing oparty na fragmencie przy śledzeniu tylko historii. Zmiana
#/pricingwywołujehashchange. Sprawdź, czy twoje narzędzie liczy zmiany fragmentu, a jeśli nie, skonfiguruj je. - Odsłony wysłane przed aktualizacją adresu URL.
page_viewuruchomione przedpushStatezapisuje starepage_location. W DebugView Google zaleca porównanie każdegopage_view"with the precedingpage_viewevent to check if the page referrer and page location have been updated correctly." - Nieaktualne odsyłacze. Przykład zdarzenia niestandardowego od Google zapamiętuje stary adres URL i przekazuje go jako
page_referrer, bodocument.referrerw przeglądarce przez całą wizytę pozostaje pierwotnym odsyłaczem wejścia.
Pokrewna pułapka leży poza routerem. web.dev zauważa, że pamięć podręczna wstecz/dalej "doesn't work for 'soft navigations' within a single-page app", więc kliknięcie wstecz wewnątrz aplikacji jest zdarzeniem historii, a kliknięcie wstecz po powrocie z innej witryny może przywrócić całą stronę z pamięci bez żadnego zdarzenia historii.
![]()
Jak sprawdzić, czy śledzenie SPA działa?
Śledzenie SPA weryfikujesz, przechodząc przez aplikację z włączonym trybem debugowania i sprawdzając, czy każdy nowy ekran daje dokładnie jedną odsłonę z właściwą lokalizacją i odsyłaczem. Google zaleca włączenie trybu debugowania, "click through your single-page application" i potwierdzenie "a new page_view event in DebugView" dla każdego wirtualnego ekranu. Następnie powtórz test z przyciskami wstecz i dalej, zmianą filtra oraz linkiem z fragmentem, bo to przypadki powodujące dublowanie lub utratę odsłon. Lista kontrolna weryfikacji analityki stosuje tę samą zasadę do każdego narzędzia, a przewodnik o średnim czasie trwania sesji pokazuje, jak wadliwe śledzenie SPA zniekształca dane o czasie w witrynie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Dwie drobniejsze poprawki pomagają utrzymać wiarygodność liczb. Przy każdej zmianie trasy zeruj pozycję przewinięcia przez window.scrollTo(0, 0), aby głębokość przewijania dotyczyła nowego ekranu, a nie starego, i wysyłaj odsłonę dopiero wtedy, gdy router zaktualizuje adres URL i tytuł.
Jak Flowsery obsługuje nawigację w SPA?
Flowsery śledzi nawigację w SPA automatycznie, więc zmiana trasy w React Router lub Next.js pojawia się jako osobna odsłona bez dodatkowego kodu. Dokumentacja SDK npm Flowsery wymienia "pageviews, including SPA navigation" wśród automatycznie śledzonych danych, a FAQ cennika stwierdza, że Flowsery "counts a pageview each time a visitor loads a page on your site, including single-page app navigations." Dla aplikacji korzystających z fragmentów adresu URL SDK npm ma opcję hashMode, a dokumentacja skryptu opisuje wersję narzędzia dla SPA z routingiem opartym na fragmencie. Jeśli twoja aplikacja zmienia ekrany bez zmiany adresu URL, SDK udostępnia trackPageview(), dzięki czemu możesz wysłać odsłonę z własnego kodu. Strona o analityce React opisuje, jak Flowsery mierzy trasy po stronie klienta, zdarzenia niestandardowe, lejki i przychody w aplikacjach React.
Najczęściej zadawane pytania
Czym jest wirtualna odsłona?
Wirtualna odsłona to zdarzenie odsłony wysyłane bez faktycznego załadowania strony, używane, gdy SPA zmienia ekrany przez JavaScript. Ma własną lokalizację i odsyłacz, więc raporty traktują każdy ekran jako osobną stronę. Bez niej wizyta w SPA wygląda jak jedno długie oglądanie strony wejścia.
Czy GA4 automatycznie śledzi zmiany tras w SPA?
Tak, jeśli pomiar zaawansowany jest włączony, a w ustawieniach zaawansowanych Page views aktywna jest opcja Page changes based on browser history events. To ustawienie nasłuchuje pushState, popState i replaceState. Nie pomaga aplikacjom, które zmieniają ekrany bez zmiany adresu URL.
Dlaczego GA4 liczy każdą odsłonę w SPA podwójnie?
Dwa mechanizmy wysyłają odsłony dla tej samej zmiany. Zwykle są to wyzwalacze historii w GTM razem ze zdarzeniami historii w GA4 albo ręczne wywołania page_view razem ze zdarzeniami historii w GA4. Wyłącz jeden z nich. Google podaje, że send_page_view: false nie zatrzymuje odsłon opartych na historii.
Czy pushState wywołuje popstate?
Nie. MDN podaje, że wywołanie history.pushState() lub history.replaceState() nie uruchamia zdarzenia popstate. Wywołują je tylko działania przeglądarki, takie jak przyciski wstecz i dalej, oraz wywołania w rodzaju history.back().
Jak powinien działać page_referrer w SPA?
Każda wirtualna odsłona powinna mieć jako odsyłacz adres poprzedniego ekranu. Zapamiętaj stary adres URL przed zmianą trasy i przekaż go jako page_referrer razem z nowym page_location. W przeciwnym razie każdy ekran będzie zgłaszał pierwotny odsyłacz wejścia.
Czy pamięć podręczna wstecz/dalej wpływa na śledzenie SPA?
Nie w przypadku nawigacji wewnątrz aplikacji. web.dev podaje, że bfcache nie działa dla miękkich nawigacji w SPA. Ma natomiast znaczenie, gdy odwiedzający opuszcza aplikację i wraca przyciskiem wstecz, co może przywrócić całą stronę z pamięci bez nowego ładowania, jeśli strona się do tego kwalifikuje.
Jak włączyć śledzenie SPA w GA4?
Otwórz Admin, kliknij Data streams, wybierz swój strumień internetowy i włącz Enhanced measurement. Następnie kliknij ikonę ustawień, otwórz Show advanced settings w sekcji Page views i włącz Page loads oraz Page changes based on browser history events. Zapisz. Ta metoda działa, gdy router używa pushState i replaceState.
Czy włączyć śledzenie historii w GA4, jeśli używam Google Tag Manager?
Zostaw je wyłączone. Google ostrzega, że używanie obu może prowadzić do podwójnego liczenia odsłon. Wyzwalacz History Change w GTM i tak uruchamia się, gdy zmienia się fragment adresu URL lub witryna korzysta z API pushstate w HTML5.
Jak śledzić trasy z fragmentem, takie jak #/pricing, w SPA?
Zmiana fragmentu wywołuje hashchange, więc narzędzie obserwujące tylko History API może ją pominąć. Sprawdź, czy twoje narzędzie liczy zmiany fragmentu, a jeśli nie, skonfiguruj je. SDK npm Flowsery ma opcję hashMode, a dokumentacja skryptu opisuje wersję narzędzia z routingiem opartym na fragmencie.
Jak sprawdzić, czy moja SPA wysyła jedną odsłonę na ekran?
Włącz tryb debugowania, przejdź przez aplikację i szukaj nowego zdarzenia page_view w DebugView dla każdego ekranu. Porównaj każde z poprzednim page_view, aby potwierdzić aktualizację lokalizacji i odsyłacza. Potem powtórz test z przyciskami wstecz i dalej, zmianą filtra oraz linkiem z fragmentem.
Czy ten artykuł był pomocny?
Chętnie poznamy opinię!
Częściej widoczni w Google
Jedno kliknięcie ustawia Flowsery jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych artykułach, trybie AI i Przeglądach od AI.
Jeszcze jedno...
Flowsery
Analityka witryny skupiona na przychodach
Każdy odwiedzający, źródło i konwersja w czasie rzeczywistym. Prosto, skutecznie i bez plików cookie.
Panel w czasie rzeczywistym
Śledzenie celów
Śledzenie bez cookie
Powiązane hasła ze słownika


Dlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Współczynnik odrzuceń w GA4 to odsetek sesji bez zaangażowania. Sprawdź, jak definiuje go Google, czym różni się od Universal Analytics i gdzie go dodać.


Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze
Raport stron docelowych w GA4 pokazuje pierwszą stronę każdej sesji. Gdzie go znaleźć, jakie ma domyślne wskaźniki, skąd (not set) i jak dodać źródło.


Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny
Skonfiguruj wyszukiwanie w witrynie w GA4 przez pomiar zaawansowany, dodaj własne parametry zapytań, znajdź wymiar Search term i śledź wyszukiwania bez adresu URL.


Jak ustawiać właściwości użytkownika w GA4 i raportować o nich
Ustaw właściwości użytkownika w GA4 przez gtag lub Tag Manager, zarejestruj je jako wymiary niestandardowe o zakresie użytkownika i zmieść się w limicie 25.


Jak połączyć Search Console z GA4 i opublikować raporty
Jak połączyć Search Console z GA4 w sekcji Administracja, jakie role są potrzebne, jak opublikować dwa raporty w Library i czego te dane nie połączą.


Co bfcache robi z nawigacją wstecz i liczbą odsłon
Bfcache, czyli pamięć podręczna wstecz/dalej, przywraca stronę z pamięci po kliknięciu wstecz lub dalej. Które strony się kwalifikują i dlaczego analityka je pomija lub liczy podwójnie.
Powiązane artykuły


Jak budować wskaźniki obliczane w GA4 przy limicie pięciu miejsc
Google ogranicza wskaźniki obliczane w GA4 do 5 na standardową usługę. Poznaj składnię wzorów, jednostki, miejsca użycia i to, czego wzór nie może zawierać.


Grupowanie treści w GA4 za pomocą jednego parametru
Skonfiguruj grupowanie treści w GA4 parametrem content_group w gtag lub Tag Managerze, odczytaj wymiar Content group i pozbądź się wierszy (not set).


Jak dodawać adnotacje Google Analytics w GA4 i prowadzić rejestr zmian
Adnotacje Google Analytics w GA4 przypinają datowaną notatkę do wykresów liniowych. Kto może je dodawać, limity 60 i 150 znaków, pułap 1 000 i rejestr zmian.