Comment ajouter un domaine personnalisé au Google Tag Manager Conteneur Serveur
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 sGTM 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.
Utilisation d'un sous-domaine
É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]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb4d4ee5800929109940.png&w=3840&q=75)
- 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"]](/_next/image?url=https%3A%2F%2Fcdn.stape.io%2Fi%2F69fb4fd4798dd969014373.png&w=3840&q=75)
- 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
Vous devez créer un enregistrement CNAME si vous n'utilisez pas Stape Global CDN, et deux enregistrements si vous l'utilisez.
1. Connectez-vous à votre service de noms de domaine et créez un nouvel enregistrement DNS pour le sous-domaine que vous souhaitez utiliser. Pour ce faire, cliquez sur les trois points et choisissez Configure DNS à côté du nom de votre domaine sur la page d'accueil du compte.
2. Cliquez sur Add record.
3. Revenez à votre compte Stape et saisissez l'enregistrement indiqué dans le compte. Assurez-vous que le statut du proxy (Proxy status) est désactivé (off).
Nous utilisons Stape Global CDN, nous créons donc deux enregistrements 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é. |
1. Si vous devez vérifier votre sous-domaine personnalisé à l'aide d'enregistrements A et AAAA, ajoutez le sous-domaine personnalisé au conteneur et assurez-vous que le bouton CDN est désactivé.
Cliquez sur Advanced settings et cochez la case Use A records instead of CNAME records. Vous verrez les enregistrements DNS à ajouter dans votre conteneur Stape. Les enregistrements DNS à configurer varient selon l'emplacement du serveur.
2. Connectez-vous à votre compte DNS et ajoutez les enregistrements indiqués dans votre compte Stape. Sur la page d'accueil du compte, à côté du nom de votre domaine, cliquez sur les trois points et choisissez Configure DNS.
3. Cliquez sur Add record.
4. Créez ensuite les enregistrements indiqués dans votre compte Stape. Assurez-vous que le statut du proxy (Proxy status) est désactivé (off).
Prenez les valeurs de vos enregistrements DNS dans le compte Stape :
Vous obtiendrez ainsi deux enregistrements DNS :
É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:
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:
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/ est le path que vous avez choisi pour votre conteneur serveur.
- https://sst.stapedesk.com/ est l'URL de votre serveur de balisage.
Pour l'URL du serveur de balisage, vous avez deux options :
- [Non recommandé] L'URL du serveur de balisage par défaut fournie par Stape (p. ex.,
https://wapdsrl.ca.stape.io). - [Recommandé] 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 du serveur de balisage de même origine, assurez-vous d'avoir ajouté un domaine personnalisé à votre conteneur sGTM sur Stape et créé les enregistrements DNS requis. 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 worker sGTM → cliquez sur Settings → Domains & Routes → créez une nouvelle Route. Ajoutez l'URL que vous utilisez pour le GTM serveur en la terminant par * (dans notre exemple, c'est stapedesk.com/metrics*) et sélectionnez votre domaine dans la sélection de zone.
É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.
Si vous n'utilisez pas votre propre sous-domaine et que vous proxifiez les requêtes vers le sous-domaine Stape standard, vous devez également ajouter l'X-Stape-Host en-tête.
Accédez à Rules → Overview → Create Rule → Request Header Transform Rule:
- Saisissez un nom de règle descriptif, p. ex., sGTM same origin Stape host.
- 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-Stape-Hostavec la valeur de l'hôte où les événements se produisent (dans notre exemple, c'est stape.work).
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.
- Dans DNS Records, assurez-vous que les requêtes vers votre domaine principal sont acheminées via un proxy Cloudflare.
- Dans SSL/TLS, vérifiez que le mode de chiffrement est défini sur Full. Si ce n'est pas le cas, cliquez sur Configure, sélectionnez Full, et cliquez sur Save. Ce changement peut prendre jusqu'à 24 heures, alors donnez-lui suffisamment de temps pour se mettre à jour.
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 avez des difficultés à ajouter un domaine personnalisé?
Il suffit de répondre à quelques questions simples. Cliquez sur Obtenir de l'aide, remplissez le formulaire, et nous vous guiderons.
Commentaires