- Jacek Ślesicki
- [email protected]
- Olsztyn, Polska
Google Tag Manager WordPress: dodaj kod i sprawdź pomiar

Jak dodać Google Tag Manager do WordPressa?
Google Tag Manager dodaję do WordPressa przez jedną wybraną integrację, a następnie konfiguruję tagi i sprawdzam ich działanie. Instrukcja Google przewiduje 2 fragmenty instalacyjne: skrypt i noscript. Do pomiaru w Google Analytics 4 potrzebna jest jeszcze konfiguracja analityki; obecność kontenera nie oznacza, że dane już trafiają do raportów.
Chcesz, żebym zajął się tym w Twojej firmie? Szczegóły znajdziesz w ofercie: Strony internetowe i sklepy (WordPress).
Zakres budowy i obsługi witryn opisuję na stronie Strony internetowe i sklepy (WordPress). Tutaj rozdzielam trzy zadania: instalację kontenera, uruchomienie pomiaru oraz sprawdzenie zgód. Kod dodany bez rozpoznania obecnej konfiguracji może utrudnić ocenę danych. Dlatego zaczynam od inwentaryzacji, nie od instalowania kolejnej wtyczki.
Istniejące tagi: jak sprawdzić obecną konfigurację?
Zacznij od źródła strony i ustawień integracji WordPressa, a następnie potwierdź wykryte identyfikatory w Tag Assistant.
W źródle wyszukaj GTM-, googletagmanager.com oraz identyfikator pomiaru zaczynający się od G-. Brak wyniku nie rozstrzyga sprawy: skrypt może pojawiać się dopiero po zgodzie lub zostać dodany przez JavaScript. Zapisz znalezione identyfikatory i ustal ich właściciela.
- Wtyczki analityczne mogą odpowiadać za istniejący pomiar Google Analytics 4.
- Ustawienia motywu mogą zawierać pola na skrypty nagłówka i treści strony.
- Wtyczki do fragmentów kodu mogą przechowywać wcześniejszą instalację kontenera.
- Platforma zgód może sterować momentem ładowania narzędzi pomiarowych.
- Konto Google Tag Manager powinno pozostawać dostępne dla właściciela serwisu.
Przykład: identyfikator G- w ustawieniach wtyczki analitycznej oznacza potrzebę sprawdzenia jej działania przed przeniesieniem pomiaru. Nie usuwaj konfiguracji tylko dlatego, że planujesz używać GTM. Najpierw ustal, co przestanie działać.
Kontener internetowy: jak utworzyć go dla właściwej witryny?
Najpierw wybierz istniejące konto Google Tag Manager albo utwórz nowe, następnie dodaj kontener typu Web dla swojej witryny.
Nazwij go jednoznacznie, najlepiej domeną. Google zaleca kontener dla witryny, a nie osobny dla każdego artykułu. Identyfikator GTM- wskazuje kontener, natomiast identyfikator G- wskazuje strumień pomiarowy GA4. Nie stosuj ich zamiennie. Szczegóły organizacji opisuje instrukcja tworzenia konta i kontenera Google.
Przykładowo blog i jego archiwumum kategorii nie potrzebują odrębnych kontenerów tylko dlatego, że mają inne szablony. Podstawowe pojęcia wyjaśniam szerzej w poradniku Co to jest Google Tag Manager?.
Instalacja GTM: wybierz wtyczkę albo integrację w kodzie
Do instalacji wybieram wtyczkę lub kontrolowaną integrację w kodzie, a każdą metodę sprawdzam na wygenerowanej stronie. GTM4WP umieszcza fragmenty Google Tag Manager w WordPressie, natomiast wariant programistyczny wymaga kontroli szablonów i punktów integracji. Kryterium wyboru stanowi możliwość utrzymania rozwiązania, a nie sama liczba zainstalowanych dodatków.
GTM4WP: jak skonfigurować pojedynczą instalację kontenera?
Zacznij od instalacji GTM4WP z katalogu WordPress.org, następnie wpisz identyfikator kontenera i włącz umieszczanie jego kodu.
W ustawieniach wtyczki przejdź do sekcji „Google Tag Manager container”. Dodaj własny identyfikator GTM- do tabeli „Google Tag Manager containers”, ustaw sposób umieszczenia kodu kontenera, zapisz zmiany i sprawdź stronę. Nie wklejaj tam całego skryptu ani identyfikatora G-. Według dokumentacji GTM4WP automatyczne umieszczenie drugiego fragmentu zależy również od obsługi odpowiednich mechanizmów przez motyw.
GTM4WP jest jedną z dostępnych metod. Dla osoby obsługującej panel WordPressa może być łatwiejsza w utrzymaniu niż własna integracja PHP. Nie oznacza to automatycznie najlepszego wyboru dla każdej witryny.
| Metoda | Potrzebne umiejętności | Najważniejsza kontrola |
|---|---|---|
| GTM4WP | Obsługa panelu i ustawień wtyczki. | Włączenie kodu, identyfikator i położenie fragmentów. |
| Integracja programistyczna | Znajomość PHP oraz mechanizmów WordPressa. | Poprawne hooki, szablony i utrzymanie kodu. |
| Istniejąca integracja motywu | Znajomość dokumentacji używanego motywu. | Zakres integracji i zachowanie po zmianie motywu. |
Kod GTM: gdzie umieścić oba fragmenty?
Pierwszy fragment umieść możliwie wysoko w sekcji head, a drugi bezpośrednio po otwarciu body, zgodnie z instrukcją Google.
„Copy the first block of code and paste it as high in the <head> tag as possible.”
Google, „Install a web container”, dokumentacja sprawdzona 18.10.2026.
Pobierz oba fragmenty z własnego kontenera. Instrukcja instalacji Google wskazuje ich położenie; nie zastępuj drugiego fragmentu kopią pierwszego.
W WordPressie wp_head służy do dołączania zawartości w head, ale jego faktyczne położenie zależy od motywu. Sam priorytet callbacku nie przesunie kodu przed elementy zapisane wcześniej w szablonie. Z kolei wp_body_open obsługuje punkt po otwarciu body.
„Triggered after the opening body tag.”
WordPress Developer Resources, dokumentacja wp_body_open(), sprawdzona 18.10.2026.
Nie zalecam edycji motywu nadrzędnego. Integrację przygotuj w kontrolowanym dodatku lub odpowiednio utrzymywanym motywie potomnym. Sprawdź wynikowy HTML, ponieważ sam zapis poprawnego kodu PHP nie potwierdza miejsca jego wykonania.
Pamięć podręczna: jak sprawdzić stronę po zmianie?
Najpierw wyczyść pamięć podręczną obejmującą zmienione strony, a następnie sprawdź witrynę jako niezalogowany użytkownik.
Proponuję następującą kontrolę po instalacji:
- Strona główna powinna korzystać z wybranego sposobu osadzenia kontenera.
- Artykuł powinien zawierać integrację również przy innym układzie nagłówka.
- Landing page powinien zachować pomiar mimo uproszczonego szablonu.
- Optymalizacja JavaScript nie powinna zmieniać uzgodnionej kolejności uruchamiania skryptów.
Przykład: kontener widoczny administratorowi, lecz niewidoczny po wylogowaniu, wymaga porównania wersji strony i reguł integracji. Nie instaluj od razu drugiej kopii „na wszelki wypadek”.
Konfiguracja pomiaru: dodaj tag i ustaw reguły zgód
Po instalacji kontenera konfiguruję właściwy tag pomiarowy, jego uruchamianie i obsługę sygnałów zgody. Google Analytics 4 potrzebuje połączenia z odpowiednim strumieniem danych. Consent Mode opisuje zachowanie narzędzi wobec sygnałów zgody, a platforma CMP obsługuje wybór użytkownika. Tych funkcji nie należy traktować jako jednej rzeczy.
Tag Google: jak podłączyć właściwy strumień GA4?
Najpierw skopiuj identyfikator właściwego strumienia internetowego GA4, następnie skonfiguruj tag Google w kontenerze i jego regułę uruchamiania.
W dokumentacji sprawdzonej 18.10.2026 Google opisuje dodanie miejsca docelowego Google Analytics oraz alternatywną konfigurację Google tag. Dla tej drugiej ścieżki minimalna procedura wygląda następująco:
- Strumień internetowy GA4 musi odpowiadać witrynie, której ruch chcesz analizować.
- Nowy tag w GTM powinien otrzymać czytelną nazwę, na przykład „GA4 - tag podstawowy”.
- Typ Google tag wymaga identyfikatora tagu powiązanego z właściwą usługą.
- Reguła Initialization dla wszystkich stron wymaga uwzględnienia przyjętej konfiguracji zgód.
- Zapisany tag należy sprawdzić w podglądzie przed opublikowaniem kontenera.
Podstawą jest instrukcja konfiguracji Google Analytics w GTM. Nie dodawaj równolegle obu opisanych ścieżek do tego samego celu pomiarowego. Znaczenie poszczególnych elementów wyjaśniam w poradniku Czym są tagi w Google Tag Manager?.
Zgody użytkownika: jak połączyć CMP i Consent Mode?
Zacznij od ustalenia, które narzędzie przekazuje domyślne stany zgody, a następnie sprawdź ich aktualizację po wyborze użytkownika.
CMP zarządza interfejsem wyboru, natomiast Consent Mode przekazuje i wykorzystuje sygnały takie jak analytics_storage, ad_storage, ad_user_data i ad_personalization. Sam widoczny baner nie potwierdza tej integracji.
Dokumentacja Consent mode overview, zaktualizowana 30.07.2026, rozróżnia wariant podstawowy i zaawansowany. W podstawowym tagi Google pozostają blokowane bez zgody; w zaawansowanym mogą wysyłać sygnały bez plików cookie przy stanie denied. Dlatego samo żądanie sieciowe po odmowie nie wystarcza do oceny konfiguracji.
Przykładowy test obejmuje nową wizytę bez wyboru, odmowę, zgodę na analitykę oraz późniejszą zmianę decyzji. Porównaj rezultat z przyjętym modelem. To instrukcja techniczna: materiał ma charakter informacyjny i nie zastępuje indywidualnej konsultacji z prawnikiem dotyczącej obowiązków serwisu.
Podwójny pomiar: jak ograniczyć ryzyko powielania zdarzeń?
Najpierw przypisz każde zdarzenie do konkretnej integracji, a następnie sprawdź, czy drugie narzędzie nie wysyła go do tego samego strumienia.
Przykład: istniejąca wtyczka analityczna i nowa konfiguracja GTM mogą równolegle obsługiwać odsłony. Oddzielnie sprawdź ręcznie dodany page_view oraz automatyczne zbieranie zdarzeń opisane przez Google Analytics. Nie każdy dodatkowy komunikat oznacza kolejną odsłonę; porównuj nazwę zdarzenia, adres strony i cel wysyłki.
Na początek wystarczy poprawny pomiar podstawowy. Rozbudowę planuj osobno, korzystając z poradnika Jakie zdarzenia warto mierzyć w GA4?.
Test i publikacja: sprawdź kontener na stronie
Instalację uznaję za zakończoną po teście w podglądzie, publikacji wersji i ponownej kontroli strony poza podglądem. Tag Assistant pokazuje działanie konfiguracji Google Tag Manager, lecz kontrola danych w Google Analytics 4 pozostaje osobnym zadaniem. Proponuję sprawdzić przynajmniej stronę główną, artykuł, formularz i istotny szablon sklepu, jeśli istnieje.
Tag Assistant: jak uruchomić podgląd kontenera?
Wybierz Preview w obszarze roboczym GTM, wpisz adres witryny w Tag Assistant i połącz narzędzie ze stroną.
Po otwarciu witryny wróć do okna diagnostycznego. Sprawdź rozpoznany kontener, sekwencję zdarzeń oraz uruchomione tagi. Według dokumentacji podglądu Google tryb ten pozwala testować bieżący szkic przed publikacją. Zwykły odwiedzający nie korzysta automatycznie z tej konfiguracji.
Przykład: tag widoczny w podglądzie, ale nieobecny podczas zwykłej wizyty, może należeć do nieopublikowanej wersji. Dalsze kroki opisuję w materiale Jak sprawdzić, czy Google Tag Manager działa poprawnie?.
Formularze i WooCommerce: co uwzględnić w scenariuszu testowym?
W scenariuszu uwzględnij rzeczywiste działania użytkownika oraz oczekiwany rezultat, aby odróżnić samo kliknięcie od zakończonej czynności.
Poniższa lista jest propozycją testów, a nie opisem wykonanego wdrożenia:
- Strona główna powinna przekazać odsłonę zgodnie z konfiguracją pomiaru i zgód.
- Artykuł powinien przesłać właściwy adres oraz tytuł zamiast danych poprzedniej podstrony.
- Formularz powinien odróżniać próbę wysłania od potwierdzonego sukcesu, jeśli taki pomiar skonfigurowano.
- Strona produktu WooCommerce powinna zachować podstawową integrację także poza szablonem blogowym.
- Odmowa i akceptacja zgód powinny dawać rezultaty zgodne z zaplanowanymi zasadami.
Przykładowo kliknięcie „Wyślij” przy pustym wymaganym polu nie powinno potwierdzać pozyskania zapytania. Podobnie samo otwarcie produktu nie potwierdza zakupu. Każdemu testowi przypisz oczekiwane zdarzenie i sprawdź je w narzędziu docelowym.
Publikacja kontenera: jak zakończyć wdrożenie?
Po pomyślnych testach prześlij zmiany, opublikuj wersję z opisem i powtórz podstawowy scenariusz po zakończeniu podglądu.
Zamiast nazwy „poprawki” wybierz opis wskazujący zakres, na przykład „Uruchomienie GA4 i test zgód”. Google opisuje publikowanie oraz historię wersji w dokumentacji wersjonowania kontenerów. Zachowaj punkt odniesienia umożliwiający powrót do poprzedniej konfiguracji.
Utrzymanie GTM: zachowaj kontrolę po instalacji
Po instalacji zalecam zachowanie krótkiej dokumentacji obejmującej integrację WordPressa, kontener Google Tag Manager i strumień Google Analytics 4. Taka karta powinna wskazywać odpowiedzialność za pomiar i zgody oraz zakres ostatniego testu. Ułatwia ocenę kolejnych zmian bez ponownego zgadywania, skąd pochodzi każdy fragment kodu.
Dokumentacja pomiaru: co zapisać dla właściciela serwisu?
Zapisz identyfikatory narzędzi, miejsce instalacji i odpowiedzialność za konfigurację, aby właściciel mógł odtworzyć zależności bez przeszukiwania wszystkich wtyczek.
Proponuję kartę zawierającą cztery informacje:
- Integracja kontenera ma wskazaną nazwę wtyczki albo miejsce przechowywania kodu.
- Pomiar GA4 ma zapisany strumień docelowy oraz listę aktywnych zdarzeń.
- Mechanizm zgód ma wskazaną platformę CMP i przyjęty model działania.
- Ostatnia publikacja ma numer wersji, datę oraz krótki opis sprawdzonych scenariuszy.
Przykład: zmiana motywu jest łatwiejsza do oceny, gdy karta wskazuje integrację przez jego ustawienia. Od razu wiadomo, który element wymaga ponownego sprawdzenia. Dokumentacja powinna opisywać stan faktyczny, nie sam plan wdrożenia.
Aktualizacje WordPressa: kiedy powtórzyć testy?
Powtórz testy po zmianie motywu, integracji analitycznej, platformy zgód oraz ustawień optymalizacji skryptów, zanim uznasz zmianę za zakończoną.
Nie obiecuję, że dowolny tag pozostanie obojętny dla wydajności. Kontroluj również zachowanie strony i zakres uruchamianych narzędzi. Przy porządkowaniu instalacji zmieniaj jeden element naraz; dzięki temu łatwiej powiązać zauważony efekt z konkretną decyzją.
Jeśli potrzebujesz pomocy z instalacją lub uporządkowaniem pomiaru, opisz witrynę i obecne integracje w formularzu kontaktowym. Podaj, co ma być mierzone i gdzie obecnie widzisz problem.
Najczęściej zadawane pytania
GTM4WP: czy zastępuje Google Analytics 4?
Nie, GTM4WP integruje kontener z WordPressem, natomiast Google Analytics 4 jest narzędziem zbierania i analizowania danych. Aktywna wtyczka nie potwierdza jeszcze działającego pomiaru.
Google Tag Manager: czy wymaga kontenera server-side?
Nie, podstawowa instalacja opisana w tym poradniku wykorzystuje kontener internetowy, który działa po stronie przeglądarki odwiedzającego witrynę. Kontener server-side stanowi odrębny wariant architektury i nie jest warunkiem rozpoczęcia pracy.
Identyfikator GTM: czy jest hasłem do konta?
Nie, identyfikator GTM wskazuje kontener i występuje w kodzie instalacyjnym strony, więc nie pełni funkcji hasła. Dostęp do edycji oraz publikacji wynika z uprawnień konta.
GTM4WP: czy wystarczy do pełnego pomiaru WooCommerce?
Nie, sama instalacja GTM4WP nie potwierdza pełnego pomiaru sklepu, nawet jeśli wtyczka udostępnia integrację danych WooCommerce. Potrzebne są odpowiednie tagi i testy zdarzeń, w tym zakupów oraz ich parametrów.
Google Tag Manager: czy wycofanie wersji naprawi wcześniejsze raporty?
Nie, przywrócenie poprzedniej wersji kontenera zmienia działającą konfigurację, ale samo nie usuwa danych wcześniej wysłanych do analityki. Datę błędnego wdrożenia zachowaj jako kontekst przy interpretacji raportów.
Jacek Ślesicki - jestem specjalistą SEO i wydawcą ponad 200 własnych serwisów tematycznych na WordPressie i Astro; od listopada 2016 prowadzę Agencję ITP w Olsztynie.
Źródła i literatura
Opis instalacji i konfiguracji opieram na dokumentacji Google, WordPressa oraz GTM4WP, sprawdzonej 18.10.2026. Poniższe materiały obejmują kontenery internetowe, tag Google, Consent Mode i mechanizmy integracyjne WordPressa. Podana data oznacza sprawdzenie dokumentacji, a nie datę wykonania testów na konkretnej witrynie.
Google: instalacja, analityka i diagnostyka
- Google: Create an account and container opisuje organizację konta i wybór kontenera.
- Google: Install a web container określa położenie fragmentów instalacyjnych.
- Google: Set up Google Analytics in Tag Manager opisuje konfigurację pomiaru.
- Google: Preview and debug containers wyjaśnia działanie podglądu.
- Google: Consent mode overview opisuje sygnały zgody i warianty działania.
WordPress: punkty integracji i GTM4WP
WordPress: wp_head() oraz WordPress: wp_body_open() dokumentują mechanizmy osadzania kodu. Karta GTM4WP w WordPress.org opisuje ustawienia, wymagania i integracje wtyczki.
