![\"Te](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/gtm-namenskonvention-pl.png\")
Dlaczego nazwa jest jedynym porz\u0105dkiem<\/h2>\n
Foldery istniej\u0105 i warto ich u\u017cywa\u0107, lecz nie zmieniaj\u0105 nic w dw\u00f3ch miejscach, w kt\u00f3rych nazwa jest naprawd\u0119 czytana: w polu wyszukiwania i w odwo\u0142aniu wewn\u0105trz innego elementu. Regu\u0142a pojawia si\u0119 pod tagiem pod w\u0142asn\u0105 nazw\u0105, zmienna pojawia si\u0119 w polu pod w\u0142asn\u0105 nazw\u0105, a \u017cadne z nich nie pokazuje, w kt\u00f3rym folderze le\u017cy.<\/p>\n
Sama lista jest drugim powodem. Sortowanie jest domy\u015blnie alfabetyczne wed\u0142ug nazwy, wi\u0119c wszystko, co ma pojawia\u0107 si\u0119 razem, musi zaczyna\u0107 si\u0119 od tych samych znak\u00f3w. To warunek brzegowy, a nie upodobanie, a konwencja go pomijaj\u0105ca wytwarza nazwy opisowe i bezu\u017cyteczne.<\/p>\n
Trzeci punkt wyznacza kierunek schematu: nazwy sortuj\u0105 si\u0119 od lewej do prawej. Najwa\u017cniejsze rozr\u00f3\u017cnienie nale\u017cy wi\u0119c na prz\u00f3d, a najdrobniejszy szczeg\u00f3\u0142 na koniec. Kt\u00f3re rozr\u00f3\u017cnienie jest najwa\u017cniejsze, to jedyne pytanie warte om\u00f3wienia przed pierwsz\u0105 nazw\u0105 – dla wi\u0119kszo\u015bci kontener\u00f3w jest nim platforma, bo od niej pytanie zwykle si\u0119 zaczyna.<\/p>\n
Konwencja prze\u017cywaj\u0105ca trzysta tag\u00f3w<\/h2>\n
Wystarcz\u0105 trzy cz\u0142ony rozdzielone jednolicie. Wi\u0119cej cz\u0142on\u00f3w wygl\u0105da dok\u0142adniej i zostaje skr\u00f3cone przez tego, komu si\u0119 spieszy.<\/p>\n
Tagi <Platforma> - <Rodzaj> - <Co>\n GA4 - Event - add_to_cart\n GA4 - Config - Alle Seiten\n Meta - Event - purchase\n Sonstige - Conversion Linker\n\nReguly <Rodzaj> - <Warunek>\n CE - add_to_cart\n PV - kasse\n Klick - cta-kopfbereich\n\nZmienne <Zrodlo> - <Nazwa>\n DLV - ecommerce.items\n JS - artikelliste\n Const - GA4 Mess-ID\n LT - laendercode<\/code><\/pre>\nSkr\u00f3ty rodzaj\u00f3w regu\u0142 i zmiennych s\u0105 zamierzone. S\u0105 do\u015b\u0107 kr\u00f3tkie, by ciekawa cz\u0119\u015b\u0107 nazwy pozosta\u0142a widoczna w w\u0105skiej kolumnie, i skracaj\u0105 s\u0142owa, kt\u00f3rych u\u017cywa sam interfejs (Custom Event, Page View, Data Layer Variable) – nikt nie musi wi\u0119c uczy\u0107 si\u0119 drugiego s\u0142ownictwa.<\/p>\n
Dwie zasady trzymaj\u0105 to razem pod presj\u0105. Rozdzielnik jest zawsze ten sam – spacja, my\u015blnik, spacja – bo mieszanina my\u015blnik\u00f3w i dwukropk\u00f3w rozbija sortowanie w spos\u00f3b trudny do zauwa\u017cenia. A ostatni cz\u0142on nosi nazw\u0119 techniczn\u0105 dok\u0142adnie: tag do zdarzenia add_to_cart<\/code> nazywa si\u0119 add_to_cart<\/code>, a nie Add to Cart<\/code> – wyszukanie nazwy zdarzenia znajduje wtedy tag, regu\u0142\u0119 i zmienn\u0105 za jednym razem.<\/p>\nSprawdzenie zasobu<\/h2>\n
Eksport kontenera to plik JSON z trzema listami w \u015brodku, a sprawdzenie trzystu nazw wobec schematu jest kr\u00f3tkim skryptem, a nie popo\u0142udniem.<\/p>\n
import json, re, sys\n\nVORSATZ = {\n \"tag\": re.compile(r\"^(GA4|Meta|Ads|LinkedIn|TikTok|Sonstige) - \"),\n \"trigger\": re.compile(r\"^(CE|PV|Klick|Formular|Timer|Sichtbar|Sonstige) - \"),\n \"variable\": re.compile(r\"^(DLV|JS|Const|LT|URL|Cookie|Sonstige) - \"),\n}\n\ndaten = json.load(open(sys.argv[1]))[\"containerVersion\"]\n\nfor art, muster in VORSATZ.items():\n posten = daten.get(art, [])\n fehlt = [p[\"name\"] for p in posten if not muster.match(p[\"name\"])]\n print(f\"{art:9s} {len(posten) - len(fehlt):3d} von {len(posten):3d} nach Schema\")\n for name in sorted(fehlt):\n print(f\" {name}\")<\/code><\/pre>\nZ pierwszego przebiegu wychodz\u0105 zwykle dwie trzecie zgodne ze schematem i jedna trzecia niezgodna – a ta jedna trzecia rozpada si\u0119 na trzy grupy wymagaj\u0105ce odmiennego potraktowania.<\/p>\n
Nazwy po prostu stare po zmianie nazwy trzymaj\u0105 si\u0119 schematu i nic wi\u0119cej si\u0119 nie dzieje. Nazwy opisuj\u0105ce co\u015b, co nie jest ju\u017c w u\u017cyciu – tag dla porzuconej platformy – s\u0105 osobnym znaleziskiem i nale\u017c\u0105 na list\u0119 do skasowania, a nie do przemianowania. A nazwy z osob\u0105 albo dat\u0105 w \u015brodku – Test Anna 03.02.<\/code> – to te do obejrzenia w pierwszej kolejno\u015bci, bo zwykle oznaczaj\u0105 co\u015b, co nigdy nie mia\u0142o zosta\u0107.<\/p>\nZmiana nazw bez rozerwania odwo\u0142ania<\/h2>\n
Tutaj siedzi nier\u00f3wno\u015b\u0107 i to ona jest powodem, dla kt\u00f3rego masowa zmiana nazw wymaga sprawdzenia krzy\u017cowego.<\/p>\n
Tagi i regu\u0142y s\u0105 wewn\u0119trznie adresowane numerem. Zmiana ich nazw nie zmienia niczego w innym miejscu, a regu\u0142a uruchamiaj\u0105ca tag robi to dalej pod ka\u017cd\u0105 nazw\u0105.<\/p>\n
Przy zmiennych jest inaczej, bo zmienn\u0105 adresuje si\u0119 jej nazw\u0105 w podw\u00f3jnych nawiasach klamrowych. GTM przy zmianie nazwy uzupe\u0142nia te odwo\u0142ania w ca\u0142ym kontenerze – pole z {{DLV - artikel}}<\/code> idzie razem, a wed\u0142ug zgodnych \u017ar\u00f3de\u0142 bran\u017cowych tak\u017ce nawiasy zapisane jako tekst w tagu HTML niestandardowym albo w zmiennej JavaScript niestandardowej. Pomoc Google tego zachowania nie opisuje; czy zadzia\u0142a\u0142o w danym kontenerze, pokazuje por\u00f3wnanie przed i po.<\/p>\n# znalezc wszystkie odwolania nazwowe w eksporcie przed zmiana nazw\ngrep -o '{{[^}]*}}' export.json | sort | uniq -c | sort -rn | head -30<\/code><\/pre>\nPuszczenie tego przed i po jest ca\u0142\u0105 siatk\u0105 bezpiecze\u0144stwa. Lista adresowanych nazw powinna by\u0107 identyczna poza tymi celowo zmienionymi, a ka\u017cda niezamierzona r\u00f3\u017cnica to odwo\u0142anie prowadz\u0105ce teraz w pr\u00f3\u017cni\u0119 – co GTM przy podgl\u0105dzie i publikacji zg\u0142asza jako b\u0142\u0105d \u201eUnknown variable\u201d.<\/p>\n
Wykonanie w jednym obszarze roboczym<\/h2>\n
Zmiana nazw dwustu element\u00f3w to jedna zmiana z dwustoma wpisami i nale\u017cy do w\u0142asnego obszaru roboczego z trzech powod\u00f3w.<\/p>\n
Powstaj\u0105ca z niej wersja jest pojedynczym wpisem w historii kontenera – i dok\u0142adnie tego potrzebuje kole\u017canka ogl\u0105daj\u0105ca list\u0119 zmian za p\u00f3\u0142 roku. Obszar roboczy dzielony przez zmian\u0119 nazw ze zmian\u0105 merytoryczn\u0105 czyni obie trudniejszymi do sprawdzenia i niemo\u017cliwymi do osobnego wycofania.<\/p>\n
Podgl\u0105d dzia\u0142a wewn\u0105trz obszaru roboczego dalej, wi\u0119c ca\u0142y kontener da si\u0119 przed publikacj\u0105 raz przej\u015b\u0107 – a przej\u015b\u0107 nale\u017cy celowo ka\u017cdy niestandardowy tag HTML, bo tam odwo\u0142ania stoj\u0105 w kodzie jako ci\u0105gi znak\u00f3w i tam wida\u0107, czy zmiana nazwy je obj\u0119\u0142a.<\/p>\n
A kontener da si\u0119 wyeksportowa\u0107 z obszaru roboczego przed publikacj\u0105, co daje plik do por\u00f3wnania z poprzednim. Dwa eksporty, jeden grep<\/code> i pytanie, czy co\u015b si\u0119 rozpad\u0142o, zostaje rozstrzygni\u0119te bez zgadywania.<\/p>\nUtrzymanie tego stanu<\/h2>\n
Konwencja rozpada si\u0119 w tempie, w jakim ludzie w po\u015bpiechu co\u015b dodaj\u0105, a trzy nawyki hamuj\u0105 to mocniej ni\u017c dokument.<\/p>\n
Skrypt sprawdzaj\u0105cy nale\u017cy tam, gdzie dzia\u0142a sam z siebie. Raz w miesi\u0105cu wobec \u015bwie\u017cego eksportu wystarczy, a wynik jest kr\u00f3tki: albo wszystko pasuje, albo wymienia trzy elementy do\u0142o\u017cone od ostatniego przebiegu.<\/p>\n
Schemat nale\u017cy do kontenera, a nie do wiki. Element notatkowy – tag, kt\u00f3ry nigdy nie dzia\u0142a, nazwany 0 - Namensschema<\/code>, aby sortowa\u0142 si\u0119 na g\u00f3r\u0119 – niesie konwencj\u0119 tam, gdzie osoba w\u0142a\u015bnie co\u015b nazywaj\u0105ca i tak patrzy.<\/p>\nA list\u0119 do skasowania z przegl\u0105du warto odrobi\u0107, zamiast od\u0142o\u017cy\u0107. Kontener z czterdziestoma wstrzymanymi tagami, kt\u00f3rych nikt nie rozpoznaje, to kontener, w kt\u00f3rym konwencja zostanie znowu pomini\u0119ta, bo lista jest ju\u017c nieczytelna – a najszybsz\u0105 drog\u0105 do listy czytelnej jest lista kr\u00f3tsza.<\/p>\n
\nPytania i odpowiedzi<\/h2>\nCzy zmienne dostarczane przez sam GTM, takie jak Page URL, te\u017c musz\u0105 trzyma\u0107 si\u0119 schematu?<\/h3>\n
Nie, i nawet nie mog\u0105. Zmienne wbudowane (Built-in Variables), takie jak Page URL czy Click Classes, nosz\u0105 nazwy nadane przez Google; da si\u0119 je w\u0142\u0105cza\u0107 i wy\u0142\u0105cza\u0107, ale nie da si\u0119 zmieni\u0107 ich nazw. W eksporcie kontenera znajduj\u0105 si\u0119 na osobnej li\u015bcie builtInVariable<\/code>, a nie pod variable<\/code>, wi\u0119c skrypt sprawdzaj\u0105cy sam je pomija. Na li\u015bcie odwo\u0142a\u0144 z grep wprawdzie si\u0119 pojawiaj\u0105, ale przed zmian\u0105 nazw i po niej pozostaj\u0105 takie same i nie zak\u0142\u00f3caj\u0105 por\u00f3wnania.<\/p>\nCzy comiesi\u0119czne sprawdzenie da si\u0119 uruchamia\u0107 bez ka\u017cdorazowego r\u0119cznego eksportu kontenera?<\/h3>\n
Tak, przez Tag Manager API. Zwraca ono opublikowan\u0105 wersj\u0119 kontenera z tymi samymi listami tag<\/code>, trigger<\/code> i variable<\/code>, kt\u00f3re zawiera eksport. R\u00f3\u017cnica le\u017cy w opakowaniu: eksport z interfejsu umieszcza wersj\u0119 pod kluczem containerVersion<\/code>, a odpowied\u017a API jest sam\u0105 wersj\u0105. Skrypt wymaga wi\u0119c jedynie drobnej zmiany w miejscu, w kt\u00f3rym wczytuje plik.<\/p>\nDo dost\u0119pu wystarczy konto us\u0142ugi z uprawnieniem do odczytu (Read) kontenera i zakres tagmanager.readonly<\/code>. Uprawnienia do zapisu s\u0105 przy sprawdzaniu zb\u0119dne i lepiej, \u017ceby ich nie by\u0142o: zadanie, kt\u00f3re niczego nie mo\u017ce zmieni\u0107, niczego te\u017c nie zepsuje. Konto us\u0142ugi dodaje si\u0119 w zarz\u0105dzaniu u\u017cytkownikami kontenera przez podanie jego adresu e-mail, tak samo jak osob\u0119.<\/p>\nPozostaje jedna r\u00f3\u017cnica w por\u00f3wnaniu z eksportem: opublikowana wersja nie pokazuje tego, co w\u0142a\u015bnie powstaje w otwartych obszarach roboczych. Sprawdzenie tak\u017ce nieopublikowanych nazw wymaga dodatkowego odczytu obszar\u00f3w roboczych, kt\u00f3re API r\u00f3wnie\u017c udost\u0119pnia.<\/p>\n
Czy przy kontenerze obs\u0142uguj\u0105cym kilka witryn na pocz\u0105tek nazwy powinna trafi\u0107 witryna?<\/h3>\n
Tylko wtedy, gdy wi\u0119kszo\u015b\u0107 pyta\u0144 kierowanych do kontenera zaczyna si\u0119 od witryny. Platforma stoi na pocz\u0105tku, bo od niej zwykle zaczyna si\u0119 wyszukiwanie; przy kontenerze dla kilku witryn tym punktem wyj\u015bcia mo\u017ce by\u0107 witryna. Liczy si\u0119 to, \u017ceby wyb\u00f3r zapad\u0142 raz i obowi\u0105zywa\u0142 wszystkie elementy, bo schemat zaczynaj\u0105cy si\u0119 raz od platformy, a raz od witryny, rozbija sortowanie tak samo jak mieszane rozdzielniki.<\/p>\n<\/div>\n