Z tego samouczka dowiesz się, jak skonfigurować pomiary w Google Analytics w przypadku aplikacji jednostronicowej za pomocą Menedżera tagów Google. Dowiesz się, jak skonfigurować usługę w Google Analytics, włączyć niezbędne zmienne Menedżera tagów Google i utworzyć tagi, które są aktywowane przy zmianach historii.
Zanim zaczniesz
W tym samouczku przyjęto założenie, że:
- Konto i usługa Google Analytics.
- Kontener Menedżera tagów Google zainstalowany w aplikacji SPA.
- rolę Edytujący (lub o większych uprawnieniach) zarówno w Google Analytics, jak i w Menedżerze tagów Google.
Krok 1. Przygotuj strumień danych w GA4
Aby ręcznie śledzić zdarzenia page_view w aplikacji SPA, musisz najpierw wyłączyć w GA4 automatyczne odsłony stron oparte na historii, aby uniknąć podwójnego zliczania.
- Otwórz Google Analytics.
- Na stronie Administracja w sekcji Zbieranie i modyfikowanie danych kliknij Strumienie danych.
- Wybierz strumień danych z sieci.
- W sekcji Pomiar zaawansowany kliknij ikonę ustawień
.
- W sekcji Wyświetlenia strony > Pokaż ustawienia zaawansowane odznacz opcję Zmiany na stronie na podstawie zdarzeń historii przeglądania.
- Kliknij Zapisz.
Krok 2. Włącz w Menedżerze tagów wbudowane zmienne historii
Aby używać w Menedżerze tagów Google aktywatorów lub zmiennych opartych na historii, musisz najpierw włączyć wbudowane zmienne historii.
- Otwórz Menedżera tagów Google.
- W obszarze roboczym otwórz Zmienne.
- W sekcji Zmienne wbudowane kliknij Skonfiguruj.
- W sekcji Historia włącz te zmienne:
History New URL FragmentHistory Old URL FragmentHistory New StateHistory Old StateHistory Source
- Zamknij panel konfiguracji.
Krok 3. Utwórz regułę Zmiana historii
Następnie utwórz regułę, która będzie się uruchamiać za każdym razem, gdy w aplikacji SPA nastąpi zdarzenie zmiany historii (np. pushState lub replaceState).
- W obszarze roboczym Menedżera tagów otwórz menu Reguły.
- Kliknij Nowa.
- W sekcji Skonfiguruj regułę wybierz regułę Zmiana historii.
- (Opcjonalnie) Jeśli chcesz śledzić tylko określone zmiany ekranu, zaktualizuj regułę, aby uruchamiała się w przypadku niektórych zmian w historii.
- Nazwij regułę (np. „Zmiana historii”) i kliknij Zapisz.
Krok 4. Utwórz tag Google
Teraz utwórz tag Google, który będzie aktualizować parametr page_location za każdym razem, gdy nastąpi zmiana w historii.
- W menu Tagi kliknij Nowy.
- W sekcji Konfiguracja tagu wybierz Tag Google.
- Wpisz identyfikator tagu (ten sam, którego używasz w przypadku początkowego tagu Google).
W sekcji Ustawienia konfiguracji dodaj te parametry:
page_location:{{Page URL}}page_title:{{Page Title}}update:true
Nazwij tag (np. „Tag Google – aktualizacja SPA”) i kliknij Zapisz.
Krok 5. Wyślij wirtualne page_view wydarzenie
Na koniec utwórz tag zdarzenia GA4, aby wysyłać rzeczywiste zdarzenie page_view w przypadku każdego wczytania strony wirtualnej.
- W menu Tagi kliknij Nowy.
- W sekcji Konfiguracja tagu wybierz Google Analytics: zdarzenie GA4.
- Wpisz identyfikator pomiaru.
- Ustaw Nazwę zdarzenia na
page_view. - W sekcji Ustawienia zaawansowane > Sekwencjonowanie tagów kliknij Uruchom tag przed uruchomieniem tagu Zdarzenie GA4 – wyświetlenie wirtualnej strony i wybierz tag Tag Google – aktualizacja SPA utworzony w kroku 4.
- W sekcji Reguły wybierz utworzoną w kroku 3 regułę Zmiana historii.
- Nadaj tagowi nazwę (np. „Zdarzenie GA4 – odsłona wirtualnej strony”) i kliknij Zapisz.
Krok 6. Sprawdź konfigurację
Aby mieć pewność, że wirtualne wyświetlenia stron są rejestrowane prawidłowo:
- W Menedżerze tagów kliknij Podgląd, aby przejść do trybu podglądu.
- Przechodź między stronami aplikacji SPA.
- W Google Analytics
DebugView sprawdź, czy przy każdej zmianie ekranu pojawia się nowe zdarzenie
page_view. - Sprawdź, czy wartości
page_locationsą zgodne z Twoimi oczekiwaniami.