Zum Inhalt springen

Dein Server-Side-Setup debuggen und testen

Ein Server-Side-Setup hat mehr bewegliche Teile als ein Web-Container: den Browser, deine Subdomain, den Server-Container und die Anbieter dahinter. Wenn Daten fehlen, findest du die Bruchstelle, indem du einen einzelnen Hit auf diesem Weg verfolgst. Diese Lektion zeigt dir die Werkzeuge für jeden Schritt und die häufigsten Probleme samt Lösung.

Fortgeschritten 9 Min. Lesezeit Version 1.4, aktualisiert am 3. Oktober 2026

Das lernst du

  • Web- und Server-Preview parallel laufen lassen und nachvollziehen, was der Server-Container mit jeder Anfrage gemacht hat.
  • In den DevTools und in GA4 DebugView prüfen, dass Hits deine Subdomain und GA4 erreichen.
  • Die häufigsten Ursachen fehlender serverseitiger Daten erkennen und beheben.
  • Mit den Container-Tabs in SGTM.space Zustand, DNS, Traffic und deine Live-Installation prüfen.

Bevor du startest

  • Ein Server-Container, der auf deiner Subdomain läuft (Lektion 2).
  • GA4, das aus dem Web-Container an diese Subdomain sendet (Lektion 3 und Lektion 4).

01 Web- und Server-Preview parallel nutzen

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 k7q2x.example.com (dort öffnet er sich, wenn im Server-Container unter Admin, Container Settings die Server container URL gesetzt ist, siehe Lektion 2). 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.

02 Browser und GA4 prüfen

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://k7q2x.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. Entferne ihn danach wieder: Der Wert false schaltet den Debug-Modus nicht ab.

03 Häufige Probleme und ihre Lösung

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 (k7q2x.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.

Die Server-Preview öffnet sich nicht auf deiner Subdomain

Trage im Server-Container unter Admin, Container Settings https://k7q2x.example.com als Server container URL ein und speichere.

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 (HTTP 429)

Der Container hat die monatlichen Anfragen seines Tarifs verbraucht, und die Übernutzung ist aus oder ausgeschöpft. Anfragen werden abgewiesen, bis du den Tarif wechselst, die Übernutzung im Tab Tarif aktivierst oder der Abrechnungszeitraum neu beginnt. Mit Better Loader lädt dann auch GTM selbst nicht mehr.

04 Die Container-Tabs in SGTM.space nutzen

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

  • Übersicht: der Container-Status und seine Checks unter Zustand (DNS, Loader-DNS, Container, Loader-Skript). 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 von den Seiten deiner Website, wahrscheinliche Bots (auch schon vor dem Aktivieren der Bot-Filterung gezählt) und im Modus Blockieren blockierte Bots. Ein plötzlicher Absturz auf null deutet auf eine kaputte Installation oder eine DNS-Änderung hin, nicht auf GA4.
  • Tarif: dein Tarif und wie viele seiner monatlichen Anfragen der Container schon verbraucht hat. Hier aktivierst du auch die Übernutzung.
  • Add-ons: Jedes Add-on ist eine Karte mit Aktivieren, und sobald es an ist, öffnet Einstellungen auf der Karte seine Einstellungsseite. Eines davon, 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 Add-ons, klicke auf der Karte Preview Mode auf Einstellungen 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.

05 Eine kurze Test-Checkliste

  • https://k7q2x.example.com/healthy 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.

Häufige Fragen

Warum ist die Server-Preview leer, während die Web-Preview Events zeigt?

Entweder gehen die Hits nicht an deine Subdomain (prüfe server_container_url und den Network-Tab), oder die Server-Preview wurde in einem anderen Browser oder nach der Web-Preview geöffnet. Öffne zuerst die Server-Preview und starte dann die Web-Preview im selben Browser.

Kann ich Anfragen aus meinem Backend oder von einem Webhook debuggen?

Ja. Kopiere das Token X-Gtm-Server-Preview über Send requests manually aus der Server-Preview und füge es in SGTM.space unter Preview Mode ein (öffne Add-ons und klicke auf der Karte Preview Mode auf Einstellungen). Passende Anfragen erscheinen 60 Minuten lang in deiner Preview-Sitzung.

GA4 zeigt weniger Events als der Tab Analysen. Gehen Daten verloren?

Nicht unbedingt. Der Tab Analysen zählt Anfragen von den Seiten deiner Website (Webhook- und Backend-Aufrufe sind nicht enthalten), auch Skript-Ladevorgänge, Bots und Events, die kein Tag weiterleitet. Er zeigt auch wahrscheinliche Bots, schon bevor die Bot-Filterung aktiv ist, und im Modus Blockieren blockierte Bots. Vergleiche lieber ein einzelnes Event in der Preview und in DebugView statt der Summen.

Bereit, es in die Praxis umzusetzen?

Richte in wenigen Minuten einen Server-GTM-Container auf deiner eigenen Domain ein. Für den Tarif Kostenlos brauchst du keine Karte.

Kostenloses Konto erstellen