Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z Google Tag Manager

Endora Commerce ładuje Twój kontener Google Tag Manager osobno w każdym kanale sprzedaży i publikuje na warstwie danych udokumentowany słownik zdarzeń handlowych, w tym zdarzenia typowe dla B2B, takie jak dodanie pozycji do zapytania ofertowego. Tagi, reguły i zmienne nadal budujesz w konsoli GTM.

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.

ZdarzenieKiedy
page_viewwyświetlenie strony
view_search_resultswyniki wyszukiwania
view_itemkarta produktu
add_to_cartdodanie do koszyka
add_to_quote_requestdodanie pozycji do zapytania ofertowego
add_to_shopping_listdodanie do listy zakupowej
begin_checkoutrozpoczęcie checkoutu
place_order_clickedkliknięcie złożenia zamówienia
purchasezłożone zamówienie
contact_form_submittedwysł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_view na 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 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):

  1. Przed załadowaniem kontenera strona ustawia domyślne stany Consent Mode v2 na denied dla analytics_storage, ad_storage, ad_user_data i ad_personalization.
  2. Kontener mimo to się ładuje. Jego wstrzymanie wyłączyłoby po cichu także te tagi, które zgody nie wymagają.
  3. Platforma nie wysyła żadnych własnych zdarzeń, dopóki odwiedzający nie zaakceptuje.
  4. 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ć items jako JSON i deduplikować po event_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.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.