![\"Dieselben](\"https:\/\/www.lukaswojcik.com\/blog\/wp-content\/uploads\/diagrams\/gtm-namenskonvention-de.png\")
Warum der Name die einzige Ordnung ist<\/h2>\n
Ordner gibt es, und sie lohnen sich, aber sie \u00e4ndern nichts an den beiden Stellen, an denen ein Name tats\u00e4chlich gelesen wird: dem Suchfeld und dem Verweis innerhalb eines anderen Elements. Ein Ausl\u00f6ser erscheint unter einem Tag mit seinem Namen, eine Variable erscheint in einem Feld mit ihrem Namen, und keines von beidem zeigt, in welchem Ordner es liegt.<\/p>\n
Die Liste selbst ist der zweite Grund. Sortiert wird standardm\u00e4\u00dfig alphabetisch nach Name, alles, was zusammen erscheinen soll, muss also mit denselben Zeichen beginnen. Das ist eine Rahmenbedingung und keine Vorliebe, und eine Konvention, die sie \u00fcbergeht, erzeugt Namen, die beschreibend und nutzlos sind.<\/p>\n
Ein dritter Punkt legt die Richtung des Schemas fest: Namen sortieren von links nach rechts. Die wichtigste Unterscheidung geh\u00f6rt deshalb nach vorn und die feinste Angabe nach hinten. Welche Unterscheidung die wichtigste ist, ist die eine Frage, die sich vor dem ersten Namen zu besprechen lohnt – f\u00fcr die meisten Container ist es die Plattform, denn von dort aus beginnt eine Frage \u00fcblicherweise.<\/p>\n
Eine Konvention, die dreihundert Tags \u00fcbersteht<\/h2>\n
Drei Abschnitte, einheitlich getrennt, gen\u00fcgen. Mehr Abschnitte sehen genauer aus und werden von dem abgek\u00fcrzt, der es eilig hat.<\/p>\n
Tags <Plattform> - <Art> - <Was>\n GA4 - Event - add_to_cart\n GA4 - Config - Alle Seiten\n Meta - Event - purchase\n Sonstige - Conversion Linker\n\nAusloeser <Art> - <Bedingung>\n CE - add_to_cart\n PV - kasse\n Klick - cta-kopfbereich\n\nVariablen <Quelle> - <Name>\n DLV - ecommerce.items\n JS - artikelliste\n Const - GA4 Mess-ID\n LT - laendercode<\/code><\/pre>\nDie K\u00fcrzel f\u00fcr Ausl\u00f6ser- und Variablenarten sind Absicht. Sie sind kurz genug, dass der interessante Teil des Namens in einer schmalen Spalte sichtbar bleibt, und sie k\u00fcrzen die W\u00f6rter ab, die die Oberfl\u00e4che selbst verwendet (Custom Event, Page View, Data Layer Variable) – niemand muss also ein zweites Vokabular lernen.<\/p>\n
Zwei Regeln halten das unter Druck zusammen. Der Trenner ist immer derselbe – Leerzeichen, Bindestrich, Leerzeichen -, denn eine Mischung aus Bindestrichen und Doppelpunkten zerlegt die Sortierung auf eine schwer sichtbare Weise. Und der letzte Abschnitt tr\u00e4gt den technischen Namen genau: Ein Tag f\u00fcr das Ereignis add_to_cart<\/code> hei\u00dft add_to_cart<\/code> und nicht Add to Cart<\/code> – eine Suche nach dem Ereignisnamen findet damit Tag, Ausl\u00f6ser und Variable in einem Zug.<\/p>\nDen Bestand pr\u00fcfen<\/h2>\n
Der Container-Export ist eine JSON-Datei mit drei Listen darin, und dreihundert Namen gegen ein Schema zu pr\u00fcfen ist ein kurzes Skript statt eines Nachmittags.<\/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>\nWas bei einem ersten Lauf herauskommt, sind meist zwei Drittel nach Schema und ein Drittel nicht – und dieses Drittel zerf\u00e4llt in drei Gruppen, die verschieden zu behandeln sind.<\/p>\n
Namen, die schlicht alt sind, folgen nach einer Umbenennung dem Schema, und weiter geschieht nichts. Namen, die etwas beschreiben, das nicht mehr im Einsatz ist – ein Tag f\u00fcr eine aufgegebene Plattform -, sind ein eigener Befund und geh\u00f6ren auf die Liste zum L\u00f6schen statt zum Umbenennen. Und Namen mit einer Person oder einem Datum darin – Test Anna 03.02.<\/code> – sind die, die zuerst anzusehen sind, denn sie kennzeichnen meist etwas, das nie bleiben sollte.<\/p>\nUmbenennen, ohne einen Verweis zu zerrei\u00dfen<\/h2>\n
Hier sitzt die Ungleichheit, und sie ist der Grund, warum eine Massenumbenennung eine Gegenprobe braucht.<\/p>\n
Tags und Ausl\u00f6ser werden intern \u00fcber eine Nummer angesprochen. Sie umzubenennen \u00e4ndert an keiner anderen Stelle etwas, und ein Ausl\u00f6ser, der ein Tag ausl\u00f6st, tut das unter jedem Namen weiter.<\/p>\n
Bei Variablen ist es anders, denn eine Variable wird \u00fcber ihren Namen in doppelten geschweiften Klammern angesprochen. GTM zieht diese Verweise bei einer Umbenennung im ganzen Container nach – ein Feld mit {{DLV - artikel}}<\/code> geht mit, und nach \u00fcbereinstimmenden Fachquellen auch die Klammern, die als Text in einem benutzerdefinierten HTML-Tag oder einer benutzerdefinierten JavaScript-Variablen stehen. In Googles Hilfe ist dieses Verhalten nicht beschrieben; ob es im eigenen Container gegriffen hat, zeigt ein Vergleich vorher und nachher.<\/p>\n# alle Namensverweise im Export finden, bevor umbenannt wird\ngrep -o '{{[^}]*}}' export.json | sort | uniq -c | sort -rn | head -30<\/code><\/pre>\nDas vorher und nachher laufen zu lassen ist das ganze Sicherungsnetz. Die Liste der angesprochenen Namen sollte bis auf die absichtlich ge\u00e4nderten identisch sein, und jeder unbeabsichtigte Unterschied ist ein Verweis, der jetzt ins Leere geht – was GTM beim Vorschauen und Ver\u00f6ffentlichen als Fehler \u201eUnknown variable\u201c meldet.<\/p>\n
In einem Arbeitsbereich erledigen<\/h2>\n
Eine Umbenennung von zweihundert Elementen ist eine \u00c4nderung mit zweihundert Eintr\u00e4gen, und sie geh\u00f6rt aus drei Gr\u00fcnden in einen eigenen Arbeitsbereich.<\/p>\n
Die Version, die daraus entsteht, ist ein einziger Eintrag im Containerverlauf – und genau das braucht die Kollegin, die die \u00c4nderungsliste in einem halben Jahr ansieht. Ein Arbeitsbereich, den sich die Umbenennung mit einer fachlichen \u00c4nderung teilt, macht beide schwerer zu pr\u00fcfen und getrennt unm\u00f6glich zur\u00fcckzunehmen.<\/p>\n
Die Vorschau funktioniert innerhalb des Arbeitsbereichs weiter, der ganze Container l\u00e4sst sich vor dem Ver\u00f6ffentlichen also einmal durchspielen – und durchzuspielen ist gezielt jedes benutzerdefinierte HTML-Tag, denn dort stehen die Verweise als Zeichenkette im Code, und dort zeigt sich, ob die Umbenennung sie mitgenommen hat.<\/p>\n
Und der Container l\u00e4sst sich aus dem Arbeitsbereich vor dem Ver\u00f6ffentlichen exportieren, womit eine Datei zum Vergleich mit der vorherigen vorliegt. Zwei Exporte, ein grep<\/code>, und die Frage, ob etwas zerbrochen ist, ist ohne Raten beantwortet.<\/p>\nEs dabei belassen<\/h2>\n
Eine Konvention zerf\u00e4llt in dem Tempo, in dem Leute in Eile etwas hinzuf\u00fcgen, und drei Gewohnheiten bremsen das st\u00e4rker als ein Dokument.<\/p>\n
Das Pr\u00fcfskript geh\u00f6rt dorthin, wo es von allein l\u00e4uft. Einmal im Monat gegen einen frischen Export gen\u00fcgt, und die Ausgabe ist kurz: Entweder passt alles, oder sie nennt die drei Elemente, die seit dem letzten Lauf hinzugekommen sind.<\/p>\n
Das Schema geh\u00f6rt in den Container statt in ein Wiki. Ein Merkelement – ein Tag, das nie ausl\u00f6st, benannt als 0 - Namensschema<\/code>, damit es nach oben sortiert – tr\u00e4gt die Konvention dorthin, wo die Person, die gerade etwas benennt, ohnehin hinsieht.<\/p>\nUnd die L\u00f6schliste aus der Pr\u00fcfung lohnt sich abzuarbeiten statt abzulegen. Ein Container mit vierzig pausierten Tags, die niemand wiedererkennt, ist ein Container, in dem die Konvention erneut \u00fcbergangen wird, denn die Liste ist bereits unlesbar – und der schnellste Weg zu einer lesbaren Liste ist eine k\u00fcrzere.<\/p>\n
\nFragen und Antworten<\/h2>\nM\u00fcssen auch die von GTM vorgegebenen Variablen wie Page URL dem Schema folgen?<\/h3>\n
Nein, und sie k\u00f6nnen es auch nicht. Die vorgegebenen Variablen (Built-in Variables) wie Page URL oder Click Classes tragen Namen, die Google festlegt; sie lassen sich ein- und ausschalten, aber nicht umbenennen. Im Container-Export stehen sie in einer eigenen Liste builtInVariable<\/code> und nicht unter variable<\/code>, das Pr\u00fcfskript \u00fcbergeht sie deshalb von selbst. In der grep-Liste der Verweise tauchen sie zwar auf, bleiben dort aber vor und nach der Umbenennung gleich und st\u00f6ren den Vergleich nicht.<\/p>\nL\u00e4sst sich die monatliche Pr\u00fcfung einrichten, ohne den Container jedes Mal von Hand zu exportieren?<\/h3>\n
Ja, \u00fcber die Tag Manager API. Sie liefert die ver\u00f6ffentlichte Version eines Containers mit denselben Listen tag<\/code>, trigger<\/code> und variable<\/code>, die auch im Export stehen. Der Unterschied liegt in der Verpackung: Der Export aus der Oberfl\u00e4che legt die Version unter den Schl\u00fcssel containerVersion<\/code>, die Antwort der API ist die Version selbst. Das Skript braucht deshalb nur an der Stelle, an der es die Datei einliest, eine kleine Anpassung.<\/p>\nF\u00fcr den Zugriff gen\u00fcgt ein Dienstkonto mit Leseberechtigung (Read) auf den Container und dem Bereich tagmanager.readonly<\/code>. Schreibrechte sind f\u00fcr eine Pr\u00fcfung \u00fcberfl\u00fcssig und sollten fehlen: Ein Pr\u00fcfauftrag, der nichts \u00e4ndern kann, kann auch nichts zerbrechen. Das Dienstkonto wird in der Nutzerverwaltung des Containers mit seiner E-Mail-Adresse hinzugef\u00fcgt wie eine Person.<\/p>\nEin Unterschied zum Export bleibt zu beachten: Die ver\u00f6ffentlichte Version zeigt nicht, was in offenen Arbeitsbereichen gerade entsteht. Wer auch unver\u00f6ffentlichte Namen pr\u00fcfen will, liest zus\u00e4tzlich die Arbeitsbereiche aus, die die API ebenfalls anbietet.<\/p>\n
Wenn ein Container mehrere Websites bedient, geh\u00f6rt dann die Website nach vorn?<\/h3>\n
Nur wenn die meisten Fragen an den Container mit der Website beginnen. Die Plattform steht vorn, weil dort \u00fcblicherweise die Suche anf\u00e4ngt; bei einem Container f\u00fcr mehrere Auftritte kann dieser Ausgangspunkt die Website sein. Entscheidend ist, dass die Wahl einmal f\u00e4llt und f\u00fcr alle Elemente gilt, denn ein Schema, das mal mit der Plattform und mal mit der Website beginnt, zerlegt die Sortierung genauso wie gemischte Trenner.<\/p>\n<\/div>\n