Wie man eine benutzerdefinierte Domäne zum Google Tag Manager Server-Container hinzufügt
Verfasst von
Ira Holubovska
In diesem Artikel beschreibe ich, wie Sie eine benutzerdefinierte Subdomäne in Ihrem Google Tag Manager-Server-Container einrichten. Der Hauptvorteil einer benutzerdefinierten Subdomäne innerhalb des Google Tag Manager Server-Containers besteht darin, dass sie hilft, intelligente Tracking-Verhinderungen und AdBlocker zu umgehen und die Lebensdauer von Cookies für Nutzer, die in Safari surfen, zu verlängern. Pixels wird von Ihrer Subdomäne geladen und als erste Partei ausgeführt.
Warum sollten Sie eine benutzerdefinierte Subdomäne im Google Tag Manager Server Container verwenden?
Der wesentliche Vorteil des serverseitigen Taggings liegt im Setzen von First-Party-Cookies, was jedoch nicht standardmäßig aktiviert ist. Um diese Fähigkeit zu nutzen, müssen Sie eine benutzerdefinierte Domäne in Ihrem serverseitigen GTM implementieren.
Da Chrome der letzte Browser ist, der Cookies von Drittanbietern unterstützt und diese Anfang 2025 auslaufen werden, ist es jetzt an der Zeit, Erstanbieter-Cookies anstelle von Drittanbieter-Cookies zu verwenden.
⚠️UPDATE: Google hat angekündigt, dass es seine Pläne zur Abschaffung der Cookies von Drittanbietern nicht weiter verfolgen wird. Stattdessen wird das Unternehmen eine neue Lösung einführen: eine einmalige Eingabeaufforderung, die es den Nutzern ermöglicht, ihre Präferenzen festzulegen, die für alle Google-Browsing-Erfahrungen gelten werden.
Die Stabilität und Langlebigkeit der von sGTM gesetzten Cookies hängt davon ab, wie eine benutzerdefinierte Domain implementiert ist. Es gibt drei Arten von benutzerdefinierten Domain-Konfigurationen in sGTM.
Sie können eine benutzerdefinierte Tagging-Server-URL verwenden, um Erstanbieter-Cookies einzurichten. Die benutzerdefinierte Tagging-Server-URL oder benutzerdefinierte Domäne sollte dieselbe Domäne wie Ihre Website haben. Wenn Ihre Website-Domäne beispielsweise example.com lautet, sollte die URL des Tagging-Servers wie ss.example.com aussehen.
Es gibt drei Möglichkeiten, eine benutzerdefinierte Domäne einzurichten:
- Gleicher Ursprung
- Unterdomäne
- Standard-Domäne
Wie fügt man eine benutzerdefinierte Subdomäne im Google Tag Manager Server Container hinzu?
Als Erstes müssen Sie einen Google Tag Manager-Servercontainer erstellen und einrichten. Wenn Sie keinen Server-Container haben, folgen Sie dieser Anleitung.
Wir zeigen zwei Möglichkeiten, eine benutzerdefinierte Domain für den Google Tag Manager-Container auf dem Server zuzuordnen:
- Verwendung einer Subdomain.
- Verwendung des gleichen Ursprungs.
Verwendung einer Subdomain
Verwenden Sie eine benutzerdefinierte Tagging-Server-URL, auch benutzerdefinierte Domain genannt, um First-Party-Cookies zu setzen. Diese URL sollte dieselbe Root-Domain wie Ihre Website verwenden. Wenn Ihre Website beispielsweise `example.com` lautet, kann Ihre Tagging-Server-URL `ss.example.com` lauten.
Es gibt drei Möglichkeiten, eine benutzerdefinierte Domain einzurichten:
- Gleiche Herkunft – Der Tagging-Server hat genau dieselbe Domain und denselben Pfad wie Ihre Website. Erfahren Sie mehr darüber, wie Sie eine benutzerdefinierte Domain mit derselben Herkunft einrichten.
- Subdomain – Der Tagging-Server läuft auf einer Subdomain Ihrer Root-Domain. In diesem Artikel führen wir Sie durch diese Einrichtung.
- Standarddomain – Keine benutzerdefinierte Domain; es wird die von Stape bereitgestellte Standardadresse verwendet.
Einen detaillierten Vergleich dieser Methoden finden Sie im Leitfaden zu serverseitigen GTM-Domains.
Schritt 1. Eigene Domain hinzufügen
Wählen Sie Ihren Container in Stape aus, scrollen Sie nach unten und klicken Sie auf Add custom domain.
Fügen Sie einen Subdomain name hinzu – er kann beliebig gewählt werden. Achten Sie jedoch darauf, keine Begriffe zu verwenden, die spezifisch für Werbung oder Tracking sind: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag usw.
Schritt 2. CDN hinzufügen
Ein Content Delivery Network (CDN) verteilt die Assets Ihrer Website über ein globales Servernetzwerk, um die Latenz zu reduzieren und die Ladezeiten für Nutzer an verschiedenen Standorten zu verbessern. Es ist sinnvoll, wenn Ihre Zielgruppe geografisch verteilt ist oder wenn Sie das Cookie-Tracking und die Datengenauigkeit verbessern möchten.
Standardmäßig ist das CDN deaktiviert, d. h. JavaScript-Dateien (wie gtm.js, gtag.js und analytics.js) werden direkt vom Serverstandort bereitgestellt, an dem Ihr sGTM-Container gehostet wird. In der Praxis werden dabei sowohl Stape Global CDN als auch Own CDN umgangen, und es besteht eine direkte, nicht über einen Proxy geleitete Verbindung zwischen Ihrer Website und dem sGTM-Container.
| Wichtig: Berücksichtigen Sie bitte die Datenschutzbestimmungen Ihres Landes, bevor Sie ein CDN einrichten. |
Um das CDN zu aktivieren, klicken Sie auf Add CDN und wählen Sie eine der folgenden Optionen:
- Stape Global CDN: Lädt Skripte vom Server, der dem Standort Ihrer Website-Besucher am nächsten liegt. Dies reduziert die Latenz und verbessert die Seitenladezeiten für geografisch verteilte Zielgruppen. In unserem Setup verwenden wir Stape Global CDN. Diese Funktion ist kostenlos und für alle Stape-sGTM-Container verfügbar.
- Own CDN (nicht kompatibel mit der Verbindungsoption Automatically (via Entri)): Hilft dabei, die benutzerdefinierte sGTM-Domain zu routen und den sGTM-Traffic über den DNS-Anbieter Ihrer Website zu leiten. In diesem Fall stimmen die IP-Adressen Ihrer Website und der benutzerdefinierten sGTM-Domain überein, und serverseitige Cookies gelten als Erstanbieter-Cookies. Dadurch besteht die Möglichkeit, die Cookie-Laufzeit zu verlängern.
Schritt 3. Verbindungsmethode auswählen
Als Nächstes stehen Ihnen im Bereich How to connect zwei Möglichkeiten zur Verfügung, um eine benutzerdefinierte Domain mit Ihrem Container zu verbinden:
- Automatically (via Entri)
Die einfachste Möglichkeit, Domains zu verbinden. Melden Sie sich mit Ihren DNS-Anbieter-Zugangsdaten über Entri an und erteilen Sie uns eine einmalige Berechtigung, Ihre Domain zu verbinden. Anschließend können Sie direkt zu Schritt 5 übergehen, um Ihre Domain zu verifizieren – eine manuelle Konfiguration ist nicht erforderlich.
- Manually
Bei dieser Option müssen Sie DNS-Einträge manuell bei Ihrem Hosting-Anbieter hinzufügen, um Ihre Subdomain mit Stape zu verbinden.
Nachdem Sie Ihrem Container eine benutzerdefinierte Subdomain hinzugefügt haben, sehen Sie die DNS-Einträge, die erstellt werden müssen, um die benutzerdefinierte Domain zu verifizieren. Der DNS-Eintrag hängt vom Serverstandort und der gewählten CDN-Option ab. Im nächsten Schritt zeigen wir, wie DNS-Einträge hinzugefügt werden.
Schritt 4. DNS-Einträge hinzufügen (für die manuelle Verbindungsmethode)
Standardmäßig erfolgt die Subdomain-Verifizierung mit CNAME-Einträgen. Sie können Ihre Subdomain jedoch auch mit A- und AAAA-Einträgen verifizieren (in der Regel, wenn Sie doppelte Einträge vermeiden möchten).
Im Folgenden werden beide Optionen anhand einer Schritt-für-Schritt-Anleitung zur Erstellung von Einträgen mit Cloudflare erläutert. Sie können jedoch auch jeden anderen Anbieter verwenden.
Benutzerdefinierte Domain mit einem CNAME-Eintrag hinzufügen
Benutzerdefinierte Subdomain mit A- und AAAA-Einträgen hinzufügen
| Bitte beachten Sie, dass A/AAAA-Einträge nicht mit einem aktivierten CDN kompatibel sind. |
Schritt 5. Domain verifizieren
Nachdem Sie die DNS-Einträge bei Ihrem DNS-Anbieter eingegeben haben, kehren Sie zur Stape-Container-Seite zurück, auf der Sie die benutzerdefinierte Domain konfiguriert haben, und klicken Sie auf Verify.
Warten Sie, bis Stape die Verifizierung Ihrer benutzerdefinierten Domain abgeschlossen hat (wenn sich die Containerstatusleiste von Verifying auf Ready ändert). In der Regel dauert die Verifizierung einer benutzerdefinierten Domain 2–3 Stunden. Bei einigen DNS-Anbietern kann die Verifizierung von Einträgen bis zu 72 Stunden dauern. Wir senden Ihnen eine E-Mail, sobald die benutzerdefinierte Domain verifiziert wurde oder ein Fehler festgestellt wurde.
Wenn Sie Probleme bei der Domain-Verifizierung haben, folgen Sie bitte unserer Anleitung zur Fehlerbehebung bei benutzerdefinierten Domains.
Schritt 6. Tagging-Server-URL hinzufügen und Website-Skript aktualisieren
Gehen Sie zu Ihrem Google Tag Manager-Server-Container → Admin → Container Settings → ändern Sie die Tagging server URL auf Ihre Subdomain.
Skript aktualisieren
Wenn Sie eine benutzerdefinierte Domain verwenden, wird dringend empfohlen, das Web-GTM-Skript auf Ihrer Website zu aktualisieren. Diese Anpassung sorgt dafür, dass gtm.js von Ihrer Domain geladen wird. Ersetzen Sie dazu die Standarddomain googletagmanager.com durch die benutzerdefinierte Domain, die Sie im vorherigen Schritt eingerichtet haben.
Alternativ können Sie diesen Prozess mit dem Custom Loader power-up automatisieren. Anstatt das GTM-Skript manuell zu bearbeiten, generiert Custom Loader einen gebrauchsfertigen Code-Snippet, der GTM- und GA4-Skripte direkt von Ihrer benutzerdefinierten Domain lädt. Das spart Zeit, macht Ihre Tracking-Skripte widerstandsfähiger gegen Werbeblocker und stellt sicher, dass alle Cookies als Erstanbieter-Cookies behandelt werden.
Verwendung derselben Ursprungsdomäne
Voraussetzungen
Stellen Sie vor dem Start sicher, dass Folgendes vorhanden ist:
- Ein CDN oder Load Balancer, der in der Lage ist, Anfragen weiterzuleiten, und über den der gesamte Traffic Ihrer Website geleitet wird.
- Wenn Sie App Engine verwenden, sollte der Tagging-Server Version 2.2.0 oder oder höher ausführen.
Hinweis:
Damit einige Tags ordnungsgemäß funktionieren, sollte Ihr CDN kein Caching oder Query-String-Sortierung anwenden. Cloudflares Query String Sort oder URL normalization, zum Beispiel, wird die sendPixelFromBrowser API stören, die von einigen serverseitigen Tags verwendet wird.
Same-Origin-Domain Schritt für Schritt konfigurieren
Je nach Ihrer Infrastruktur können Sie die Same-Origin-Custom-Domain mit verschiedenen Plattformen und Diensten konfigurieren. Hier sind die Anleitungen für jede Option:
Hinweis:
Wenn Sie eine Plattform verwenden, die oben nicht aufgeführt ist, würden wir uns freuen, wenn Sie Ihre Vorschläge an support@stape.io.
Im Folgenden gehen wir die Einrichtung am Beispiel von Cloudflare durch.
Damit diese Option funktioniert, muss der gesamte Traffic Ihrer Website über Cloudflare geleitet werden – die Cloudflare-Workers-Funktionalität ermöglicht es Ihnen dann, auch sGTM-Anfragen zu proxieren. Sie sollten außerdem SSL/TLS im Full-Modus verwenden; andernfalls kann Same-Origin-Proxying über eine 301-Weiterleitung funktionieren, was falsch ist.
Schritt 1. Cloudflare Worker erstellen
Klicken Sie in der linken Seitenleiste auf Compute → Workers & Pages → klicken Sie auf Create application → wählen Sie die Option Start with Hello World!.
Schritt 2. Worker benennen und bereitstellen
Fügen Sie einen Worker-Namen hinzu → klicken Sie auf Deploy.
Schritt 3. Worker-Code bearbeiten
Entscheiden Sie sich für den Pfad für Ihre sGTM-Custom-Domain – zum Beispiel example.com/sgtm, example.com/data oder example.com/metrics.
Klicken Sie in den Worker-Einstellungen auf Edit code und fügen Sie ein JS ähnlich dem folgenden Beispiel ein, wobei:
/metrics/der Pfad ist, den Sie für Ihren Server-Container gewählt haben.https://sst.shop.stapedesk.com/Ihre Tagging-Server-URL ist.
Für die Tagging-Server-URL haben Sie zwei Optionen:
- Die Standard-Tagging-Server-URL von Stape (z. B.
https://wapdsrl.ca.stape.io). - Die benutzerdefinierte Subdomain, die Sie im Stape admin eingerichtet haben. Die Verwendung einer benutzerdefinierten Subdomain bietet zwei Vorteile: Es lädt
gtm.jsundgtag.jsüber einen benutzerdefinierten Pfad via Custom Loader power-up, sodass Tracking-Skripte nicht blockiert werden können, und es ermöglicht langlebige First-Party-Cookies.
Wenn du eine benutzerdefinierte Subdomain als same-origin Tagging-Server-URL verwendest, stelle sicher, dass du eine benutzerdefinierte Domain zu deinem sGTM-Container auf Stape hinzugefügt und die erforderlichen DNS-Einträge erstellt hast, wie hier beschrieben.Verwenden Sie Own CDN nicht mit der Same-Origin-Domain.
export default {
async fetch(request, env, ctx) {
let { pathname, search, host } = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sst.stapedesk.com';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
Stellen Sie Ihre Änderungen bereit und speichern Sie sie.
Schritt 4. Route zum Worker hinzufügen
Gehe zu deinem sGTM worker → klicke auf Domains → Add domain → Route pattern. Wähle deine Domain aus der Liste aus und füge die URL hinzu, die du für den server GTM verwendest, endend mit * (in unserem Beispiel: shop.stapedesk.com/metrics*).
Schritt 5. Konfigurationsregel erstellen
Klicken Sie neben Ihrem Domainnamen auf die drei Punkte → Configure Rules.
Klicken Sie auf Create rule → Configuration Rules:
- Geben Sie einen verständlichen Regelnamen an, z. B. sGTM same origin.
- Wählen Sie Custom filter expression.
- URI-Pfad beginnt mit
/metrics(aktualisieren Sie dies, wenn Sie einen anderen Pfad verwenden). - SSL → wählen Sie die Option Full.
Klicken Sie auf Deploy.
Schritt 6. Request-Header-Transform-Regel erstellen
Gehen Sie zu Rules → Overview → Create Rule → Request Header Transform Rule:
- Geben Sie einen beschreibenden Regelnamen ein, z. B. sGTM header.
- Wählen Sie Custom filter expression.
- URI-Pfad beginnt mit
/metrics(aktualisieren Sie dies, wenn Sie einen anderen Pfad verwenden). - Legen Sie einen statischen Header-Namen
X-From-Cdnmit dem Wertcf-stape.
Speichern Sie die Regel.
Schritt 7. Custom Loader aktualisieren
Sobald die Same-Origin-Einrichtung abgeschlossen ist, empfehlen wir außerdem, das Custom-Loader-Power-up für den Schutz vor Werbeblockern zu aktualisieren und es auf Ihrer Website zu implementieren. Vergessen Sie nicht, Ihren Same-Origin-Pfad darin anzugeben.
Weitere Informationen finden Sie in unserem Leitfaden zum Custom Loader erstellt haben.
Schritt 8. Server-Container-URL im Web- und Server-GTM hinzufügen
1. Fügen Sie in Ihrem Web-GTM-Container Google Tag hinzu und geben Sie Ihre Measurement-ID an (jede ID funktioniert zum Testen). Setzen Sie server_container_url auf den konfigurierten Same-Origin-Pfad (in unserem Beispiel ist dashttps://stapedesk.com/metrics).
2. Um das Testen zu vereinfachen, klicken Sie auf Admin → Container Settings → geben Sie den Pfad unter Server container URLs.
3. Für das Testen der Same-Origin-Domain (wie wir im folgenden Schritt zeigen) müssen Sie außerdem einen Client (der Daten vom Web-Container zum Server-Container überträgt) und das Google Analytics: GA4-Tag im Server-GTM konfigurieren.
Als Client verwenden wir GA4.
Um den GA4-Client im Server-GTM hinzuzufügen, öffnen Sie den Clients-Bereich → Create New client → Wählen Sie den Client-Typ Google Analytics: GA4 (Web) → Fügen Sie den Client-Namen hinzu und klicken Sie auf Save.
Um das GA4-Tag zu konfigurieren, fügen Sie ein neues Tag mit der Tag-Konfiguration “Google Analytics: GA4” hinzu und geben Sie einfach Ihre Measurement-ID im Tag an.
Fügen Sie den Trigger für ein Tag hinzu. Er sollte auslösen, wenn der Client-Name die Anfragen empfängt (in unserem Fall ist der Client GA4):
Same-Origin-Einrichtung testen
Klicken Sie auf Preview in beiden GTM-Containern, Web und Server.
Wenn alles korrekt eingerichtet ist, sollte der Server-Container in der Vorschau unter dem neuen Pfad geöffnet werden. Wenn die Vorschau aus irgendeinem Grund nicht unter dem neuen Pfad geöffnet wird, können Sie ihn manuell in die URL des Vorschaufensters eingeben.
Besuchen Sie Ihre Website. In der Server-Container-Vorschau sollten Sie jetzt eine eingehende page_view Anfrage von der echten Domain Ihrer Website sehen.
Abschluss
Das Hinzufügen einer benutzerdefinierten Domain zu einem Google Tag Manager (GTM)-Server-Container kann die Effektivität und Flexibilität Ihres serverseitigen Trackings erheblich beeinflussen. In diesem Artikel haben wir zwei Methoden für die Implementierung einer benutzerdefinierten Domain vorgestellt.
Ein Ansatz mit gleichem Ursprung bietet mehr Sicherheit und eine einfachere Cookie-Verwaltung, ideal für einzelne, fokussierte Domains. Eine Subdomain-Einrichtung bietet Flexibilität und Leistungsoptimierung und eignet sich für komplexe oder mehrere Domain-Strukturen. Jeder Ansatz hat seine Nachteile in Bezug auf Komplexität, Leistung und Verwaltung. Berücksichtigen Sie sorgfältig Ihre technischen Anforderungen, Sicherheitsbedürfnisse und Tracking-Ziele, um die am besten geeignete Konfiguration für Ihr serverseitiges Tracking auszuwählen.
Wenn Sie Fragen haben, besuchen Sie unseren Helpdesk oder schreiben Sie ein Ticket. Unser Expertenteam hilft Ihnen gerne bei allen Fragen zu Stape's Hosting und Server-seitigem Tracking.
Möchten Sie der Server-Seite beitreten?
Kostenlos testenRelevante Nachrichten
Blog
Wie viel kostet ein GTM-Server und warum ist Stape billiger als Google Cloud Run
Google Tag Manager wurde 2012 veröffentlicht und hat seither das Leben von Marketern und Webanalysten erheblich erleichtert. In den dunklen Tagen vor GTM musste man, um ein neues Tracking-Pixel oder Ereignis hinzuzufügen, Tage/Wochen/Monate warten, bis die Anfrage bearbeitet und auf der Produktionsseite angezeigt wurde.
4. Sep. 2025
Kommentare