Podział ról: co robi platforma, a co zostaje w konsoli GTM
Google Tag Manager to kontener na tagi, a nie narzędzie pomiarowe. Dlatego zakres integracji jest celowo wąski. Platforma robi trzy rzeczy: ładuje właściwy kontener w storefroncie właściwego kanału, wypycha na dataLayer stały zestaw zdarzeń handlowych i, jeśli tego chcesz, dostarcza te zdarzenia z backendu do kontenera serwerowego.
Nie odwzorowuje natomiast tagów, reguł ani zmiennych i nie decyduje, do jakich dostawców Twój kontener wysyła dane. To zostaje po stronie zespołu marketingu lub agencji.
Konfiguracja per kanał sprzedaży
Integracja nie ma własnego ekranu w panelu. Całość to sześć ustawień w grupie „Google Tag Manager” na ogólnym ekranie ustawień, każde z możliwością nadpisania dla pojedynczego kanału sprzedaży: przełącznik główny, identyfikator kontenera, wymóg zgody, przełącznik tagowania serwerowego oraz adres i ścieżka kontenera serwerowego. Dostęp regulują standardowe uprawnienia do odczytu i zapisu ustawień, a zmiany trafiają do dziennika audytu.
Kanał jest śledzony tylko wtedy, gdy przełącznik jest włączony, a identyfikator ma postać GTM-XXXXXXX. Pusty lub błędny identyfikator oznacza „nie skonfigurowano”, a nie uszkodzony skrypt na stronie, więc wyczyszczenie pola to bezpieczny sposób na wstrzymanie pomiaru w jednym kanale. Zmiana działa od razu, bez wdrożenia.
Po stronie Google potrzebujesz konta GTM i kontenera typu web z jego identyfikatorem, a dla tagowania serwerowego dodatkowo działającego kontenera serwerowego.
Słownik zdarzeń na warstwie danych
Tagi wyzwalasz na poniższych zdarzeniach niestandardowych. Parametr items ma kształt pozycji rekomendowany przez GA4 (item_id, item_name, price, quantity) i jest przekazywany jako ciąg JSON.
| Zdarzenie | Kiedy |
|---|---|
page_view | wyświetlenie strony |
view_search_results | wyniki wyszukiwania |
view_item | karta produktu |
add_to_cart | dodanie do koszyka |
add_to_quote_request | dodanie pozycji do zapytania ofertowego |
add_to_shopping_list | dodanie do listy zakupowej |
begin_checkout | rozpoczęcie checkoutu |
place_order_clicked | kliknięcie złożenia zamówienia |
purchase | złożone zamówienie |
contact_form_submitted | wysłany formularz kontaktowy |
Ładunki zawierają wyłącznie wartości skalarne, więc załącznik z formularza nigdy się w nich nie znajdzie.
Dwie rzeczy, o które najłatwiej się potknąć:
- Nie używaj reguły History Change. Storefront wypycha dokładnie jedno
page_viewna każdą stronę docelową, także przy nawigacji bez przeładowania dokumentu. Wbudowana reguła zmiany historii policzy każde przejście drugi raz. - Jedna ścieżka do GA4 na kanał. Tag GA4 w kontenerze i natywna integracja Google Analytics 4 włączone w tym samym kanale raportują te same akcje, więc metryki się podwajają. Platforma nie widzi wnętrza Twojego kontenera i tego nie zablokuje: wybierz jedną drogę.
Głębokość przewijania, kliknięcia linków wychodzących, pobrania plików, widoczność elementów i timery pozostają domeną samego kontenera. Platforma ich nie publikuje, bo zależą od stanu przeglądarki.
Zgoda i Consent Mode v2
Zgoda to jedna decyzja storefrontu, wspólna z GA4, Meta Ads i LinkedIn Ads: jeden baner i jedna zapisana odpowiedź. Przy włączonym wymogu zgody (ustawienie domyślne):
- Przed załadowaniem kontenera strona ustawia domyślne stany Consent Mode v2 na
denieddlaanalytics_storage,ad_storage,ad_user_dataiad_personalization. - Kontener mimo to się ładuje. Jego wstrzymanie wyłączyłoby po cichu także te tagi, które zgody nie wymagają.
- Platforma nie wysyła żadnych własnych zdarzeń, dopóki odwiedzający nie zaakceptuje.
- Akceptacja w trakcie sesji przekazuje do kontenera aktualizację zgody i uruchamia zdarzenia bez przeładowania strony.
Ważne zastrzeżenie: Consent Mode steruje tagami Google. Tag Meta, LinkedIn czy własny tag HTML umieszczony w kontenerze uruchomi się niezależnie od stanu zgody, o ile nie dodasz mu w konsoli GTM dodatkowego warunku. Odpowiada za to właściciel kontenera.
Tagowanie serwerowe: jedna droga na zdarzenie
Po włączeniu tagowania serwerowego i podaniu adresu kontenera dziesięć zdarzeń z tabeli przestaje trafiać na dataLayer w przeglądarce i jest dostarczane z backendu platformy. Każde zdarzenie raportowane jest dokładnie raz, nigdy dwiema drogami naraz, bo podwójne odpalenie po cichu zawyża liczbę zakupów i przychód w każdym raporcie dalej w łańcuchu. Pusty adres kontenera zostawia kanał na ścieżce przeglądarkowej nawet przy włączonym przełączniku.
Storefront przekazuje zdarzenia do kolejki, a osobny proces wysyła je do kontenera i ponawia nieudane próby: osiem razy, z rosnącym odstępem. Wywołanie nie odbywa się w ramach żądania kupującego, więc wolny lub niedostępny kontener nie spowalnia sklepu. Wyczerpane próby zostają widoczne jako nieudane zadania.
Co trzeba zrobić po swojej stronie:
- uruchomić kontener serwerowy i dodać w nim klienta, który przejmuje skonfigurowaną ścieżkę (domyślnie
/data), - odbudować w kontenerze serwerowym tagi, które w kontenerze web wyzwalały się na zdarzeniach handlowych,
- parsować
itemsjako JSON i deduplikować poevent_id, który jest stały między ponowieniami, - obsłużyć brak adresu IP i identyfikatora przeglądarki: przy odmowie zgody nie są przesyłane.
Żądanie niesie wyłącznie parametry zdarzenia, kontekst strony, identyfikator klienta, stan zgody i identyfikator zdarzenia. Nie zawiera adresu e‑mail, identyfikatora użytkownika ani organizacji, adresu pocztowego ani haszowanych identyfikatorów.
Czego integracja jeszcze nie obejmuje
Serwowanie skryptu gtm.js z własnej domeny przez kontener serwerowy oraz przekazywanie user_id i konwersji rozszerzonych nie są obecnie zaimplementowane. Jeśli kontener ich potrzebuje, uzupełniasz dane po swojej stronie.