Strona główna / Poradniki

Zamiana przechwyconych pushy dataLayer w kontener GTM gotowy do importu

Co musi zawierać plik eksportu kontenera, które dwa pola sprawiają, że GTM odrzuca cały import, i dlaczego placeholdery biją puste pola.

Opublikowano 12 sierpnia 2026 · Autor: hsynkvlc

Widziałeś, jak strona wypycha purchase z ośmioma parametrami. Teraz ktoś musi utworzyć osiem zmiennych Data Layer, regułę Custom Event i tag, który je wszystkie łączy — ręcznie, w formularzu, raz na każde zdarzenie. GTM przyjmie to również jako plik, a plik przestaje być skomplikowany, gdy zobaczysz jeden.

Trzy elementy

Eksport kontenera to JSON z exportFormatVersion, kopertą containerVersion i trzema tablicami w środku: zmienne, reguły i tagi. Identyfikatory konta i kontenera mogą być 0 — ekran importu mapuje plik na ten kontener, do którego importujesz, więc liczby w pliku są z założenia placeholderami.

• Zmienna Data Layer na każdą ścieżkę: typ v, z dataLayerVersion: 2 i ścieżką jako nazwą. Jedna na unikalną ścieżkę, niezależnie od tego, ile zdarzeń jej używa — to samo ecommerce.value nie powinno stać się czterema zmiennymi.
• Reguła Custom Event na każde zdarzenie: typ CUSTOM_EVENT, z filtrem mówiącym, że {{_event}} równa się nazwie zdarzenia.
• Tag na każde zdarzenie, z firingTriggerId wskazującym identyfikator tej reguły. Identyfikatory to po prostu ciągi, które nadajesz; muszą być spójne tylko wewnątrz pliku.

Dwa pola, przez które cały import pada

To jest część warta biletu, bo błąd działa na zasadzie wszystko albo nic: GTM odrzuca plik, zamiast zaimportować to, co się da.

Tag zdarzenia GA4 z pustym identyfikatorem pomiaru. Błąd podaje dokładną ścieżkę:

• containerVersion.tag[0].vendorTemplate.parameter.measurementIdOverride: The value must not be empty.

Za tym kryje się pułapka. Starszy model polegał na wskazaniu tagu konfiguracyjnego po nazwie i wiele poradników wciąż tak to opisuje. Nie to waliduje obecny szablon — chce wypełnionego measurementIdOverride, a tag zdarzenia napisany po staremu się nie zaimportuje.

Tag konwersji Ads z pustym identyfikatorem lub etykietą. To samo zachowanie, ta sama odmowa. Szablon chce też identyfikatora jako gołej liczby — 993214470, nie AW-993214470 — i etykiety złożonej wyłącznie z liter i cyfr.

Placeholder bije puste pole

Odruch, gdy nie znasz identyfikatora, to zostawić pusto, zamiast coś wymyślać. Przy tym pliku ten odruch daje najgorszy możliwy wynik: nic się nie importuje, więc nie ma nawet tagu, który można by poprawić.

Placeholder w odpowiednim kształcie — G-XXXXXXXXXX, 000000000 — importuje się czysto i zostawia Ci w kontenerze tag z jednym oczywiście błędnym polem. To poprawka na dwie sekundy zamiast odrzuconego pliku.

Jeszcze lepiej nie zgadywać wcale. Identyfikatory da się odczytać ze strony, na której właśnie byłeś: identyfikator pomiaru to tid w wysłanych trafieniach GA4, a identyfikator i etykieta konwersji Ads to konto oraz parametr label w żądaniu konwersji. Gdy strona ma więcej niż jedną usługę GA4, chodzi o tę, która wysyła najwięcej trafień.

Mapowanie parametrów bez myślenia

Dwie drobne zasady załatwiają większość. W tagu zdarzenia GA4 nazwą parametru jest to, co następuje po ostatniej kropce w ścieżce, więc ecommerce.value staje się parametrem value. Przy konwersji Ads liczą się tylko trzy pola — wartość, waluta i identyfikator zamówienia — a dopasowanie po końcówce ścieżki sprawia, że i ecommerce.value, i samo value trafiają we właściwe miejsce.

Zaimportuj, ale przeczytaj różnicę

Import w GTM ma dwa tryby i różnica nie jest subtelna. Merge dokłada do tego, co jest; overwrite zastępuje obszar roboczy plikiem, co na prawdziwym kontenerze jest sposobem na utratę mnóstwa pracy jednym kliknięciem.

Importuj do nowego obszaru roboczego, wybierz merge i przeczytaj podgląd, zanim potwierdzisz: GTM wypisuje dokładnie, co zostanie dodane, zmienione i usunięte. Każda rzecz wygenerowana zasługuje na to spojrzenie — także plik wygenerowany z ruchu Twojej własnej strony.

Czego to nie robi

Daje tagi uruchamiane na właściwych zdarzeniach z właściwymi parametrami. Nie zna Twojej konwencji nazewniczej, struktury folderów, ustawień zgód ani tego, które z tych zdarzeń naprawdę mają iść na produkcję. Potraktuj to jako odrobione za Ciebie nudne 80%, nie jako gotowe wdrożenie.

Powiązane poradniki

• Jedno kliknięcie, trzy pushe: wybór właściwego zdarzenia dataLayer
• Jak debugować server-side GTM
• Debugowanie Consent Mode V2: gcs, gcd i naruszenia, których nikt nie łapie