Tutorial: Przygotowywanie i weryfikacja zmian w Google Tag Manager za pomocą Claude Code

Zmiany w Google Tag Managerze (GTM) w kodzie są zwykle niewielkie, za to ich skutki bywają poważne. Literówka w warunku triggera, zdublowany tag albo klucz data layer niepasujący do tego, co faktycznie wysyła witryna, potrafi po cichu zepsuć śledzenie konwersji na wiele tygodni, zanim ktokolwiek to zauważy. Claude Code, agentowe narzędzie do programowania od Anthropic, nie łączy się bezpośrednio z GTM; wbudowana integracja z Google nie istnieje. Mimo to dobrze sprawdza się w pracy wokół zmiany w GTM: przy odczycie wyeksportowanego kontenera, przygotowywaniu lub sprawdzaniu tagów Custom HTML, porównywaniu implementacji data layer z tym, czego faktycznie oczekuje dany tag, oraz przy dokumentowaniu, co się zmieniło i dlaczego.

Poniższy przegląd pokazuje, czym faktycznie jest Claude Code, co aplikacja desktopowa na Windows 11 dodaje ponad narzędzie wiersza poleceń, oraz konkretny sposób wykorzystania go wokół wdrożenia w GTM.

Czym jest Claude Code

Claude Code to agentowe narzędzie do programowania: odczytuje lokalny katalog z kodem lub projektem, edytuje pliki, uruchamia polecenia powłoki i wywołuje zewnętrzne narzędzia za pośrednictwem Model Context Protocol (MCP). Występuje w kilku formach — jako CLI terminalowe (macOS, Linux oraz Windows przez PowerShell lub Git Bash), jako aplikacja desktopowa dla macOS i Windows, jako rozszerzenie do VS Code i środowisk JetBrains, a także jako wersja przeglądarkowa pod adresem claude.ai/code. Żadna z tych form nie zawiera natywnego łącznika do Google Tag Managera; każde zadanie związane z GTM przechodzi przez ogólne możliwości, takie jak dostęp do plików, skryptowanie i automatyzacja przeglądarki, a nie przez dedykowaną wtyczkę.

Claude Code for Desktop na Windows 11

Na Windows 11 aplikacja desktopowa dokłada warstwę graficzną nad tym samym agentem: edytor plików, wbudowany terminal, widok różnic (diff) dla każdej proponowanej zmiany oraz panel podglądu przeglądarki do testowania stron bez opuszczania aplikacji. Do działania narzędzia Bash wymagany jest Git for Windows; bez niego aplikacja korzysta z PowerShell. Do pracy lokalnej instalacja WSL nie jest potrzebna, choć istniejącą już dystrybucję WSL2 da się podpiąć jako środowisko.

Dla pracy związanej z trackingiem szczególnie istotne są dwie rzeczy: tryby uprawnień oraz panel przeglądarki. Tryby uprawnień obejmują zakres od ręcznego zatwierdzania każdej pojedynczej zmiany pliku i każdego polecenia aż po tryb planowania, w którym zamierzone zmiany zostają najpierw przedstawione, zanim cokolwiek zostanie ruszone — przydatne, gdy skrypt ma za chwilę zmodyfikować eksport kontenera albo wywołać API GTM. Panel przeglądarki pozwala otworzyć stronę testową, sprawdzić żądania sieciowe i data layer oraz zweryfikować, czy tag faktycznie się odpala — wszystko w tym samym oknie, w którym powstaje kod tagu.

Gdzie Claude Code pasuje do zmiany w GTM

Wdrożenie w GTM składa się zwykle z trzech luźno powiązanych elementów: konfiguracji kontenera, kodu udostępnianego przez witrynę (data layer, elementy DOM albo endpoint REST) oraz celu, do którego tag wysyła dane. Claude Code przydaje się przy pierwszych dwóch elementach oraz na styku między nimi:

