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.
Den gleichen Ursprung verwenden
Die Voraussetzungen für die Konfiguration der benutzerdefinierten Domäne mit demselben Ursprung:
1. Ein CDN oder Load Balancer, der Anfragen weiterleiten kann.
2. Wenn Sie App Engine verwenden, muss auf dem Tagging-Server Version 2.2.0 oder höher ausgeführt werden.
3. Wählen Sie den Pfad für Ihre benutzerdefinierte sGTM-Domäne, z. B. example.com/sgtm, example.com/data, example.com/metrics, usw.
Wir zeigen Ihnen 2 Beispiele für die Konfiguration der gleichen benutzerdefinierten Ursprungsdomäne für sGTM mit Cloudflare oder nginx.
1. Cloudflare
Damit diese Option funktioniert, muss der gesamte Datenverkehr Ihrer Website über CloudFlare geleitet werden. Die Funktionalität von CF Workers ermöglicht es Ihnen also, auch sGTM-Anfragen zu proxyen.
a. Erstellen Sie einen Worker in Cloudflare.
b. Name des Arbeitnehmers hinzufügen.
c. Erstellen Sie js ähnlich wie unten, wobei:
/metrics/ - ist ein Pfad, den Sie für Ihren Server-Container wählen.
https://sgtm.stape.video/ - ist die URL Ihres Tagging-Servers. Es gibt zwei Szenarien:
- [Nicht empfohlen] Die Standard-URL des Tagging-Servers, die Ihnen von stape zur Verfügung gestellt wurde. In diesem Fall sieht die URL des Tagging-Servers wie https://wapdsrl.ca.stape.io aus.
- [Empfohlen] Die benutzerdefinierte Subdomain, die Sie in der stape.io-Verwaltung eingerichtet haben. Die Verwendung einer benutzerdefinierten Subdomain bei der Konfiguration eines Workers wird empfohlen, da sie zwei Vorteile bietet: das Laden von gtm.js und gtag.js von einem benutzerdefinierten Pfad unter Verwendung von Custom Loader Power-Up, wodurch Tracking-Skripte nicht blockiert werden können und das Setzen von langlebigen First-Party-Cookies ermöglicht wird. Wenn Sie eine benutzerdefinierte Subdomain für Ihre Tagging-Server-URL gleichen Ursprungs verwenden, stellen Sie sicher, dass Sie eine benutzerdefinierte Domain zu Ihrem sGTM-Container auf stape hinzugefügt und DNS-Einträge wie hier beschrieben erstellt haben. Verwenden Sie kein eigenes CDN mit der gleichen Ursprungsdomäne.
export default {
async fetch(request, env, ctx) {
let {pathname, search, host} = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sgtm.stape.video';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
d. Gehen Sie zur Workers Route und erstellen Sie eine neue Route. Fügen Sie die URL hinzu, die Sie für Server-GTM verwenden und die mit * endet. In meinem Fall ist es stape.video/metrics* und wählen Sie den Worker, den Sie in den vorherigen Schritten erstellt haben.
2. nginx
Zu Ihrer Serverkonfiguration hinzufügen, wobei:
/metrics - Pfad, den Sie für den Server-GTM ausgewählt haben.
https://gtm.mysimple.name - benutzerdefinierte Domäne Ihres sGTM.
location = /metrics { return 302 /metrics/; }
location ~ ^/metrics(.*) {
resolver 8.8.8.8 valid=3600s;
proxy_pass https://gtm.mysimple.name$1$is_args$args;
proxy_set_header Host gtm.mysimple.name;
proxy_set_header X-From-Cdn "cf-stape";
proxy_set_header CF-Connecting-Ip $remote_addr; #If you do not use Cloudflare for your domain
#proxy_set_header CF-Connecting-Ip $http_cf_connecting_ip; #If you use Cloudflare for your domain
}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.
Haben Sie Probleme mit dem Hinzufügen einer benutzerdefinierten Domain?
Alles, was Sie brauchen, sind ein paar einfache Fragen. Klicken Sie auf Hilfe anfordern, füllen Sie das Formular aus, und wir helfen Ihnen.
Kommentare