Hoe voeg je een eigen domein toe aan server-side Google Tag Manager
In dit artikel leggen we uit hoe je een eigen domein instelt binnen de servercontainer van Google Tag Manager. Het belangrijkste voordeel van een eigen domein voor sGTM is dat het de levensduur van cookies verlengt door first-party cookies te plaatsen in plaats van third-party cookies.
Voordelen van het koppelen van een eigen domein binnen sGTM
Het belangrijkste voordeel van server-side tagging is het instellen van first-party cookies, maar dit is niet standaard ingeschakeld. Om hiervan gebruik te maken, moet je een eigen domein implementeren in je GTM-servercontainer.
Aangezien Chrome de laatste browser is die third-party cookies ondersteunt en deze begin 2025 zal afschaffen, is dit het moment om over te stappen op first-party cookies.
⚠️UPDATE: Google heeft aangekondigd dat het zijn plannen om third-party cookies uit te faseren niet langer doorzet. In plaats daarvan komt er een nieuwe oplossing: een eenmalige prompt waarmee gebruikers hun voorkeuren kunnen instellen. Deze instellingen gelden voor alle browse-ervaringen binnen Google.
De stabiliteit en levensduur van cookies die via sGTM worden geplaatst, hangen af van hoe het aangepaste domein is ingesteld. Binnen sGTM zijn er drie manieren om een aangepast domein te configureren.
Je kunt een aangepaste tagging server-URL gebruiken om first-party cookies in te stellen. Deze aangepaste URL of het aangepaste domein moet hetzelfde hoofddomein delen als je website. Bijvoorbeeld: als jouw website example.com is, dan moet de tagging server-URL eruitzien als ss.example.com.
- Same origin
- Subdomain
- Standaarddomein
Hoe voeg je een aangepast domein toe binnen de server Google Tag Manager-container
Allereerst moet je de Google Tag Manager-servercontainer aanmaken en instellen. Als je nog geen servercontainer hebt, volg dan deze instructie.
We laten twee manieren zien om een aangepast domein te koppelen aan de server Google Tag Manager-container:
- Gebruik van een subdomein.
- Gebruik van dezelfde oorsprong.
Gebruik van een subdomein
Stap 1. Voeg uw aangepaste domein toe
Kies uw container in Stape, scroll naar beneden en klik op Add custom domain.
Voeg een Subdomain name toe - dit kan elke naam zijn die u wenst, maar vermijd termen die specifiek zijn voor adverteren of tracking: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag, enz.
Stap 2. CDN toevoegen
Een Content Delivery Network (CDN) distribueert de assets van uw website via een wereldwijd netwerk van servers om de latentie te verminderen en de laadtijden te verbeteren voor gebruikers op verschillende locaties. Dit is nuttig als uw publiek geografisch verspreid is of als u het cookie-tracking en de nauwkeurigheid van gegevens wilt verbeteren.
Standaard is de CDN uitgeschakeld, wat betekent dat JavaScript-bestanden (zoals gtm.js, gtag.js en analytics.js) rechtstreeks worden geleverd vanuit de serverlocatie waar uw sGTM-container wordt gehost. In de praktijk worden zowel Stape Global CDN als Own CDN omzeild en is er een directe verbinding zonder proxy tussen uw site en de sGTM-container.
| Belangrijk: houd rekening met de privacyregelgeving van uw land voordat u een CDN instelt. |
Om de CDN in te schakelen, klikt u op de Add CDN-schakelaar en selecteert u een van de volgende opties:
- Stape Global CDN: laadt scripts van de server die het dichtst bij de locatie van uw websitebezoeker staat, wat de latentie vermindert en de laadtijden verbetert voor geografisch verspreide doelgroepen. We gebruiken Stape Global CDN in onze configuratie. Deze functie is gratis en beschikbaar voor alle Stape sGTM-containers.
- Own CDN (niet compatibel met de verbindingsoptie Automatically (via Entri)): helpt bij het routeren van het aangepaste sGTM-domein en het proxyen van sGTM-verkeer via de DNS-provider van uw website. In dit geval komen de IP-adressen van uw website en het aangepaste sGTM-domein overeen, en worden server-side cookies beschouwd als first-party cookies. Dit biedt de mogelijkheid om de cookieduur te verlengen.
Stap 3. Selecteer de verbindingsmethode
Vervolgens zijn er in de sectie How to connect twee manieren om een aangepast domein aan uw container te koppelen:
- Automatically (via Entri)
De eenvoudigste manier om domeinen te verbinden. Log in met uw DNS-providergegevens via Entri en geef ons eenmalig toestemming om uw domein te verbinden. Daarna kunt u direct doorgaan naar Stap 5 om uw domein te verifiëren; er is geen handmatige configuratie vereist.
- Manually
Met deze optie moet u DNS-records handmatig toevoegen bij uw hostingprovider om uw subdomein aan Stape te koppelen.
Nadat u een aangepast subdomein aan uw container hebt toegevoegd, ziet u de DNS-records die aangemaakt moeten worden om het aangepaste domein te verifiëren. Het DNS-record is afhankelijk van de serverlocatie en de CDN-optie die u kiest. In de volgende stap leggen we uit hoe u DNS-records toevoegt.
Stap 4. DNS-records toevoegen (voor de handmatige verbindingsmethode)
Standaard wordt subdomeenverificatie uitgevoerd met CNAME-records, maar u kunt uw subdomein ook verifiëren met A- en AAAA-records (doorgaans wanneer u wilt voorkomen dat er dubbele records worden aangemaakt).
We bespreken beide opties hieronder met een stapsgewijze handleiding voor het aanmaken van records via Cloudflare. U kunt ook elke andere provider gebruiken.
Een aangepast domein toevoegen met een CNAME-record
U moet één CNAME-record aanmaken als u Stape Global CDN niet gebruikt, en twee records als u dit wel doet.
1. Log in op uw domeinnaamservice en maak een nieuw DNS-record aan voor het subdomein dat u wilt gebruiken. Klik daarvoor op de drie puntjes naast uw domeinnaam op de startpagina van het account en kies Configure DNS.
2. Klik op Add record.
3. Ga terug naar uw Stape-account en voer het record in dat u in het account ziet. Zorg ervoor dat de Proxy status is uitgeschakeld (off).
We gebruiken Stape Global CDN, dus we maken twee CNAME-records aan:
Een aangepast subdomein toevoegen met A- en AAAA-records
| Let op: A/AAAA-records zijn niet compatibel met ingeschakelde CDN. |
1. Als u uw aangepaste subdomein wilt verifiëren met A- en AAAA-records, voegt u het aangepaste subdomein toe aan de container en zorgt u ervoor dat de CDN-schakelaar is uitgeschakeld (off).
Klik op Advanced settings en vink het vakje Use A records instead of CNAME records aan. U ziet dan de DNS-records die u in uw Stape-container moet toevoegen. Welke DNS-records u moet configureren, hangt af van de serverlocatie.
2. Log in op uw DNS-account en voeg de records toe die u in uw Stape-account ziet. Klik op de startpagina van het account naast uw domeinnaam op de drie puntjes en kies Configure DNS.
3. Klik op Add record.
4. Maak vervolgens de records aan die u in uw Stape-account ziet. Zorg ervoor dat de Proxy status is uitgeschakeld (off).
Gebruik de waarden voor uw DNS-records uit het Stape-account:
Als resultaat krijgt u twee DNS-records:
Stap 5. Uw domein verifiëren
Nadat u de DNS-records hebt ingevoerd bij uw DNS-provider, keert u terug naar de Stape-containerpagina waar u het aangepaste domein hebt geconfigureerd en klikt u op Verify.
Wacht tot Stape klaar is met het verifiëren van uw aangepaste domein (wanneer de statusbalk van de container verandert van Verifying naar Ready). Gewoonlijk duurt het 2 tot 3 uur om het aangepaste domein te verifiëren. Bij sommige DNS-providers kan het verifiëren van records tot 72 uur duren. Wij sturen u een e-mail zodra het aangepaste domein is geverifieerd of wanneer er een fout wordt gedetecteerd.
Als u problemen ondervindt bij de domeinverificatie, volg dan onze handleiding voor het oplossen van problemen met aangepaste domeinen.
Stap 6. Voeg de tagging-server-URL toe en werk uw websitescript bij
Ga naar uw Google Tag Manager-servercontainer → Admin → Container Settings → wijzig de Tagging server URL naar uw subdomein.
Het script bijwerken
Als u een aangepast domein gebruikt, wordt het sterk aanbevolen om het Web GTM-script op uw website bij te werken. Met deze aanpassing wordt gtm.js geladen vanuit uw domein. Vervang daarvoor het standaarddomein googletagmanager.com door het aangepaste domein dat u in de vorige stap hebt ingesteld.
U kunt dit proces ook automatiseren met de Custom Loader power-up. In plaats van het GTM-script handmatig te bewerken, genereert Custom Loader een kant-en-klaar codefragment dat GTM- en GA4-scripts rechtstreeks laadt vanuit uw aangepaste domein. Dit bespaart tijd, maakt uw trackingscripts beter bestand tegen advertentieblokkers en zorgt ervoor dat alle cookies als first-party cookies worden behandeld.
Gebruik van dezelfde origin
Vereisten
Zorg ervoor dat u het volgende gereed heeft voordat u begint:
- Een CDN of load balancer die in staat is verzoeken door te sturen en waarlangs al uw siteverkeer wordt geleid.
- Als u App Engine gebruikt, moet de taggingserver versie 2.2.0 of of hoger uitvoeren.
Opmerking:
Same-origin-domein stap voor stap configureren
Afhankelijk van uw infrastructuur kunt u het same-origin aangepaste domein configureren met behulp van verschillende platforms en diensten. Hier zijn de handleidingen voor elk:
Opmerking:
Hieronder doorlopen we de instelling met Cloudflare als voorbeeld.
Om deze optie te laten werken, moet al uw siteverkeer via Cloudflare worden geproxied – de Cloudflare Workers-functionaliteit stelt u dan ook in staat om sGTM-verzoeken te proxieren. U moet ook SSL/TLS in de Full-modus gebruiken; anders kan same-origin proxying via een 301-omleiding werken, wat onjuist is.
Stap 1. Een Cloudflare Worker aanmaken
Klik in de linker zijbalk op Compute → Workers & Pages → klik op Create application → selecteer de optie Start with Hello World!.
Stap 2. De worker benoemen en implementeren
Voeg een workernaam toe → klik op Deploy.
Stap 3. De workercode bewerken
Bepaal het pad voor uw sGTM aangepast domein – bijvoorbeeld example.com/sgtm, example.com/data of example.com/metrics.
Klik in de workerinstellingen op Edit code en plak JS vergelijkbaar met het onderstaande voorbeeld, waarbij:
/metrics/het pad is dat u voor uw servercontainer heeft gekozen.https://sst.stapedesk.com/uw taggingserver-URL is.
Voor de taggingserver-URL heeft u twee opties:
- [Niet aanbevolen] De standaard taggingserver-URL van Stape (bijv.
https://wapdsrl.ca.stape.io). - [Aanbevolen] Het aangepaste subdomein dat u heeft ingesteld in het Stape admin. Het gebruik van een aangepast subdomein biedt twee voordelen: het laadt
gtm.jsengtag.jsvia een aangepast pad via de Custom Loader power-up, waardoor trackingscripts niet kunnen worden geblokkeerd, en het maakt langlevende first-party cookies mogelijk.
Als u een aangepast subdomein gebruikt als same-origin taggingserver-URL, zorg er dan voor dat u een aangepast domein heeft toegevoegd aan uw sGTM-container op Stape en de vereiste DNS-records heeft aangemaakt. Gebruik Own CDN niet met het same-origin domein.
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);
},
};Implementeer en sla uw wijzigingen op.
Stap 4. Een route aan de worker toevoegen
Ga naar uw sGTM-worker → klik op Settings → Domains & Routes → maak een nieuwe Route aan. Voeg de URL toe die u gebruikt voor server-GTM en eindig met * (in ons voorbeeld is dat stapedesk.com/metrics*) en selecteer uw domein in de zoneselectie.
Stap 5. Een configuratieregel aanmaken
Klik naast uw domeinnaam op de drie puntjes → Configure Rules.
Klik op Create rule → Configuration Rules:
- Geef een begrijpelijke regelnaam op, bijv. sGTM same origin.
- Selecteer Custom filter expression.
- URI-pad begint met
/metrics(update dit als u een ander pad gebruikt). - SSL → selecteer de optie Full.
Klik op Deploy.
Stap 6. Een Request Header Transform-regel aanmaken
Ga naar Rules → Overview → Create Rule → Request Header Transform Rule:
- Voer een beschrijvende regelnaam in, bijv. sGTM header.
- Selecteer Custom filter expression.
- URI-pad begint met
/metrics(update dit als u een ander pad gebruikt). - Stel een statische headernaam in:
X-From-Cdnmet de waardecf-stape.
Sla de regel op.
Als u uw eigen subdomein niet gebruikt en verzoeken doorstuurt naar het standaard Stape-subdomein, moet u ook de X-Stape-Host header toevoegen.
Ga naar Rules → Overview → Create Rule → Request Header Transform Rule:
- Voer een beschrijvende regelnaam in, bijv. sGTM same origin Stape host.
- Selecteer Custom filter expression.
- URI-pad begint met
/metrics(update dit als u een ander pad gebruikt). - Stel een statische headernaam in:
X-Stape-Hostmet de waarde van de host waar gebeurtenissen plaatsvinden (in ons voorbeeld is dat stape.work).
Sla de regel op.
Stap 7. Custom Loader bijwerken
Zodra de same-origin instelling is voltooid, raden we ook aan de Custom Loader power-up bij te werken voor adblocker-bescherming en deze op uw site te implementeren. Vergeet niet uw Same Origin-pad daarin op te geven.
Zie voor meer informatie onze handleiding over Custom Loader.
Stap 8. De servercontainer-URL toevoegen in de web- en server-GTM
1. Voeg in uw web-GTM-container Google Tag toe en geef uw Measurement-ID op (elke ID werkt voor testen). Stel server_container_url in op het same-origin pad dat u heeft geconfigureerd (in ons voorbeeld is dathttps://stapedesk.com/metrics).
2. Om het testen te stroomlijnen, klikt u op Admin → Container Settings → voer het pad in onder Server container URLs.
3. Voor het testen van het same-origin domein (zoals we laten zien in de onderstaande stap) moet u ook een Client configureren (die gegevens van de webcontainer naar de servercontainer verzendt) en de Google Analytics: GA4-tag in de server-GTM.
Als Client gebruiken we GA4.
Om de GA4-Client toe te voegen in de server-GTM, opent u de clients-sectie → Create New client → Selecteer het clienttype Google Analytics: GA4 (Web) → Voeg de clientnaam toe en klik op Save.
Om de GA4-tag te configureren, voegt u een nieuwe tag toe met tagconfiguratie “Google Analytics: GA4” en geef eenvoudig uw Measurement-ID op in de tag.
Voeg de trigger toe voor een tag. Deze moet activeren wanneer de clientnaam de verzoeken ontvangt (in ons geval is de Client GA4):
Uw Same Origin-instelling testen
Klik op Preview in zowel de web- als de server-GTM-containers.
Als alles correct is ingesteld, moet de servercontainer in de voorvertoning worden geopend op het nieuwe pad dat u heeft aangemaakt. Als de voorvertoning om de een of andere reden niet op het nieuwe pad wordt geopend, kunt u dit handmatig invoeren in de URL van het voorvertoningsvenster.
- In Cloudflares DNS Records zorgt u ervoor dat verzoeken naar uw hoofddomein via Cloudflare worden geproxied.
- In SSL/TLS controleert u of de versleutelingsmodus is ingesteld op Full. Als dat niet het geval is, klikt u op Configure, selecteer Full en klik op Save. Deze wijziging kan tot 24 uur duren, geef het dus voldoende tijd om bij te werken.
Bezoek uw website. In de server-containervoorvertoning zou u nu een inkomend page_view verzoek van het echte domein van uw website moeten zien.
Conclusie
Het toevoegen van een custom domain aan een Google Tag Manager (GTM) servercontainer kan een groot verschil maken in de effectiviteit en flexibiliteit van je server-side tracking. In dit artikel hebben we twee methoden voor het instellen van een custom domain besproken.
De same-origin benadering biedt extra beveiliging en eenvoudiger cookiebeheer, ideaal voor enkelvoudige en gerichte domeinen. Een subdomeinconfiguratie biedt meer flexibiliteit en prestatieoptimalisatie, geschikt voor complexe of meervoudige domeinstructuren. Beide opties hebben hun voor- en nadelen op het gebied van complexiteit, prestaties en beheer. Denk goed na over je technische vereisten, beveiligingsbehoeften en trackingdoelen om de juiste configuratie voor jouw server-side tracking te kiezen.
Heb je vragen? Bezoek dan onze helpdesk of dien een ticket in. Ons team van experts helpt je graag met alles wat te maken heeft met de hosting en server-side tracking van Stape.
Opmerkingen