Tutoriel
Domaine first-party pour sGTM : sous-domaine, DNS, pièges
Sous-domaine first-party pour sGTM : choix du nom, DNS et certificat, cookies posés par le serveur, plafond Safari à 7 jours et test avec script.
Dans ce tutoriel
Un conteneur serveur pose des cookies first-party seulement s’il répond sur un sous-domaine de votre site, ou sur votre site lui-même. Le nom doit partager le domaine de votre site, le DNS doit pointer vers l’hébergeur sans erreur, et la durée des cookies dépend de la façon dont ce DNS est monté : Safari raccourcit à 7 jours les cookies posés par une réponse d’un sous-domaine qui résout vers un tiers. Ce tutoriel reprend la méthode que j’applique en mission pour le choix du nom, le DNS, le certificat et le contrôle des cookies. Si vous cadrez d’abord le périmètre, ma page consultant server-side tracking le couvre ; le reste de ce guide suppose que la décision est prise.
Avant de commencer
- Un conteneur serveur créé, avec l'URL de son hébergeur
- Accès à la zone DNS du domaine de votre site
- Accès administrateur au conteneur GTM web
- Un navigateur Safari et un navigateur Chrome pour les tests
- Python 3 pour le script de contrôle
Ce que « first-party » veut dire pour un conteneur serveur
Google décrit deux façons de servir le conteneur depuis votre domaine, et une troisième qui n’en est pas une. La documentation Cloud Run demande que le serveur de tagging et le site tournent sur le même domaine. La documentation sGTM recommande la même origine, par un chemin comme votresite.fr/metrics, et accepte un sous-domaine comme metrics.votresite.fr.
| Option | Exemple | Cookies posés par le serveur | Ce qu’il faut en plus |
|---|---|---|---|
| Même origine | www.votresite.fr/metrics | Oui | Un CDN ou un load balancer qui route le chemin |
| Sous-domaine | mesure.votresite.fr | Oui | Enregistrement DNS, certificat, domaine parent vérifié |
| Domaine par défaut de l’hébergeur | service.run.app | Non, cookies JavaScript seulement | Rien à configurer, mais ce n’est pas un domaine first-party de votre site |
Le sous-domaine est le plus simple à mettre en place, car il ne demande pas de réécrire le routage du site. C’est aussi là que la question de la durée des cookies se pose.
La première situation est la seule où le serveur pose des cookies sans plafond de 7 jours connu. La deuxième ne donne pas de cookies serveur. La troisième dépend de l'infrastructure : c'est une mesure à faire, pas une promesse.
La procédure, dans l’ordre
-
Choisir le nom et vérifier le domaine parent
Prenez un nom dédié, par exemple
mesure.votresite.fr, distinct des sous-domaines déjà utilisés par la boutique ou le blog. Si l’hébergeur passe par Cloud Run, Google demande de prouver la propriété du domaine parent avant tout mapping : la vérification se fait survotresite.fr, pas sur le sous-domaine.Résultat attendu : un nom noté, dans le même domaine que le site, et le domaine parent vérifié.
-
Créer l'enregistrement DNS demandé
Dans Cloud Run, la console affiche les valeurs à copier. Elles sont aussi lisibles en ligne de commande avec
gcloud beta run domain-mappings describe --domain mesure.votresite.fr, dans le champresourceRecords. Le type (CNAME, A ou AAAA) est celui que renvoie la console : ne le devinez pas, et ne recopiez pas une valeur d’un autre projet.Résultat attendu : l’enregistrement existe dans la zone, et la requête DNS du nom renvoie la cible annoncée par l’hébergeur.
-
Attendre le certificat HTTPS
Google émet et renouvelle automatiquement le certificat géré lors du mapping. La documentation Cloud Run indique environ 15 minutes, et jusqu’à 24 heures dans certains cas. Ne basculez aucun envoi vers le nouveau nom tant que le certificat n’est pas actif.
Résultat attendu :
https://mesure.votresite.frrépond sans alerte de certificat dans le navigateur. -
Brancher le conteneur web au serveur
Dans GTM, ouvrez Admin, puis Container Settings, et saisissez l’URL du serveur dans le champ « Server container URL », puis enregistrez. La documentation Google l’indique pour que la configuration soit validée par le mode aperçu du conteneur serveur. Vérifiez que le conteneur web et le conteneur serveur pointent vers exactement la même adresse. Une fois la requête reçue, le client GA4 qui la revendique se règle à part, dans le tutoriel de paramétrage et de débogage du client GA4 dans sGTM.
Résultat attendu : dans l’aperçu du conteneur serveur, chaque page vue apparaît comme une requête reçue.
-
Vérifier le point de contrôle /healthy
Ouvrez
https://mesure.votresite.fr/healthy. Une réponse 200 indique que le serveur fonctionne. Le même point est utilisé par l’image Docker pour ses vérifications de santé : si la réponse n’est pas saine, c’est le conteneur qu’il faut redémarrer, pas le DNS.Résultat attendu : code 200 sur l’URL
/healthy, en navigation privée. -
Contrôler les cookies renvoyés par le sous-domaine
Parcourez le site en navigation privée, acceptez le consentement, puis copiez les en-têtes
Set-Cookiedes réponses demesure.votresite.frdepuis l’onglet Réseau. Collez-les dans un fichier, une ligne par cookie. Le script suivant indique, pour chaque cookie, s’il est lié au sous-domaine ou au domaine parent, ce que le navigateur en fera, et s’il dépasse 7 jours."""Classe les cookies renvoyés par le sous-domaine du conteneur serveur. Usage : python cookies_sous_domaine.py mesure.votresite.fr fichier_set_cookie.txt Le fichier contient une ligne Set-Cookie par cookie reçu (copiée depuis l'onglet Réseau). """ import sys def parse(ligne): morceaux = [m.strip() for m in ligne.split(";")] nom, _, valeur = morceaux[0].partition("=") attrs = {} for m in morceaux[1:]: k, _, v = m.partition("=") attrs[k.strip().lower()] = v.strip() if v else True return nom.strip(), attrs def couvre(domaine_cookie, hote): d = domaine_cookie.lstrip(".").lower() return hote == d or hote.endswith("." + d) def analyser(hote, lignes): hote = hote.lower() rapport = [] for ligne in lignes: if not ligne.strip(): continue nom, a = parse(ligne) dom = a.get("domain") if dom is None: portee = "host-only (" + hote + ")" ok = True elif couvre(dom, hote): portee = "partagé (" + dom.lstrip(".") + ")" ok = True else: portee = "rejeté : Domain=" + str(dom) + " ne couvre pas " + hote ok = False age = a.get("max-age") alertes = [] if not ok: alertes.append("cookie ignoré par le navigateur") if ok and age and str(age).lstrip("-").isdigit() and int(age) > 7 * 86400: alertes.append("durée > 7 j : plafonnée à 7 j si le sous-domaine résout par CNAME vers un tiers") if not a.get("secure"): alertes.append("sans Secure") rapport.append((nom, portee, (str(int(age) // 86400) + " j") if age and str(age).isdigit() else "session", "; ".join(alertes) or "OK")) return rapport def main(hote, fichier): with open(fichier, encoding="utf-8") as f: lignes = f.read().splitlines() print(f"{'cookie':10} {'portée':48} {'durée':>8} verdict") for nom, portee, duree, verdict in analyser(hote, lignes): print(f"{nom:10} {portee:48} {duree:>8} {verdict}") if __name__ == "__main__": if len(sys.argv) != 3: sys.exit(__doc__) main(sys.argv[1], sys.argv[2])Test réalisé sur un fichier de quatre cookies construit pour l’occasion (un cookie de domaine parent, un cookie lié au sous-domaine, un cookie de domaine tiers, un cookie de session) :
cookie portée durée verdict _ga_ABC123 partagé (votresite.fr) 730 j durée > 7 j : plafonnée à 7 j si le sous-domaine résout par CNAME vers un tiers _cid host-only (mesure.votresite.fr) 7 j OK _tiers rejeté : Domain=.tracker-tiers.com ne couvre pas mesure.votresite.fr 365 j cookie ignoré par le navigateur _sess host-only (mesure.votresite.fr) 1 j OKLe cookie de domaine tiers est ignoré par le navigateur, car son attribut
Domainne couvre pas l’hôte qui l’a envoyé. Les cookies d’une durée supérieure à 7 jours sont signalés : c’est la ligne à vérifier en Safari (étape suivante).Résultat attendu : un tableau de cookies avec leur portée et leur durée, consigné avant la mise en production.
Les pièges qui coûtent des données sans erreur visible
| Symptôme | Cause probable | Vérification |
|---|---|---|
| Aucun cookie serveur, mais le conteneur répond | Adresse du conteneur sur le domaine par défaut de l’hébergeur | Vérifier dans le tag web quelle URL de serveur est saisie |
| Cookies présents dans Chrome, durée réduite dans Safari | Sous-domaine en CNAME vers un tiers, plafond de 7 jours | Mesurer la durée réelle des cookies dans Safari sur le même parcours |
| Certificat non émis après plusieurs heures | Enregistrement DNS absent, faux ou saisi dans la mauvaise zone | Requête DNS du nom et comparaison avec la valeur de la console |
| Aperçu correct, production silencieuse | Balise web qui pointe encore vers l’ancienne adresse | Comparer le champ « Server container URL » des deux conteneurs |
| Requêtes qui arrivent après un changement DNS, puis plus rien | Un ancien enregistrement encore en cache, ou un proxy placé devant le nom | Vérifier la cible du nom depuis plusieurs réseaux, puis purger le cache |
Le sous-domaine n’est pas une technique de contournement : c’est un choix d’architecture qui améliore la tenue des cookies, sans garantie. Le consentement reste requis avant tout dépôt ou lecture de cookie ; un DNS propre ne le remplace pas. Le guide sur le chargement des scripts en first-party couvre l’autre face du sujet, le chargement de la balise Google depuis votre domaine.
Pour replacer le sous-domaine dans l’ensemble du chantier, voir mettre en place le server-side tracking, étape par étape. Si Google Tag Gateway suffit à votre cas, comparez-le à un conteneur serveur dans Google Tag Gateway ou sGTM. Le suivi entre sous-domaines dans GA4 est un autre sujet, traité dans le tracking des sous-domaines GA4 : ici, il s’agit du nom qui reçoit le conteneur serveur, pas de la session partagée entre deux sites.
Une fois le domaine en place, les conversions et les données utilisateur hachées passent par le même conteneur : voir le tutoriel Google Ads server-side.
Sources
- Google, Configurer le conteneur serveur et son URL, documentation Tag Manager Server-Side, consultée le 19 novembre 2026.
- Google, Configuration du domaine personnalisé, documentation Tag Manager Server-Side, consultée le 19 novembre 2026.
- Google Cloud, Mapper des domaines personnalisés à Cloud Run, consultée le 19 novembre 2026.
- WebKit, CNAME cloaking and bounce tracking defenses, consultée le 19 novembre 2026.