Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Ten dokument jest przeznaczony dla programistów, którzy chcą mierzyć liczbę wyświetleń stron w aplikacji jednostronicowej za pomocą Google Analytics.
Aplikacje jednostronicowe to witryny, które wczytują dokument HTML tylko raz, a dodatkowe treści pobierają za pomocą interfejsów API JavaScript.
Przykład: masz formularz, który służy do zdobywania potencjalnych klientów. Formularz ma 3 ekrany:
Pierwszy ekran służący do rejestrowania informacji o kliencie.
Drugi ekran, na którym klienci mogą wyrazić zainteresowanie określonymi usługami.
Trzeci ekran, na którym można zapisać się na webinaria związane z zainteresowaniami klienta.
Kluczem do prawidłowego zliczania wyświetleń stron w ramach aplikacji SPA jest zliczanie wyświetleń stron dla każdej strony, z którą użytkownik wchodzi w interakcję, oraz prawidłowe określanie odwołania strony, aby można było prawidłowo śledzić ścieżkę użytkownika.
tag Google zaimplementowany w witrynie, który uruchamia się, gdy strona jest po raz pierwszy wczytywana. Dowiedz się, jak skonfigurować tag Google.
Implementacja pomiaru aplikacji jednostronicowych
Aby wdrożyć dokładne pomiary SPA, użyj jednej z tych metod, aby wywołać nowe wyświetlenie wirtualnej strony:
Zmiany historii przeglądarki (zalecane): jeśli aplikacja SPA korzysta z interfejsu History API, w szczególności z metod pushState() i replaceState() do aktualizowania ekranów, użyj tej opcji.
Zdarzenia niestandardowe: jeśli Twoja witryna używa obiektu DocumentFragment do renderowania różnych ekranów, użyj tej opcji.
Weryfikowanie konfiguracji pomiarów
Aby sprawdzić, czy aplikacja jednostronicowa prawidłowo mierzy wyświetlenia strony:
Przejdź przez aplikację jednostronicową. Gdy klikniesz nowy ekran wirtualny, w raporcie DebugView powinno pojawić się nowe zdarzenie page_view. Porównaj parametry zdarzenia page_view z poprzednim zdarzeniem page_view, aby sprawdzić, czy prawidłowe są parametry referrera i lokalizacji strony.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-04-29 UTC."],[[["This guide helps developers track page views within single-page applications using Google Analytics 4."],["Accurate tracking involves counting views for each screen a user interacts with and ensuring correct referral data for user journey analysis."],["Implementation relies on leveraging browser history changes or custom events to trigger virtual page views for different screens within the application."],["Before starting, ensure you have a Google Analytics 4 account and a Google tag implemented on your website."],["Verification involves enabling debug mode and confirming that new `page_view` events are triggered with updated page referrer and location data upon screen transitions."]]],["Developers using Google Analytics to measure page views on single-page applications (SPAs) should count page views for each user-interacted screen and accurately track the page referrer. To implement this, they can trigger virtual page views via browser history changes using the History API's `pushState()` and `replaceState()` methods, or through custom events with the `DocumentFragment` object. After implementation, debug mode should be enabled to verify new `page_view` events for each virtual screen, ensuring referrer and location data updates correctly.\n"]]
