Pomiar aplikacji jednostronicowych

Ten dokument jest przeznaczony dla deweloperów, którzy chcą mierzyć liczbę wyświetleń strony w aplikacji jednostronicowej za pomocą Google Analytics.

Aplikacje jednostronicowe (SPA) to witryny, które wczytują dokument HTML tylko raz, a wszelkie dodatkowe treści pobierają za pomocą interfejsów JavaScript API.

Przykład: załóżmy, że masz formularz do pozyskiwania potencjalnych klientów. Formularz ma 3 ekrany:

• Pierwszy ekran, na którym można wprowadzić informacje o kliencie.
• Drugi ekran, na którym klienci mogą wyrazić zainteresowanie określonymi usługami.
• Trzecia strona ekranu, na której można zarejestrować się na webinary związane z zainteresowaniami klienta.

Kluczem do prawidłowego pomiaru wyświetleń stron w przypadku aplikacji SPA jest zliczanie wyświetleń każdej strony, z którą wchodzi w interakcję użytkownik, oraz prawidłowe określanie strony odsyłającej, aby można było prawidłowo śledzić ścieżkę użytkownika.

Zanim zaczniesz

Na tej stronie zakładamy, że masz już:

• konto i usługę w Google Analytics 4 dla Twojej witryny, Dowiedz się, jak skonfigurować Google Analytics.

• Tag Google zaimplementowany w witrynie, który uruchamia się przy pierwszym załadowaniu strony. Dowiedz się, jak skonfigurować tag Google.

Wdrażanie pomiarów w aplikacjach jednostronicowych

Aby wdrożyć dokładne pomiary SPA, użyj jednej z tych metod, aby wywołać nowe wirtualne wyświetlenie strony:

• Zmiany w historii przeglądarki (zalecane): jeśli Twoja aplikacja SPA korzysta z interfejsu History API, a 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.

Implementacja zmiany historii przeglądarki

Jeśli Twoja aplikacja SPA korzysta z interfejsu History API, możesz włączyć w Google Analytics pomiar zaawansowany, aby automatycznie śledzić wyświetlenia stron na podstawie zdarzeń historii przeglądarki.

Włączanie pomiaru zaawansowanego w GA4

Aby automatycznie mierzyć page_views na podstawie historii przeglądania:

1. Otwórz Google Analytics.

2. Na stronie Administracja w sekcji Zbieranie i modyfikowanie danych kliknij Strumienie danych > Sieć.

3. W sekcji Pomiar zaawansowany ustaw przełącznik na Wł., aby włączyć wszystkie opcje.

4. Kliknij, aby edytować poszczególne opcje. W sekcji Wyświetlenia strony kliknij Pokaż ustawienia zaawansowane. Upewnij się, że masz włączone opcje Wczytania strony i Zmiany na stronie na podstawie zdarzeń historii przeglądania.

   

5. Zapisz zmiany.

Uwaga: gdy pomiar zaawansowany jest włączony w przypadku opcji „Zmiany strony na podstawie zdarzeń historii przeglądarki”, Google Analytics automatycznie nasłuchuje zdarzeń historii (takich jak te używane w aplikacjach SPA) i wysyła zdarzenia page_view. Aby wysyłać odsłony do GA4, nie musisz konfigurować w Menedżerze tagów Google konkretnych zmiennych ani reguł historii.

Używanie reguł Menedżera tagów Google w przypadku zdarzeń historii

Jeśli w Menedżerze tagów Google musisz uruchamiać inne rodzaje tagów na podstawie zmian w historii przeglądarki, np. aby wysyłać dane do innych platform marketingowych, możesz użyć typu reguły „Zmiana historii”.

Podczas konfigurowania tagów lub zmiennych do pracy z wyzwalaczem zmiany historii upewnij się, że używasz prawidłowych wbudowanych zmiennych udostępnianych przez Menedżera tagów Google:

• History New URL Fragment: fragment adresu URL po zdarzeniu w historii.
• History Old URL Fragment: fragment adresu URL przed zdarzeniem w historii.
• History New State: nowy obiekt stanu historii.
• History Old State: stary obiekt stanu historii.
• History Source: źródło zdarzenia w historii (np. popstate,pushState, replaceState).

Zmienne wbudowane mogą wymagać wcześniejszego włączenia w Menedżerze tagów Google w sekcji Zmienne > Skonfiguruj.

Więcej informacji o tym wyzwalaczu znajdziesz w artykule Wyzwalacz zmiany historii.

Weryfikowanie konfiguracji pomiarów

Aby sprawdzić, czy aplikacja jednostronicowa prawidłowo mierzy wyświetlenia strony:

1. Włącz tryb debugowania dla każdego tagu w konfiguracji pomiarów w aplikacji SPA. Dowiedz się, jak monitorować zdarzenia w raporcie DebugView.

2. Klikaj elementy aplikacji jednostronicowej. 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 odsyłająca strona i lokalizacja strony zostały prawidłowo zaktualizowane.

Wpływ na zdarzenia automatyczne

Jeśli prawidłowo zaimplementujesz pomiar wirtualnych odsłon w swojej aplikacji SPA, Google Analytics będzie odpowiednio obsługiwać inne zdarzenia automatyczne. Jeśli wirtualne wyświetlenia stron nie są rejestrowane w przypadku zmian ekranu, Google Analytics traktuje aplikację SPA jako jedną stronę, co prowadzi do zniekształcenia danych.

Na przykład zdarzenie user_engagement mierzy czas, jaki użytkownik aktywnie spędza na stronie. Bez wirtualnych wyświetleń strony cały czas zaangażowania jest przypisywany do początkowego wczytania strony, co uniemożliwia analizowanie czasu spędzonego na poszczególnych ekranach.

Jeśli pomiar wirtualnych odsłon jest prawidłowo wdrożony:

• Zdarzenie user_engagement jest wysyłane, gdy użytkownik przechodzi z jednej wirtualnej strony na drugą.
• Czas zaangażowania na poprzedniej stronie wirtualnej jest obliczany i wysyłany wraz ze zdarzeniem user_engagement, zwykle tuż przed przetworzeniem zdarzenia page_view na nowej stronie wirtualnej.
• Inne zdarzenia, takie jak kliknięcia lub przewijanie, są powiązane z page_location wirtualnej strony, którą użytkownik aktualnie wyświetla.

Dzięki temu możesz analizować zaangażowanie użytkowników i inne dane dotyczące poszczególnych ekranów lub sekcji w aplikacji SPA, co pozwala lepiej zrozumieć ścieżkę użytkownika.