Comment ajouter un domaine personnalisé au Google Tag Manager Conteneur Serveur
Rédigé par
Ira Holubovska
Dans cet article, je vais décrire comment configurer un sous-domaine personnalisé dans votre conteneur de serveur Google Tag Manager. Le principal avantage d'un sous-domaine personnalisé à l'intérieur du conteneur de serveur Google Tag Manager est qu'il permet de contourner Intelligent Tracking Prevention, les AdBlockers et augmente la durée de vie des cookies pour les utilisateurs qui naviguent en Safari. Les pixels seront chargés à partir de votre sous-domaine et exécutés en tant que propriétaires.
Pourquoi devriez-vous utiliser un sous-domaine personnalisé dans le conteneur de serveur Google Tag Manager?
L'avantage essentiel du marquage côté serveur réside dans la mise en place de cookies de première partie, bien que cela ne soit pas activé par défaut. Pour tirer parti de cette capacité, il est nécessaire d'implémenter un domaine personnalisé dans votre GTM côté serveur.
Étant donné que Chrome est le dernier navigateur à prendre en charge les cookies tiers et qu'il les supprimera progressivement au début de l'année 2025, il est temps de commencer à utiliser des cookies de première partie plutôt que de tierce partie.
⚠️UPDATE: Google a annoncé qu'il ne poursuivrait pas son projet d'élimination progressive des cookies tiers. Au lieu de cela, l'entreprise introduira une nouvelle solution: une invite unique permettant aux utilisateurs de définir leurs préférences, qui s'appliqueront à toutes les expériences de navigation sur Google.
La stabilité et la longévité des cookies définis par Google Tag Manager server-side tracking dépendent de la manière dont un domaine personnalisé est mis en œuvre. Il existe trois types de configurations de domaines personnalisés dans sGTM.
Vous pouvez utiliser une URL de serveur de balisage personnalisée pour configurer des cookies de première partie. L'URL du serveur de marquage personnalisé ou le domaine personnalisé doit partager le même domaine que votre site web. Par exemple, si le domaine de votre site web est example.com, l'URL du serveur de balisage doit ressembler à ss.example.com.
Il existe trois façons de configurer un domaine personnalisé:
- Même origine
- Sous-domaine
- Domaine par défaut
Comment ajouter un sous-domaine personnalisé dans le conteneur de serveur Google Tag Manager?
Tout d'abord, vous devez créer et configurer un conteneur de serveur Google Tag Manager. Si vous n'avez pas de conteneur de serveur, suivez ces instructions.
Nous allons montrer deux façons de mapper un domaine personnalisé pour le conteneur du serveur Google Tag Manager:
- Utilisation d'un sous-domaine.
- En utilisant la même origine.
Utiliser el subdominio
Utilisez une URL de serveur de balisage personnalisée, également appelée domaine personnalisé, pour définir des cookies propriétaires. Cette URL doit utiliser le même domaine racine que votre site web. Par exemple, si votre site web est `example.com`, l’URL de votre serveur de balisage peut être `ss.example.com`.
Il existe trois façons de configurer un domaine personnalisé :
- Même origine – le serveur de balisage partage exactement le même domaine et le même chemin d’accès que votre site. En savoir plus sur la configuration d’un domaine personnalisé avec la même origine.
- Sous-domaine – le serveur de balisage s’exécute sur un sous-domaine de votre domaine racine. Dans cet article, nous vous guiderons tout au long de cette configuration.
- Domaine par défaut – pas de domaine personnalisé ; utilise l’adresse standard fournie par Stape.
Pour une comparaison détaillée de ces méthodes, consultez le guide sur les domaines GTM côté serveur.
Étape 1. Ajouter votre domaine personnalisé
Choisissez votre conteneur dans Stape, faites défiler vers le bas et cliquez sur Add custom domain.
Ajoutez le Subdomain name : il peut s'agir de n'importe quel nom qui vous convient, mais veillez à éviter les termes liés à la publicité ou au suivi : ad, gtm, stgm, tracking, analytics, metrics, stape, gtag, etc.
Étape 2. Ajouter un CDN
Un Content Delivery Network (CDN) distribue les ressources de votre site web sur un réseau mondial de serveurs afin de réduire la latence et d'améliorer les temps de chargement pour les utilisateurs situés dans différentes régions. Cette option est utile si votre audience est géographiquement dispersée ou si vous souhaitez améliorer le suivi des cookies et la précision des données.
Par défaut, le CDN est désactivé, ce qui signifie que les fichiers JavaScript (tels que gtm.js, gtag.js et analytics.js) sont servis directement depuis le serveur où votre conteneur sGTM est hébergé. En pratique, cela contourne à la fois Stape Global CDN et Own CDN et établit une connexion directe, sans proxy, entre votre site et le conteneur sGTM.
| Important : veuillez tenir compte de la réglementation en matière de protection des données de votre pays avant de configurer un CDN. |
Pour activer le CDN, cliquez sur le bouton Add CDN et sélectionnez l'une des options suivantes :
![[Bouton d'activation du CDN]](/cdn-cgi/image/width=3840,quality=75,format=auto/https://cdn.stape.io/i/69fb4d4ee5800929109940.png)
- Stape Global CDN : charge les scripts depuis le serveur le plus proche de la localisation du visiteur de votre site web, ce qui réduit la latence et améliore les temps de chargement pour les audiences géographiquement dispersées. Nous utiliserons Stape Global CDN dans notre configuration. Cette fonctionnalité est gratuite et disponible pour tous les conteneurs sGTM de Stape.
- Own CDN (incompatible avec l'option de connexion Automatically (via Entri)) : permet d'acheminer le domaine personnalisé de sGTM et de faire transiter le trafic sGTM par le fournisseur DNS de votre site web. Dans ce cas, les adresses IP de votre site web et du domaine personnalisé de sGTM correspondront, et les cookies côté serveur seront considérés comme des cookies propriétaires. Cela permet ainsi d'augmenter la durée de vie des cookies.
Étape 3. Sélectionner la méthode de connexion
Ensuite, dans la section How to connect, deux méthodes permettent de connecter un domaine personnalisé à votre conteneur :
![[Options "How to connect"]](/cdn-cgi/image/width=3840,quality=75,format=auto/https://cdn.stape.io/i/69fb4fd4798dd969014373.png)
- Automatically (via Entri)
La méthode la plus simple pour connecter des domaines. Connectez-vous avec vos identifiants de fournisseur DNS via Entri et accordez-nous une autorisation unique pour connecter votre domaine. Vous pouvez ensuite passer directement à l'Étape 5 pour vérifier votre domaine ; aucune configuration manuelle n'est requise.
Manually
Avec cette option, vous devez ajouter manuellement des enregistrements DNS auprès de votre hébergeur pour connecter votre sous-domaine à Stape.
Après avoir ajouté un sous-domaine personnalisé à votre conteneur, vous verrez les enregistrements DNS à créer pour vérifier le domaine personnalisé. L'enregistrement DNS dépend de l'emplacement du serveur et de l'option CDN choisie. L'étape suivante explique comment ajouter des enregistrements DNS.
Étape 4. Ajouter des enregistrements DNS (pour la méthode de connexion manuelle)
Par défaut, la vérification du sous-domaine est effectuée avec des enregistrements CNAME, mais vous pouvez également vérifier votre sous-domaine avec des enregistrements A et AAAA si nécessaire (généralement dans les cas où vous devez éviter la création d'enregistrements en double).
Nous couvrons les deux options ci-dessous avec un guide étape par étape sur la création d'enregistrements via Cloudflare. Vous pouvez utiliser n'importe quel autre fournisseur.
Ajouter un domaine personnalisé avec un enregistrement CNAME
Ajouter un sous-domaine personnalisé avec des enregistrements A et AAAA
| Veuillez noter que les enregistrements A/AAAA sont incompatibles avec le CDN activé. |
Étape 5. Vérifier votre domaine
Une fois les enregistrements DNS ajoutés auprès de votre fournisseur DNS, revenez à la page du conteneur Stape où vous avez configuré le domaine personnalisé et cliquez sur Verify.
Attendez que Stape termine la vérification de votre domaine personnalisé (lorsque la barre de statut du conteneur passe de Verifying à Ready). En général, la vérification du domaine personnalisé prend entre 2 et 3 heures. Pour certains fournisseurs DNS, la vérification des enregistrements peut prendre jusqu'à 72 heures. Nous vous enverrons un e-mail une fois le domaine personnalisé vérifié ou en cas d'erreur détectée.
Si vous rencontrez des problèmes lors de la vérification du domaine, veuillez suivre notre guide de dépannage des domaines personnalisés.
Étape 6. Ajouter l'URL du serveur de balisage et mettre à jour le script de votre site web
Accédez à votre conteneur serveur Google Tag Manager → Admin → Container Settings → modifiez Tagging server URL en indiquant votre sous-domaine.
Mettre à jour le script
Si vous utilisez un domaine personnalisé, il est fortement recommandé de mettre à jour le script Web GTM sur votre site web. Cette modification permettra de charger gtm.js depuis votre domaine. Pour ce faire, remplacez le domaine par défaut googletagmanager.com par le domaine personnalisé configuré à l'étape précédente.
Vous pouvez également automatiser ce processus avec le Custom Loader power-up. Au lieu de modifier manuellement le script GTM, Custom Loader génère un extrait de code prêt à l'emploi qui charge les scripts GTM et GA4 directement depuis votre domaine personnalisé. Cela vous fait gagner du temps, rend vos scripts de suivi plus résistants aux bloqueurs de publicités et garantit que tous les cookies sont traités comme des cookies propriétaires.
Utiliser la même origine
Prérequis
Avant de commencer, assurez-vous d'avoir les éléments suivants en place :
- Un conteneur serveur Google Tag Manager configuré sur Stape.
- Un CDN ou équilibreur de charge capable de transférer les requêtes, par lequel tout le trafic de votre site est acheminé.
- Si vous utilisez App Engine, le serveur de balisage doit exécuter la version 2.2.0 ou ou ultérieure.
Remarque:
Pour que certaines balises fonctionnent correctement, votre CDN ne doit pas appliquer de mise en cache ni de tri des chaînes de requête. Le Query String Sort de Cloudflare ou URL normalization, par exemple, interférera avec l'sendPixelFromBrowser API utilisée par certaines balises côté serveur.
Configuration du domaine de même origine étape par étape
Selon votre infrastructure, vous pouvez configurer le domaine personnalisé de même origine à l'aide de différentes plateformes et services. Voici les guides pour chacun :
Remarque : Si vous utilisez une plateforme non répertoriée ci-dessus, nous vous serions reconnaissants de bien vouloir envoyer vos suggestions à support@stape.io.
Remarque:
Si vous utilisez une plateforme non répertoriée ci-dessus, nous vous serions reconnaissants de bien vouloir envoyer vos suggestions à support@stape.io.
Ci-dessous, nous allons parcourir la configuration en utilisant Cloudflare comme exemple.
Pour que cette option fonctionne, tout le trafic de votre site doit être acheminé via un proxy Cloudflare – la fonctionnalité Cloudflare Workers vous permettra alors de proxifier également les requêtes sGTM. Vous devez également utiliser SSL/TLS en mode Full ; sinon, le proxy de même origine peut fonctionner via une redirection 301, ce qui est incorrect.
Étape 1. Créer un Cloudflare Worker
Dans la barre latérale gauche, cliquez sur Compute → Workers & Pages → cliquez sur Create application → sélectionnez l'option Start with Hello World!.
Étape 2. Nommer et déployer le worker
Ajoutez un nom de worker → cliquez sur Deploy.
Étape 3. Modifier le code du worker
Choisissez le path pour votre domaine personnalisé sGTM – par exemple, example.com/sgtm, example.com/data, or example.com/metrics.
Dans les paramètres du worker, cliquez sur Edit code et collez un code JS similaire à l'exemple ci-dessous, où :
/metrics/https://sst.shop.stapedesk.com/
Pour l'URL du serveur de balisage, vous avez deux options :
- L'URL du serveur de balisage par défaut fournie par Stape (p. ex.,
https://wapdsrl.ca.stape.io). - Le sous-domaine personnalisé que vous avez configuré dans le Stape admin. L'utilisation d'un sous-domaine personnalisé offre deux avantages : il charge
gtm.jsetgtag.jsdepuis un path personnalisé via le Custom Loader power-up, rendant les scripts de suivi inbloquables, et il active les cookies first-party de longue durée.
Si vous utilisez un sous-domaine personnalisé comme URL de votre serveur de tagging same-origin, assurez-vous d'avoir ajouté un domaine personnalisé à votre conteneur sGTM sur Stape et d'avoir créé les enregistrements DNS requis comme décrit ici. N'utilisez pas Own CDN avec le domaine de même origine.
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);
},
};
Déployez et enregistrez vos modifications.
Étape 4. Ajouter une route au worker
Accédez à votre sGTM worker → cliquez sur Domains → Add domain → Route pattern. Sélectionnez votre domaine dans la liste et ajoutez l'URL que vous utilisez pour le server GTM se terminant par * (dans notre exemple, c'est shop.stapedesk.com/metrics*).
Étape 5. Créer une règle de configuration
À côté de votre nom de domaine, cliquez sur les trois points → Configure Rules.
Cliquez sur Create rule → Configuration Rules:
- Spécifiez un nom de règle compréhensible, p. ex., sGTM same origin.
- Sélectionnez Custom filter expression.
- Le chemin URI commence par
/metrics(mettez à jour si vous utilisez un path différent). - SSL → sélectionnez l'option Full.
Cliquez sur Deploy.
Étape 6. Créer une règle de transformation d'en-tête de requête
Accédez à Rules → Overview → Create Rule → Request Header Transform Rule:
- Saisissez un nom de règle descriptif, p. ex., sGTM header.
- Sélectionnez Custom filter expression.
- Le chemin URI commence par
/metrics(mettez à jour si vous utilisez un path différent). - Définissez un nom d'en-tête statique
X-From-Cdnavec la valeurcf-stape.
Enregistrez la règle.
Étape 7. Mettre à jour le Custom Loader
Une fois la configuration de même origine terminée, nous recommandons également de mettre à jour le power-up Custom Loader pour la protection contre les bloqueurs de publicités et de l'implémenter sur votre site. N'oubliez pas d'y spécifier votre path Same Origin.
Pour plus d'informations, consultez notre guide sur le Custom Loader.
Étape 8. Ajouter l'URL du conteneur serveur dans le GTM web et serveur
1. Dans votre conteneur GTM web, ajoutez Google Tag et spécifiez votre ID de mesure (n'importe quel ID fonctionne pour les tests). Définissez le server_container_url sur le path de même origine que vous avez configuré (dans notre exemple, c'est https://stapedesk.com/metrics).
2. Pour simplifier les tests, cliquez sur Admin → Container Settings → saisissez le path sous Server container URLs.
3. Pour les tests du domaine de même origine (comme nous le montrons dans l'étape ci-dessous), vous devrez également configurer un Client (qui transmettra les données du conteneur web au conteneur serveur) et la balise Google Analytics : GA4 dans le conteneur GTM server.
Comme Client, nous utiliserons GA4.
Pour ajouter le Client GA4 dans le GTM serveur, ouvrez la section des clients → Create New client → Sélectionnez le type de client Google Analytics : GA4 (Web) → Ajoutez le nom du client et cliquez sur Save.
Pour configurer la balise GA4, ajoutez une nouvelle balise avec la configuration de balise “Google Analytics: GA4”, et spécifiez simplement votre ID de mesure dans la balise.
Et ajoutez le déclencheur pour la balise. Il doit se déclencher lorsque le nom du client reçoit les requêtes (dans notre cas, le Client est GA4) :
Test de votre configuration Same Origin
Cliquez sur Preview dans les deux conteneurs GTM, web et serveur.
Si tout est correctement configuré, le conteneur serveur devrait s'ouvrir en prévisualisation au nouveau path que vous avez créé. Si, pour une raison quelconque, la prévisualisation ne s'ouvre pas au nouveau path, vous pouvez le saisir manuellement dans l'URL de la fenêtre de prévisualisation.
Visitez votre site web. Dans la prévisualisation du conteneur server, vous devriez maintenant voir une requête entrante page_view provenant du vrai domaine de votre site web.
Conclusion
L'ajout d'un domaine personnalisé à un conteneur de serveur Google Tag Manager (GTM) peut avoir un impact significatif sur l'efficacité et la flexibilité de votre suivi côté serveur. Dans cet article, nous avons proposé deux méthodes de mise en œuvre des domaines personnalisés.
Une approche de même origine offre une sécurité accrue et une gestion plus simple des cookies, ce qui est idéal pour les domaines uniques et ciblés. Une configuration en sous-domaine offre une flexibilité et une optimisation des performances, adaptée aux structures de domaines complexes ou multiples. Chacune de ces solutions présente des avantages en termes de complexité, de performances et de gestion. Examinez attentivement vos exigences techniques, vos besoins en matière de sécurité et vos objectifs de suivi afin de sélectionner la configuration la plus appropriée pour votre suivi côté serveur.
Si vous avez des questions, visitez notre service d'assistance ou écrivez un ticket. Notre équipe d'experts sera heureuse de vous aider pour toute question concernant l'hébergement de Stape et le suivi côté serveur.
Vous voulez passer au suivi côté serveur ? Vous pouvez le faire gratuitement chez Stape ! Cliquez sur Essayez gratuitement et découvrez les avantages !
Vous souhaitez rejoindre le côté serveur?
Essayez gratuitementPostes pertinents
Blog
Combien coûte le serveur GTM et pourquoi Stape est moins cher que Google Cloud Run
Quel coût peut-on prévoir pour un serveur Google Tag Manager hébergé sur Google Cloud ? Est-ce une bonne idée d'utiliser un environnement de test sur le site de production. Pourquoi l'hébergement de Stape pour le serveur GTM est moins cher et comment nous sécurisons les données de nos utilisateurs.
17 juil. 2026
Commentaires