Debuguj i testuj konfigurację server-side

Preview w GTM działa w obu kontenerach jednocześnie. Kolejność ma znaczenie: sesja Preview serwera musi być otwarta, zanim Preview Web cokolwiek wyśle, a obie muszą działać w tej samej przeglądarce.

1. 1 Otwórz w GTM kontener serwerowy i kliknij Preview. Karta Tag Assistant otworzy się na sgtm.example.com. Zostaw ją otwartą.
2. 2 W tej samej przeglądarce otwórz kontener Web i kliknij Preview. Wpisz adres strony i kliknij Connect.
3. 3 Poklikaj po stronie i wywołaj zdarzenie, które chcesz przetestować.
4. 4 Przełącz się na kartę Preview serwera. Każde przychodzące zapytanie pojawi się w lewej kolumnie.

Wybierz zapytanie i czytaj je od góry do dołu:

• Request: przychodzące zapytanie HTTP i Client, który je przejął. Trafienie GA4 powinien przejąć klient GA4.
• Tags: które tagi się uruchomiły, a które nie. Tag, który się nie uruchomił, zwykle ma niedopasowaną regułę.
• Outgoing HTTP requests (w karcie Request): co serwer wysłał do GA4 albo innego dostawcy i jaki kod statusu dostał w odpowiedzi. Status 2xx oznacza, że dostawca przyjął dane.
• Event Data: parametry wyciągnięte przez klienta. Sprawdź, czy dotarły nazwa zdarzenia i jego parametry.

Preview mówi, co zrobił GTM. Dwa kolejne testy potwierdzają, co naprawdę wyszło z przeglądarki i co dotarło do GA4.

1. 1 Otwórz DevTools (F12), przejdź do karty Network i przefiltruj po collect.
2. 2 Odśwież stronę. Powinny być widoczne zapytania do Twojej własnej subdomeny, a nie do google-analytics.com.
3. 3 Sprawdź status: 200 albo 204 oznacza, że serwer tagowania przyjął trafienie.

https://sgtm.example.com/g/collect?v=2&tid=G-XXXXXXXXXX&en=page_view&...

Potem otwórz GA4, wejdź w Admin, a następnie w Data display i DebugView. Zdarzenia z przeglądarki w trybie GTM Preview są automatycznie oznaczane jako ruch debugowania. Poza Preview dodaj do Google taga parametr debug_mode z wartością true, żeby je tam zobaczyć.

Większość zepsutych konfiguracji zawodzi w jednym z tych miejsc. Sprawdzaj je po kolei, od DNS do dostawcy.

• Sprawdź DNS zwraca błąd albo subdomena się nie rozwiązuje. Rekord może się jeszcze propagować (poczekaj do godziny), nazwa może zawierać domenę dwa razy (sgtm.example.com.example.com, bo niektóre panele dopisują domenę same) albo w Cloudflare włączone jest proxy. W Cloudflare rekord musi mieć ustawione DNS only (szara chmurka), a nie pomarańczową chmurkę.
• Zły albo stary Container Config. Jeśli kontener serwerowy w Preview nie jest tym, który edytujesz w GTM, skopiuj ponownie Container Config z Admin i Container Settings i upewnij się, że Twój kontener w SGTM.space używa dokładnie tego ciągu. Konfiguracja z innego kontenera serwerowego wyśle ruch do niewłaściwego kontenera.
• Trafienia nadal idą do google-analytics.com. W Google tagu brakuje parametru server_container_url, jest w nim literówka albo kontener Web nie został opublikowany po jego dodaniu. Zobacz lekcję 3.
• Działa w Preview, ale nie dla prawdziwych odwiedzających. Kontener serwerowy nigdy nie został opublikowany. Preview korzysta z obszaru roboczego, a prawdziwy ruch z opublikowanej wersji. Kliknij Submit i Publish w kontenerze serwerowym.
• Zapytania docierają, ale nic nie trafia do GA4. Kontener serwerowy nie ma tagu GA4 albo jego reguła się nie dopasowuje. Dodaj tag Google Analytics: GA4 z regułą Client Name equals GA4, jak w lekcji 4.
• Brakuje trafień od części odwiedzających. Adblockery nadal mogą blokować zapytania, a przy Consent Mode tagi mogą się nie uruchamiać albo wysyłać pingi bez ciasteczek, dopóki odwiedzający nie wyrazi zgody. Zobacz lekcję 6 i lekcję 8.
• Nagle wszystkie zapytania są odrzucane. Kontener osiągnął limit zapytań swojego planu w SGTM.space. Zapytania są odrzucane, dopóki nie podniesiesz limitu albo nie zacznie się nowy okres. Zakładka Analityka pokazuje, jak blisko limitu jesteś.

Każdy kontener w SGTM.space ma zakładki, które odpowiadają na pytania, na które GTM nie odpowie.

• Przegląd: status kontenera i jego kontrole stanu. Zacznij tutaj, gdy nic w ogóle nie dociera.
• DNS: rekordy do dodania i ich stan. Po każdej zmianie użyj Sprawdź DNS.
• Analityka: liczba zapytań dziennie. Nagły spadek do zera wskazuje na zepsutą instalację albo zmianę DNS, a nie na GA4.
• Preview Mode: przez 60 minut przekazuje pasujące zapytania z webhooków, CRM-a albo Twojego backendu do otwartej sesji Preview serwera.

Preview Mode przydaje się, gdy zapytania nie pochodzą z Twojej przeglądarki, więc brakuje w nich zwykłego ciasteczka Preview.

1. 1 Otwórz Preview w kontenerze serwerowym. W menu w prawym górnym rogu wybierz Send requests manually i skopiuj wartość nagłówka X-Gtm-Server-Preview.
2. 2 W SGTM.space otwórz zakładkę Preview Mode i wklej token.
3. 3 Opcjonalnie ustaw prefiks ścieżki (na przykład /webhooks) i źródłowy adres IP, żeby przekazywane były tylko te zapytania.
4. 4 Kliknij Zapisz i uruchom na 60 minut i wywołaj webhook albo wywołanie z backendu. Pojawi się w Twojej sesji Preview.

• https://sgtm.example.com/healthz zwraca 200, a kontener ma status Gotowy w zakładce Przegląd.
• DevTools pokazuje zapytania collect do Twojej subdomeny ze statusem 200 albo 204.
• Preview serwera pokazuje, że zapytanie przejął klient GA4.
• Tag GA4 się uruchomił, a jego zapytanie wychodzące dostało status 2xx.
• Zdarzenie pojawia się w GA4 DebugView.
• Oba kontenery są opublikowane.