Hoe voeg je een eigen domein toe aan server-side Google Tag Manager
Geschreven door
Ira Holubovska
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
Om te profiteren van alle server-side tracking voordelen is het instellen van first-party cookies essentieel, maar dit staat 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
Gebruik een aangepaste URL van de tagging-server, ook wel een aangepast domein genoemd, om first-party cookies in te stellen. Deze URL moet hetzelfde hoofddomein gebruiken als je website. Als je website bijvoorbeeld `example.com` is, kan de URL van je tagging-server `ss.example.com` zijn.
Er zijn drie manieren om een aangepast domein in te stellen:
- Dezelfde oorsprong – de tagging-server deelt exact hetzelfde domein en pad als je site. Lees meer over het instellen van een aangepast domein met dezelfde oorsprong.
- Subdomein – de tagging-server draait op een subdomein van uw hoofddomein. In dit artikel begeleiden we u bij deze installatie.
- Standaarddomein – geen aangepast domein; maakt gebruik van het standaardadres dat door Stape wordt verstrekt.
Zie de handleiding voor GTM-domeinen aan de serverzijde voor een gedetailleerde vergelijking van deze methoden.
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
Een aangepast subdomein toevoegen met A- en AAAA-records
| Let op: A/AAAA-records zijn niet compatibel met ingeschakelde CDN. |
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:
Om sommige tags correct te laten werken, mag uw CDN geen caching of query string-sortering toepassen. Cloudflares Query String Sort of URL normalization, bijvoorbeeld, zal de sendPixelFromBrowser API verstoren die door sommige server-side tags wordt gebruikt.
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:
Als u een platform gebruikt dat hierboven niet wordt vermeld, stellen we het op prijs als u uw suggesties kunt sturen naar support@stape.io.
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.shop.stapedesk.com/uw taggingserver-URL is.
Voor de taggingserver-URL heeft u twee opties:
- De standaard taggingserver-URL van Stape (bijv.
https://wapdsrl.ca.stape.io). - 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 je een aangepast subdomein gebruikt als same-origin tagging server URL, zorg er dan voor dat je een aangepast domein hebt toegevoegd aan je sGTM-container op Stape en de vereiste DNS-records hebt aangemaakt zoals hier beschreven. 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 je sGTM worker → klik op Domains → Add domain → Route pattern. Selecteer je domein uit de lijst en voeg de URL toe die je gebruikt voor de server GTM, eindigend op * (in ons voorbeeld is dat shop.stapedesk.com/metrics*).
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.
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.
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.
Wil je aan de serverkant beginnen?
Probeer gratis
Opmerkingen