# DataFirefly Google Tag Manager Pro: kompletny przewodnik > Prezentacja i wymagania DataFirefly Google Tag Manager Pro wypycha kompletny dataLayer GA4 ecommerce dla Twojego sklepu WooCommerce, a następnie pozwala jednym kliknięciem wygenerować gotowy do importu kontener Google Tag Manager,… - Strona: - Język: pl - Zaktualizowano: 2026-10-09 - Inne języki: [fr](https://www.datafirefly.com/documentation/datafirefly-google-tag-manager-pro/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-google-tag-manager-pro/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-google-tag-manager-pro/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-google-tag-manager-pro/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-google-tag-manager-pro/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-google-tag-manager-pro/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-google-tag-manager-pro/index.md) - Indeks: ## Prezentacja i wymagania DataFirefly Google Tag Manager Pro wypycha kompletny dataLayer GA4 ecommerce dla Twojego sklepu WooCommerce, a następnie pozwala jednym kliknięciem wygenerować gotowy do importu kontener Google Tag Manager, już podłączony do tego dataLayera. Wtyczka obsługuje też śledzenie server-side (Meta Conversions API, GA4 Measurement Protocol) z automatyczną deduplikacją, Consent Mode v2 oraz tryb bezpośredniego wstrzykiwania pikseli dla sklepów, które nie używają GTM. - WordPress 5.8 i nowszy, testowane do 7.0. - WooCommerce 7.0 i nowszy, testowane do 9.6, zgodne z HPOS oraz blokami Koszyka/Zamówienia. - PHP 7.4 i nowszy. - Wielojęzyczność (FR/EN/ES/DE/IT), zgodność z Polylang i WPML. - Żadne śledzenie nie jest emitowane w panelu administracyjnym, w kanałach RSS ani w customizerze. Wtyczka rozdziela dwie role: **produkuje dane** (dataLayer GA4) i **pomaga je dystrybuować** (wygenerowany kontener GTM, piksele bezpośrednie, zdarzenia server-side). Sam wybierasz odpowiadający Ci tryb dystrybucji. ## Instalacja 1. Pobierz archiwum `datafirefly-gtm-pro-1.1.0.zip` ze swojego konta klienta. 2. W panelu WordPressa przejdź do **Wtyczki > Dodaj nową > Wyślij wtyczkę na serwer** i prześlij archiwum. 3. Kliknij **Włącz**. 4. Otwórz **Tag Manager Pro** w menu administracyjnym, aby przejść do ustawień. Przy aktywacji wtyczka zapisuje ustawienia domyślne. Następnie możesz uzupełnić kontener, połączenia i włączyć server-side zakładka po zakładce. ## Zakładka Ogólne: kontener i dataLayer Ta zakładka steruje wstrzykiwaniem kontenera i kształtem dataLayera: - **Identyfikator kontenera**: Twój ID GTM w formacie `GTM-XXXXXXX`. Dopóki jest pusty, po stronie GTM nic nie jest wstrzykiwane (dataLayer i tryb bezpośredni pozostają dostępne). - **Nazwa dataLayera**: domyślnie `dataLayer`. Zmieniaj tylko wtedy, gdy wymaga tego Twoja instalacja. - **Umiejscowienie**: head + body (noscript), tylko head albo tylko body. - **Priorytet wyjścia**: standardowy albo wysoki (kontener jest zapisywany wcześnie w sekcji `head`). Śledzenie nigdy nie jest emitowane dla administratorów i personelu według wykluczonych ról (zakładka Zaawansowane), ani w panelu administracyjnym, kanałach RSS czy customizerze. ## Zakładka Połączenia: Twoje platformy Wpisz tutaj identyfikatory platform, z których korzystasz. Ta baza zasila zarówno wygenerowany kontener GTM, jak i piksele bezpośrednie oraz zdarzenia server-side. To, czego nie używasz, zostaw puste. - **Google Analytics 4**: Measurement ID (`G-XXXXXXXXXX`). - **Google Ads**: Conversion ID (`AW-XXXXXXXXX`), etykieta konwersji zakupu, dynamiczny remarketing (opcjonalnie). - **Meta**: Pixel ID, token Conversions API, kod testowy CAPI (opcjonalnie). - **TikTok**: Pixel ID, token Events API (opcjonalnie). - **Pinterest**: Tag ID; **Snapchat**: Pixel ID; **LinkedIn**: Partner ID. - **Microsoft Advertising (UET)**: Tag ID; **X**: Pixel ID. - **Hotjar**: Site ID; **Microsoft Clarity**: Project ID. Na dole zakładki ustawienie **Dystrybucja pikseli** określa tryb: **przez Google Tag Manager** (zalecany, importujesz wygenerowany kontener) albo **wstrzykiwanie bezpośrednie** (wtyczka sama ładuje piksele). ## Tag Pilot: generowanie i import kontenera GTM Zakładka **Tag Pilot** buduje kompletny kontener Google Tag Manager na podstawie Twoich połączeń i udostępnia go do pobrania. Generuje między innymi: - tag konfiguracyjny Google GA4 oraz tag zdarzenia GA4 dla każdego włączonego zdarzenia (z wysyłką danych ecommerce z dataLayera); - Conversion Linker, konwersję zakupu i dynamiczny remarketing Google Ads; - piksel Meta i jego zdarzenia standardowe (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Search); - tagi Custom HTML dla TikToka, Pinteresta, Snapchata, LinkedIna, Microsoft UET, X, Hotjara i Clarity; - odpowiadające im Data Layer Variables i wyzwalacze zdarzeń niestandardowych. Aby go zaimportować: 1. Kliknij **Pobierz kontener GTM (.json)**. 2. W Google Tag Managerze otwórz **Administracja > Importuj kontener**. 3. Wybierz plik JSON, wskaż swój obszar roboczy, a następnie **Scal** (zachowuje istniejące tagi) albo **Nadpisz**. 4. Zrób podgląd, a następnie **Prześlij i opublikuj**. Przy istniejącym kontenerze wybieraj **Scal**, aby nie usunąć pozostałych tagów. ## Tryb piksela bezpośredniego (bez GTM) Jeśli nie chcesz zależeć od GTM, przełącz dystrybucję na **wstrzykiwanie bezpośrednie** w zakładce Połączenia. Wtyczka sama wstrzykuje wtedy podstawowe piksele (GA4, Meta i pozostałe skonfigurowane platformy) i odtwarza zdarzenia ecommerce z dataLayera do Meta, TikToka, Pinteresta, Snapchata i GA4. Ten sam dataLayer zasila oba podejścia. Nie włączaj tego samego piksela jednocześnie przez GTM _i_ we wstrzykiwaniu bezpośrednim: grozi to podwójnym zliczaniem. Wybierz jeden tryb dystrybucji dla każdej platformy. ## Server-side: Meta CAPI i GA4 Measurement Protocol W zakładce **Server-side** włącz wysyłkę zakupów bezpośrednio z Twojego serwera: - **Meta Conversions API**: wymaga Pixel ID i tokenu CAPI (zakładka Połączenia). Zdarzenie Purchase jest wysyłane z danymi klienta hashowanymi SHA-256, cookies `_fbp`/`_fbc`, adresem IP i user-agentem. - **GA4 Measurement Protocol**: wymaga Measurement ID (Połączenia) oraz **sekretu API** (GA4 > Administracja > Strumienie danych > Measurement Protocol). Przeglądarka i serwer współdzielą ten sam deterministyczny `event_id` per zamówienie (`dfgtm.purchase.`). Meta i GA4 używają tego identyfikatora, aby każdą konwersję policzyć tylko raz. Żądania server-side są wysyłane w sposób nieblokujący po płatności, przy statusach „w realizacji", „zrealizowane" lub „płatność zakończona", tylko raz na zamówienie. ## Consent Mode v2 i Enhanced Conversions Zakładka **Consent** włącza Consent Mode v2: stany zgody _denied_ są ustawiane domyślnie przed załadowaniem kontenera, z zakresem EEA/UK, `wait_for_update`, URL passthrough i redakcją danych reklamowych. Aby zaktualizować zgodę zgodnie z wyborem użytkownika, podłącz swój baner cookies do udostępnianego API JavaScript: ``` // Accept all window.dfgtmConsent.grantAll(); // Deny all window.dfgtmConsent.denyAll(); // Granular update window.dfgtmConsent.update({ ad_storage: 'granted', analytics_storage: 'granted' }); ``` **Enhanced Conversions** Google Ads (zakładka GA4 Ecommerce) dodają do zdarzenia zakupu dane klienta hashowane SHA-256, co poprawia atrybucję. ## Zdarzenia GA4 ecommerce Wtyczka wypycha następujące zdarzenia ecommerce GA4, każde włączane indywidualnie, z kompletnymi obiektami `items` (item_id z SKU lub ID, marka, kategorie do 5 poziomów, wariant, cena, rabat): - `view_item_list`, `view_item`, `select_item` - `add_to_cart`, `remove_from_cart`, `view_cart` - `begin_checkout`, `add_shipping_info`, `add_payment_info` - `purchase` (deduplikowane: wyzwalane tylko raz na zamówienie, nawet przy odświeżeniu strony), `search` ## Hooki dla deweloperów Wtyczka udostępnia filtry w kluczowych punktach, aby rozszerzać jej działanie bez modyfikowania rdzenia: - `dfgtm_export_container`: modyfikacja wygenerowanego kontenera GTM przed enkodowaniem. - `dfgtm_meta_capi_payload` i `dfgtm_ga4_mp_payload`: dostrajanie ładunków server-side. - `dfgtm_connections_registry`: dodawanie lub modyfikowanie miejsc docelowych. - `dfgtm_purchase_push` i `dfgtm_build_item`: dostosowywanie danych zakupu i budowy obiektów items. ## FAQ i rozwiązywanie problemów ### Po stronie GTM nic nie jest wstrzykiwane Sprawdź, czy identyfikator kontenera (`GTM-XXXXXXX`) jest wpisany w zakładce Ogólne i czy nie jesteś zalogowany na wykluczonej roli. DataLayer i tryb bezpośredni działają nawet bez kontenera GTM. ### Konwersje liczą się podwójnie w Meta Upewnij się, że nie ładujesz tego samego piksela jednocześnie przez kontener GTM i przez wstrzykiwanie bezpośrednie. Server-side i przeglądarka są natomiast deduplikowane automatycznie przez `event_id`: to nie jest źródło podwójnego zliczania. ### Zdarzenie zakupu nie dociera w trybie server-side Sprawdź, czy odpowiednia opcja jest włączona w zakładce Server-side i czy wymagane identyfikatory są wpisane: Pixel ID + token CAPI dla Meta, Measurement ID + sekret API dla GA4. Wysyłka następuje tylko raz na zamówienie. ### Tag GA4 nie wysyła danych ecommerce W wygenerowanym kontenerze tagi zdarzeń GA4 odczytują dane ecommerce z dataLayera. Jeśli budowałeś tagi ręcznie, włącz „Wyślij dane ecommerce" i wybierz „dataLayer" jako źródło. ### Co się dzieje przy deinstalacji? Jeśli odpowiednia opcja jest włączona w zakładce Zaawansowane, ustawienia i metadane śledzenia zamówień są usuwane. W przeciwnym razie są zachowywane na wypadek ponownej instalacji.