• Odczyt wyeksportowanego kontenera (Container.json z funkcji eksportu GTM albo odpowiedź API GTM) i podsumowanie tagów, triggerów oraz zmiennych w zrozumiałej formie, co ułatwia wychwycenie niemal-duplikatów lub niespójnego nazewnictwa.
• Przygotowanie lub sprawdzenie kodu JavaScript wewnątrz tagu Custom HTML albo Custom Template, łącznie z przypadkami brzegowymi, jak klucz data layer, który jeszcze się nie pojawił.
• Porównanie tego, czego oczekuje warunek triggera, z tym, co faktycznie wysyła data layer witryny — za pomocą panelu przeglądarki albo przeglądarki podłączonej przez MCP na stronie produkcyjnej lub testowej.
• Napisanie niewielkich skryptów wobec API GTM (z kontem usługi) do eksportu kontenera, porównania dwóch wersji albo wyszukania tagów bez pasującego triggera — nic z tego nie jest wbudowane, więc sam skrypt jest pisany i sprawdzany jak każdy inny kod.
• Przygotowanie dokumentacji: krótkiej strony markdown wypisującej, co robi dany tag, od jakich kluczy data layer zależy i dlaczego trigger ma taki, a nie inny zakres — tak, żeby kolejna osoba dotykająca kontenera nie musiała go odtwarzać od zera.

Konkretny przykład: sprawdzenie tagu Custom HTML

Częstym zadaniem jest weryfikacja tagu Custom HTML przed jego uruchomieniem na produkcji — na przykład tagu, który odczytuje zmienną data layer i przekazuje ją dalej tylko wtedy, gdy wartość wygląda na poprawną. Przy sprawdzaniu takiego tagu Claude Code potrafi wskazać dokładnie ten rodzaj błędu, który łatwo przeoczyć przy kopiowaniu fragmentu kodu z forum:

<script>
(function() {
  var dl = window.dataLayer || [];
  var lastEvent = dl[dl.length - 1] || {};
  var orderId = lastEvent.order_id;

  if (typeof orderId === 'string' && orderId.length > 0) {
    gtag('event', 'purchase_confirmed', { order_id: orderId });
  }
})();
</script>

Odczyt data layer przez dl[dl.length - 1] psuje się po cichu, gdy między eventem zakupu a odpaleniem tego tagu jakiś inny tag wypchnie kolejny event — wtedy tag odczytuje niewłaściwy obiekt. Przegląd wychwyciłby to i zaproponował odczyt wartości ze zmiennej data layer skonfigurowanej w GTM, która nie zależy od pozycji w tablicy. Wyłapanie tego rodzaju założenia o kolejności zdarzeń przed publikacją to dokładnie ten typ sprawdzenia, który łatwo zautomatyzować wokół GTM, ale którego sam interfejs GTM nie sygnalizuje.

Pozostając w granicach

Dwie rzeczy nie zmieniają się niezależnie od tego, jak zorganizowany jest cały proces. Po pierwsze, publikacja pozostaje ręcznym, ludzkim działaniem. Claude Code może przygotować eksport kontenera, wygenerować JSON dla nowego tagu albo napisać skrypt wywołujący API GTM. Sam klik w „Opublikuj”, albo wywołanie API, które go uruchamia, pozostaje świadomym krokiem osoby odpowiedzialnej za konto – najlepiej po sprawdzeniu zmiany w natywnym trybie podglądu GTM. Po drugie, wszystko, co Claude Code zdaje się „wiedzieć” o konkretnym koncie GTM, pochodzi wyłącznie z tego, co zostało jawnie przekazane w danej sesji — wyeksportowany plik, wklejony fragment kodu albo strona otwarta w panelu przeglądarki — a nie z trwałego połączenia z samym kontem.

Używany w ten sposób Claude Code nie zastępuje interfejsu GTM ani jego trybu podglądu i debugowania; zdejmuje warstwę ręcznego odczytywania i pracy typu kopiuj-wklej wokół niego — na kontenerze, który nadal sprawdza i publikuje człowiek.