Wie man eine benutzerdefinierte Domäne zum Google Tag Manager Server-Container hinzufügt
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
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
Sie müssen einen CNAME-Eintrag erstellen, wenn Sie Stape Global CDN nicht verwenden, und zwei Einträge, wenn Sie es verwenden.
1. Melden Sie sich bei Ihrem Domain-Name-Dienst an und erstellen Sie einen neuen DNS-Eintrag für die Subdomain, die Sie verwenden möchten. Klicken Sie dazu auf der Startseite Ihres Kontos neben Ihrem Domainnamen auf die drei Punkte und wählen Sie Configure DNS.
2. Klicken Sie auf Add record.
3. Kehren Sie zu Ihrem Stape-Konto zurück und geben Sie den Eintrag ein, den Sie im Konto sehen. Stellen Sie sicher, dass der Proxy-Status (Proxy status) deaktiviert (off) ist.
Wir verwenden Stape Global CDN und erstellen daher zwei CNAME-Einträge:
![[CNAME-Eintrag]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb55eda1b28927787299.png&w=3840&q=75)
![[Zweiter CNAME-Eintrag]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb5609e2a6b450141421.png&w=3840&q=75)
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. |
1. Wenn Sie Ihre benutzerdefinierte Subdomain mit A- und AAAA-Einträgen verifizieren möchten, fügen Sie die benutzerdefinierte Subdomain zum Container hinzu und stellen Sie sicher, dass der CDN-Schalter deaktiviert (off) ist.
Klicken Sie auf Advanced settings und aktivieren Sie das Kontrollkästchen Use A records instead of CNAME records. Sie sehen dann die DNS-Einträge, die Sie in Ihrem Stape-Container hinzufügen müssen. Die zu konfigurierenden DNS-Einträge variieren je nach Serverstandort.
2. Melden Sie sich bei Ihrem DNS-Konto an und fügen Sie die Einträge hinzu, die in Ihrem Stape-Konto angezeigt werden. Klicken Sie auf der Startseite des Kontos neben Ihrem Domainnamen auf die drei Punkte und wählen Sie Configure DNS.
3. Klicken Sie auf Add record.
4. Erstellen Sie anschließend die Einträge, die in Ihrem Stape-Konto angezeigt werden. Stellen Sie sicher, dass der Proxy-Status (Proxy status) deaktiviert (off) ist.
Entnehmen Sie die Werte für Ihre DNS-Einträge dem Stape-Konto:
Als Ergebnis erhalten Sie zwei DNS-Einträge:
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:
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:
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.stapedesk.com/Ihre Tagging-Server-URL ist.
Für die Tagging-Server-URL haben Sie zwei Optionen:
- [Nicht empfohlen] Die Standard-Tagging-Server-URL von Stape (z. B.
https://wapdsrl.ca.stape.io). - [Empfohlen] 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 Sie eine benutzerdefinierte Subdomain als Same-Origin-Tagging-Server-URL verwenden, stellen Sie sicher, dass Sie Ihrem sGTM-Container auf Stape eine benutzerdefinierte Domain hinzugefügt und die erforderlichen DNS-Einträge. 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
Gehen Sie zu Ihrem sGTM-Worker → klicken Sie auf Settings → Domains & Routes → erstellen Sie eine neue Route. Fügen Sie die URL hinzu, die Sie für den Server-GTM verwenden, mit * am Ende (in unserem Beispiel ist das stapedesk.com/metrics*) und wählen Sie Ihre Domain in der Zonenauswahl.
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.
Wenn Sie keine eigene Subdomain verwenden und Anfragen an die Standard-Stape-Subdomain weiterleiten, müssen Sie auch den X-Stape-Host Header hinzufügen.
Gehen Sie zu Rules → Overview → Create Rule → Request Header Transform Rule:
- Geben Sie einen beschreibenden Regelnamen ein, z. B. sGTM same origin Stape host.
- 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-Stape-Hostmit dem Wert des Hosts, auf dem Ereignisse stattfinden (in unserem Beispiel ist das stape.work).
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.
- Im Cloudflare-DNS Records stellen Sie sicher, dass Anfragen an Ihre Hauptdomain über Cloudflare weitergeleitet werden.
- Im SSL/TLS überprüfen Sie, ob der Verschlüsselungsmodus auf Full gesetzt ist. Wenn nicht, klicken Sie auf Configure, wählen Sie Full und klicken Sie auf Save. Diese Änderung kann bis zu 24 Stunden dauern, geben Sie ihr also genug Zeit zum Aktualisieren.
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.
Kommentare