Słownik

Jak śledzenie SPA liczy odsłony, gdy strona nigdy się nie przeładowuje

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Jak śledzenie SPA liczy odsłony, gdy strona nigdy się nie przeładowujeJak śledzenie SPA liczy odsłony, gdy strona nigdy się nie przeładowuje

W skrócie

8 min czytania

Aplikacja 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.

Drewniany drogowskaz na skrzyżowaniu ze strzałkami w różnych kierunkach, symbolizujący zmiany tras zapisywane w historii przeglądarki.

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.

ZmianaCo ją wywołujeZdarzenie przeglądarki
history.pushState()Twój router, po kliknięciu linku w aplikacjiBrak
history.replaceState()Twój router, gdy nadpisuje bieżący adres URLBrak
Przycisk wstecz lub dalejOdwiedzającypopstate
history.back(), forward(), go()Twój kodpopstate
Zmiana fragmentu (#section)Link lub kod zmieniający fragmenthashchange

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ć:

  1. W Google Analytics otwórz Admin.
  2. W sekcji Data collection and modification kliknij Data streams, a potem swój strumień internetowy.
  3. W sekcji Enhanced measurement włącz przełącznik.
  4. Kliknij ikonę ustawień, a w sekcji Page views kliknij Show advanced settings.
  5. Włącz Page loads oraz Page changes based on browser history events.
  6. 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: '...' }).

Która metoda śledzenia pasuje do twojej SPA
Router używa pushState lub replaceStateWłącz w GA4 Page changes based on browser history events
Tagi działają przez Google Tag ManagerUżyj wyzwalacza History Change i zostaw automatyczne śledzenie historii wyłączone
Ekrany zmieniają się bez zmiany adresu URLWysyłaj page_view samodzielnie jako zdarzenie niestandardowe
Wybierz jedną metodę na aplikację, bo dwie działające naraz powodują podwójne liczenie.

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: false nie zatrzymuje odsłon opartych na historii. Google stwierdza: "If Enhanced Measurement is enabled, Google Analytics will send page_view events based on browser history changes even if you set send_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=price w adresie URL przez replaceState moż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 #/pricing wywołuje hashchange. Sprawdź, czy twoje narzędzie liczy zmiany fragmentu, a jeśli nie, skonfiguruj je.
  • Odsłony wysłane przed aktualizacją adresu URL. page_view uruchomione przed pushState zapisuje stare page_location. W DebugView Google zaleca porównanie każdego page_view "with the preceding page_view event 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, bo document.referrer w 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.

Programista przy biurku klika po witrynie na laptopie, sprawdzając, czy każdy ekran zapisuje się raz, jak wymaga tego etap weryfikacji.

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.

Flowsery
Flowsery

Rozpocznij 14-dniowy okres próbny

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

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żowaniaDlaczego współczynnik odrzuceń w GA4 to odwrócony współczynnik zaangażowania
Słownik

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ć.

•8 min czytania
Co liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wierszeCo liczy raport stron docelowych w GA4 i gdzie pojawiają się puste wiersze
Słownik

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.

•8 min czytania
Jak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witrynyJak GA4 rejestruje to, co odwiedzający wpisują w wyszukiwarkę witryny
Słownik

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.

•8 min czytania
Jak ustawiać właściwości użytkownika w GA4 i raportować o nichJak ustawiać właściwości użytkownika w GA4 i raportować o nich
Słownik

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.

•9 min czytania
Jak połączyć Search Console z GA4 i opublikować raportyJak połączyć Search Console z GA4 i opublikować raporty
Słownik

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ą.

•8 min czytania
Co bfcache robi z nawigacją wstecz i liczbą odsłonCo bfcache robi z nawigacją wstecz i liczbą odsłon
Słownik

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.

•8 min czytania

Powiązane artykuły