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.

Par Ron Kopelman Publié le 19 novembre 2026 ⏱ 2 h de mise en place, puis 1 semaine de contrôle des cookies Niveau : Avancé
Outils GTM Server-Side Google Tag Manager Stape Cloud Run Cloudflare
Dans ce tutoriel
  1. Ce que « first-party » veut dire pour un conteneur serveur
  2. La procédure, dans l’ordre
  3. Les pièges qui coûtent des données sans erreur visible

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.

Outils GTM Server-Side Google Tag Manager Stape Cloud Run Cloudflare

Avant de commencer

⏱ 2 h de mise en place, puis 1 semaine de contrôle des cookies Niveau : Avancé
  • 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.

OptionExempleCookies posés par le serveurCe qu’il faut en plus
Même originewww.votresite.fr/metricsOuiUn CDN ou un load balancer qui route le chemin
Sous-domainemesure.votresite.frOuiEnregistrement DNS, certificat, domaine parent vérifié
Domaine par défaut de l’hébergeurservice.run.appNon, cookies JavaScript seulementRien à 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.

Du sous-domaine au cookie : ce qui décide de sa durée

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

  1. Choisir le nom et vérifier le domaine parent15 min

    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 sur votresite.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é.

  2. Créer l'enregistrement DNS demandé15 min

    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 champ resourceRecords. 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.

  3. Attendre le certificat HTTPS15 min à 24 h

    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.fr répond sans alerte de certificat dans le navigateur.

  4. Brancher le conteneur web au serveur10 min

    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.

  5. Vérifier le point de contrôle /healthy5 min

    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.

  6. Contrôler les cookies renvoyés par le sous-domaine30 min

    Parcourez le site en navigation privée, acceptez le consentement, puis copiez les en-têtes Set-Cookie des réponses de mesure.votresite.fr depuis 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  OK

    Le cookie de domaine tiers est ignoré par le navigateur, car son attribut Domain ne 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ômeCause probableVérification
Aucun cookie serveur, mais le conteneur répondAdresse du conteneur sur le domaine par défaut de l’hébergeurVérifier dans le tag web quelle URL de serveur est saisie
Cookies présents dans Chrome, durée réduite dans SafariSous-domaine en CNAME vers un tiers, plafond de 7 joursMesurer la durée réelle des cookies dans Safari sur le même parcours
Certificat non émis après plusieurs heuresEnregistrement DNS absent, faux ou saisi dans la mauvaise zoneRequête DNS du nom et comparaison avec la valeur de la console
Aperçu correct, production silencieuseBalise web qui pointe encore vers l’ancienne adresseComparer le champ « Server container URL » des deux conteneurs
Requêtes qui arrivent après un changement DNS, puis plus rienUn ancien enregistrement encore en cache, ou un proxy placé devant le nomVé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

Ron Kopelman

Vous préférez que je le fasse ?

Je mets en place ce tutoriel sur votre site, avec recette et documentation. Cadrage gratuit de 30 minutes.