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, 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.

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).

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.

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.

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.<id>). Meta i GA4 używają tego identyfikatora, aby każdą konwersję policzyć tylko raz.

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.