Spis treści
Czym jest GTM Kit i dla kogo
GTM Kit to wtyczka, która dodaje na stronie kod kontenera Google Tag Manager i udostępnia bogatą warstwę danych na potrzeby GA4, reklam i pikseli społecznościowych. Integruje m.in. WooCommerce, Easy Digital Downloads i Contact Form 7, dzięki czemu kluczowe zdarzenia trafiają do dataLayer bez ręcznego kodowania.
Wymagania i zgodność
Wtyczka działa z WordPress od wersji 6.4 i PHP od 7.4. Najnowsze wydania są testowane na aktualnych wersjach WordPress i WooCommerce, a baza instalacji przekracza kilkadziesiąt tysięcy aktywnych witryn. Przy sklepach warto sprawdzić minimalne wymagania WooCommerce wskazane przez autorów wtyczki dla danej wersji.
Instalacja i szybki start
Zainstaluj GTM Kit z repozytorium wtyczek, włącz, a następnie w ustawieniach wpisz identyfikator kontenera GTM i aktywuj integrację. To wystarczy, aby kontener zaczął się ładować na stronach, a Ty mógł_ła konfigurować tagi już w samym Google Tag Manager. Dodatkowe przełączniki pozwalają włączyć konkretne dane w warstwie danych.
Konfiguracja GA4 w Google Tag Manager
Po stronie GTM utwórz tag GA4 z identyfikatorem pomiaru i dodaj reguły dla zdarzeń e-commerce. Jeśli korzystasz z gotowych szablonów dostarczanych przez autorów, import ułatwi zmapowanie zmiennych, wyzwalaczy i tagów GA4 bez żmudnego klikania. Pamiętaj, że GTM Kit dostarcza dane do kontenera, ale tagi musisz skonfigurować w GTM.
Dane w warstwie danych
GTM Kit pozwala decydować, które elementy trafią do dataLayer, w tym typ strony, kategorie, tagi, tytuł, ID wpisu czy metadane autora. Możesz dorzucić też wybrane informacje o użytkowniku, ale przy pełnym cache strony te wartości będą takie same dla wszystkich odwiedzających, więc opcja użytkownika jest przeznaczona raczej dla instalacji z zaawansowanymi wyjątkami cache.
Integracje: WooCommerce, EDD, Contact Form 7
W WooCommerce wtyczka zasila warstwę danych zdarzeniami wymaganymi przez GA4 i reklamy, a dla EDD oraz Contact Form 7 udostępnia gotowe przełączniki integracji. Dzięki temu rejestrowane są m.in. wyświetlenia listy produktów, kliknięcia pozycji, dodania do koszyka, rozpoczęcie zakupu, dane płatności i finalizacja. Dla CF7 włączasz integrację w panelu GTM Kit i konfigurujesz odpowiednie tagi w GTM.
Zdarzenia e-commerce w GA4 – co dostarcza GTM Kit
Domyślnie do dataLayer trafiają kluczowe zdarzenia GA4, m.in. view_item_list, select_item, view_item, add_to_cart, view_cart, remove_from_cart, begin_checkout, add_shipping_info, add_payment_info i purchase. W planie premium dochodzą m.in. add_to_wishlist, refund i order_paid oraz elastyczniejsze sterowanie wyzwalaczami, co pomaga domknąć pomiar zwrotów i list życzeń.
Consent Mode v2 i zgodność z prywatnością
GTM Kit obsługuje Google Consent Mode v2, dzięki czemu tagi dostosowują swoje zachowanie do stanu zgody użytkownika. Sama wtyczka nie jest banerem cookies – sygnały zgody powinny pochodzić z CMP lub własnego mechanizmu, a GTM przekaże je do Google. To ważne dla zgodności prawnej oraz modelowania konwersji, gdy część użytkowników odrzuca pliki cookies.
Server-side tagging – kiedy warto
Dla sklepów z dużym ruchem rozważ server-side tagging. Dodatek GTM Kit Woo wykorzystuje webhooki po stronie serwera do obsługi zakupów i zwrotów, co pomaga uzyskać bardziej kompletne i spójne dane o konwersjach oraz ograniczyć wpływ blokad przeglądarkowych. Do działania potrzebny jest serwerowy kontener GTM na własnej subdomenie.
Wydajność i ładowanie kontenera
Jeśli mierzysz wysoko w PageSpeed, możesz opóźnić ładowanie kontenera do momentu bezczynności przeglądarki albo wskazać niestandardowy loader. W przypadku sGTM możliwe jest też ustawienie własnej domeny serwerowego kontenera, co ułatwia zgodność i stabilność śledzenia.
Współpraca z innymi wtyczkami Google
Możesz utrzymać Site Kit do zadań takich jak Search Console czy Tag Manager, a GTM Kit wykorzystać jako elastyczną warstwę danych dla GTM. Najważniejsze, aby nie duplikować wdrożenia GA4 – jeśli tag GA4 działa przez GTM, nie włączaj go dodatkowo w Site Kit i odwrotnie.
Jak uniknąć podwójnego tagowania
Najczęstszy błąd to jednoczesne wpięcie GA4 przez wtyczkę i przez GTM. Skutkiem są zawyżone sesje i konwersje. Ustal jedno źródło prawdy: albo GA4 idzie przez GTM, albo fragment GA4 wstawia Site Kit. W GTM włącz tryb podglądu i upewnij się, że page_view i purchase wystrzeliwują tylko raz. Jeśli masz importowane szablony, zweryfikuj, czy nie dodają równoległych tagów.
Rozwiązywanie problemów
Jeśli zdarzenie nie trafia do GA4, sprawdź najpierw podgląd GTM i zawartość dataLayer w narzędziach deweloperskich. W sklepach z customowymi motywami dopasuj selektory CSS dla wishlist lub przycisków dodawania do koszyka. Przy mocnym cache wyklucz z opóźniania skrypty gtm.js i gtag.js, a opcje użytkownika w dataLayer testuj bez pełnego cache lub z odpowiednimi wyjątkami. W server-side tagging zweryfikuj domenę sGTM i konfigurację webhooków w dodatku Woo, a w samym GTM użyj trybu Preview także dla kontenera serwerowego.
Dobre praktyki wdrożenia
Ustal nazewnictwo tagów i reguł, aby łatwo utrzymywać konfigurację. Zadbaj o spójność parametrów item_id, item_name, item_brand, item_category i waluty we wszystkich zdarzeniach. W GA4 oznacz purchase jako kluczowe i włącz raporty e-commerce. Jeśli korzystasz z Consent Mode, ustaw stany domyślne i aktualizacje zgody zgodnie z wytycznymi Google. Przed publikacją każdej zmiany przejdź pełny test w Preview i sprawdź, czy wartości koszyka oraz kwoty podatków i dostawy są raportowane zgodnie z polityką Twojej firmy.
