Custom HTML (pol. niestandardowy tag HTML) to typ tagu w Google Tag Manager, który pozwala wstawić na stronę dowolny fragment kodu HTML lub JavaScript, nieobsługiwany przez wbudowane szablony tagów. Dla marketera to najbardziej elastyczne narzędzie w kontenerze GTM, ale jednocześnie najczęstsze źródło błędów, spowolnień strony i naruszeń zgód wykrywanych podczas audytów. Zrozumienie, kiedy go używać, a kiedy zastąpić szablonem, jest kluczowe dla stabilnego pomiaru.
Jak działa tag Custom HTML w GTM?
Tag Custom HTML jest częścią kontenera webowego Google Tag Manager. Po odpaleniu reguły GTM wstrzykuje zawartość tagu do dokumentu HTML strony, a przeglądarka wykonuje umieszczony w nim skrypt z pełnymi uprawnieniami – tak, jakby kod został wpisany bezpośrednio w źródło witryny. Oznacza to, że skrypt ma dostęp do window, document, cookies i całej warstwy danych.
W przeciwieństwie do szablonów tagów (wbudowanych i społecznościowych), Custom HTML nie działa w piaskownicy. Google nie weryfikuje, co kod robi, a GTM nie wie, jakie dane wysyła i do jakich domen. Tag Custom HTML nie jest też dostępny w kontenerach serwerowych – w środowisku server-side używa się wyłącznie szablonów.
Custom HTML czy szablon tagu – porównanie
| Kryterium | Custom HTML | Szablon tagu |
|---|---|---|
| Zakres uprawnień | Pełny dostęp do strony | Ograniczony, deklarowany w uprawnieniach |
| Obsługa Consent Mode | Tylko przez ręczne „dodatkowe kontrole zgody” | Wbudowane kontrole zgody w szablonie |
| Wpływ na wydajność | Zależny od jakości kodu, często synchroniczny | Przewidywalny, kontrolowany przez GTM |
| Dostępność server-side | Brak | Tak |
| Weryfikacja w audycie | Wymaga ręcznego przeglądu kodu | Widoczna konfiguracja w interfejsie |
Kiedy warto użyć Custom HTML, a kiedy nie?
Custom HTML ma sens, gdy narzędzie nie ma własnego szablonu ani w galerii społeczności, a wdrożenie nie może czekać na przygotowanie szablonu niestandardowego. Bywa też przydatny do drobnych skryptów pomocniczych: nasłuchiwania zdarzeń na elementach strony, wypychania danych do dataLayer czy szybkiego testu hipotezy.
Nie warto sięgać po Custom HTML, gdy:
- istnieje oficjalny lub społecznościowy szablon tagu (np. dla Google Ads, GA4, większości platform reklamowych);
- tag przetwarza dane osobowe lub ustawia cookies – bez wbudowanych kontroli zgody łatwo naruszyć Consent Mode;
- kod pochodzi z nieznanego źródła lub od dostawcy, który nie udokumentował, co dokładnie wysyła;
- planowana jest migracja pomiaru na kontener serwerowy.
Najczęstsze błędy w tagach Custom HTML
- Brak powiązania ze zgodą – tag odpala się przed decyzją użytkownika, bo w ustawieniach zgody nie zdefiniowano wymaganych kategorii.
- Duplikacja skryptów – ten sam piksel wdrożony raz w kodzie strony, raz w GTM, co zawyża konwersje.
- Użycie
document.write– bez włączonej opcji obsługi w tagu skrypt psuje renderowanie strony lub nie działa. - Synchroniczne ładowanie ciężkich bibliotek – blokuje główny wątek i pogarsza Core Web Vitals.
- Brak obsługi błędów – niepoprawny JavaScript w jednym tagu może przerwać wykonanie kolejnych tagów w tym samym zdarzeniu.
- Nieopisane tagi – nazwa „Custom HTML 14” bez notatki, po latach nikt nie wie, po co istnieje.
Custom HTML w praktyce ICBM
W trakcie audytu GTM tagi Custom HTML sprawdzamy jako pierwsze, ponieważ to w nich najczęściej ukrywają się nieaktywne piksele dawnych kampanii, skrypty wysyłające dane bez zgody oraz kod spowalniający sklep. Standardową rekomendacją jest migracja do szablonów tagów tam, gdzie to możliwe, dodanie kontroli zgody do pozostałych, wprowadzenie konwencji nazewnictwa oraz przeniesienie logiki biznesowej do warstwy danych zamiast „grzebania” w DOM. Przy kampaniach Google Ads zwracamy też uwagę, by ręczne skrypty nie kolidowały z automatycznym tagowaniem. Szczegóły techniczne tagu opisuje oficjalna dokumentacja Google Tag Manager.
Najczęściej zadawane pytania
Czy tag Custom HTML respektuje Consent Mode?
Nie automatycznie. Custom HTML nie ma wbudowanych kontroli zgody, dlatego w ustawieniach tagu trzeba ręcznie wskazać kategorie zgody wymagane do odpalenia. Bez tego tag uruchomi się niezależnie od decyzji użytkownika.
Czym Custom HTML różni się od szablonu tagu?
Szablon tagu działa w piaskownicy z jawnie zadeklarowanymi uprawnieniami i wbudowaną obsługą zgody, a jego konfiguracja jest czytelna w interfejsie GTM. Custom HTML wykonuje dowolny kod bez ograniczeń, co daje elastyczność, ale przenosi całą odpowiedzialność za bezpieczeństwo i wydajność na wdrażającego.
Czy Custom HTML działa w kontenerze server-side?
Nie. Kontenery serwerowe GTM obsługują wyłącznie szablony tagów i klientów, ponieważ nie ma tam przeglądarki ani dokumentu HTML, do którego można wstrzyknąć kod. Migracja na server-side wymaga zastąpienia każdego tagu Custom HTML odpowiednim szablonem.
