Dein Server-Side-Setup debuggen und testen

GTM Preview funktioniert in beiden Containern gleichzeitig. Die Reihenfolge ist wichtig: Die Server-Preview muss offen sein, bevor die Web-Preview etwas sendet, und beide müssen im selben Browser laufen.

1. 1 Öffne den Server-Container im GTM und klicke auf Preview. Ein Tag-Assistant-Tab öffnet sich auf sgtm.example.com. Lass ihn offen.
2. 2 Öffne im selben Browser den Web-Container und klicke auf Preview. Gib die Adresse deiner Website ein und klicke auf Connect.
3. 3 Klick dich durch die Website und löse das Event aus, das du testen willst.
4. 4 Wechsle zum Tab der Server-Preview. Jede eingehende Anfrage erscheint in der linken Spalte.

Wähle eine Anfrage aus und lies sie von oben nach unten:

• Request: die eingehende HTTP-Anfrage und der Client, der sie übernommen hat. Ein GA4-Hit sollte vom Client GA4 übernommen werden.
• Tags: welche Tags gefeuert haben und welche nicht. Ein Tag, das nicht gefeuert hat, hat meist einen Trigger, der nicht gegriffen hat.
• Outgoing HTTP requests (im Tab Request): was der Server an GA4 oder einen anderen Anbieter gesendet hat und welchen Statuscode er zurückbekam. Ein 2xx-Status heißt, dass der Anbieter die Daten angenommen hat.
• Event Data: die Parameter, die der Client ausgelesen hat. Prüfe, ob dein Event-Name und deine Parameter angekommen sind.

Die Preview zeigt dir, was GTM getan hat. Zwei weitere Prüfungen bestätigen, was den Browser tatsächlich verlassen hat und was in GA4 angekommen ist.

1. 1 Öffne die DevTools (F12), geh zum Tab Network und filtere nach collect.
2. 2 Lade die Seite neu. Du solltest Anfragen an deine eigene Subdomain sehen, nicht an google-analytics.com.
3. 3 Prüfe den Status: 200 oder 204 heißt, dass dein Tagging-Server den Hit angenommen hat.

https://sgtm.example.com/g/collect?v=2&tid=G-XXXXXXXXXX&en=page_view&...

Öffne dann GA4 und geh zu Admin, dann zu Data display und DebugView. Events aus einem Browser in der GTM Preview werden automatisch als Debug-Traffic markiert. Außerhalb der Preview ergänzt du im Google-Tag den Parameter debug_mode mit dem Wert true, damit sie dort erscheinen.

Die meisten fehlerhaften Setups scheitern an einer dieser Stellen. Geh sie der Reihe nach durch, vom DNS bis zum Anbieter.

• „DNS prüfen“ schlägt fehl oder die Subdomain wird nicht aufgelöst. Der Eintrag verbreitet sich eventuell noch (bis zu einer Stunde warten), der Name enthält die Domain doppelt (sgtm.example.com.example.com, weil manche Panels die Domain selbst anhängen), oder der Cloudflare-Proxy ist aktiv. Bei Cloudflare muss der Eintrag auf DNS only stehen (graue Wolke), nicht auf der orangen Wolke.
• Falsche oder veraltete Container Config. Passt der Server-Container in der Preview nicht zu dem, den du im GTM bearbeitest, kopiere die Container Config erneut aus Admin und Container Settings und stelle sicher, dass dein SGTM.space-Container genau diesen String nutzt. Eine Config aus einem anderen Server-Container schickt deinen Traffic an den falschen.
• Hits gehen weiterhin an google-analytics.com. Der Parameter server_container_url fehlt im Google-Tag, enthält einen Tippfehler, oder der Web-Container wurde danach nicht veröffentlicht. Siehe Lektion 3.
• In der Preview klappt es, bei echten Besuchern nicht. Der Server-Container wurde nie veröffentlicht. Die Preview nutzt deinen Workspace, Live-Traffic die veröffentlichte Version. Klicke im Server-Container auf Submit und Publish.
• Anfragen kommen an, aber nichts erreicht GA4. Der Server-Container hat kein GA4-Tag, oder dessen Trigger greift nicht. Lege ein Google Analytics: GA4-Tag mit dem Trigger Client Name equals GA4 an, wie in Lektion 4 gezeigt.
• Bei manchen Besuchern fehlen Hits. Werbeblocker können Anfragen weiterhin stoppen, und mit Consent Mode feuern Tags eventuell nicht oder senden nur cookielose Pings, bis der Besucher zustimmt. Siehe Lektion 6 und Lektion 8.
• Plötzlich werden alle Anfragen abgelehnt. Der Container hat das Request-Limit seines SGTM.space-Tarifs erreicht. Anfragen werden abgewiesen, bis das Limit erhöht wird oder der Zeitraum neu beginnt. Der Tab Analysen zeigt, wie nah du dran bist.

Jeder Container in SGTM.space hat Tabs, die die Fragen beantworten, bei denen GTM nicht weiterhilft.

• Übersicht: der Container-Status und seine Health-Checks. Fang hier an, wenn überhaupt nichts ankommt.
• DNS: die anzulegenden Einträge und ihr Status. Nutze DNS prüfen nach jeder Änderung.
• Analysen: die Anzahl der Anfragen pro Tag. Ein plötzlicher Absturz auf null deutet auf eine kaputte Installation oder eine DNS-Änderung hin, nicht auf GA4.
• Preview Mode: leitet passende Anfragen von Webhooks, einem CRM oder deinem Backend 60 Minuten lang in deine offene Server-Preview weiter.

Preview Mode hilft, wenn die Anfragen nicht aus deinem Browser kommen und das normale Preview-Cookie deshalb fehlt.

1. 1 Öffne Preview im Server-Container. Wähle im Menü oben rechts Send requests manually und kopiere den Wert des Headers X-Gtm-Server-Preview.
2. 2 Öffne in SGTM.space den Tab Preview Mode und füge das Token ein.
3. 3 Lege optional ein Pfadpräfix (zum Beispiel /webhooks) und eine Quell-IP fest, damit nur diese Anfragen weitergeleitet werden.
4. 4 Klicke auf Speichern und für 60 Minuten starten und löse den Webhook oder Backend-Aufruf aus. Er erscheint in deiner Preview-Sitzung.

• https://sgtm.example.com/healthz liefert 200, und der Container ist in der Übersicht Bereit.
• Die DevTools zeigen collect-Anfragen an deine Subdomain mit Status 200 oder 204.
• Die Server-Preview zeigt, dass der GA4-Client die Anfrage übernommen hat.
• Das GA4-Tag hat gefeuert, und seine ausgehende Anfrage bekam einen 2xx-Status.
• Das Event erscheint in GA4 DebugView.
• Beide Container sind veröffentlicht.