githubModifier

Commanders Tag Gateway (closed beta)

Ce document décrit comment déployer Commanders Act Tag Gateway, un gateway unifiée en first-party qui utilise une seule configuration et un seul chemin sur votre domaine pour alimenter plusieurs cas d'utilisation de tracking et d'hébergement.

Commanders Act Tag Gateway inclut Google Tag Gateway, mais n'est pas limité à Google. Il est conçu pour servir et collecter des données pour tous vos partenaires marketing et analytics, en utilisant la même infrastructure en first-party.

Une configuration, un chemin en first-party, trois usages :

  • Google Tag Gateway (GA4, Google Ads)

  • Tracking en first-party vers toutes les destinations server-side

  • Hébergement en first-party de bibliothèques third-party

Si votre objectif est d'implémenter Google Tag Gateway, vous êtes au bon endroit. Si votre objectif est de construire une architecture de tracking en first-party durable et agnostique vis-à-vis des fournisseurs, vous êtes également au bon endroit.


Pourquoi utiliser Commanders Gateway ?

1. Avantages d'utiliser un gateway

Une configuration de gateway améliore la qualité et l'exhaustivité de la collecte de données à travers votre stack marketing.

  • Les scripts des vendors sont servis depuis votre propre domaine, ce qui réduit la probabilité d'être bloqués par les adblockers.

  • Les restrictions des navigateurs (comme l'ITP de Safari) limitent ou bloquent souvent les cookies third-party et certains cookies javascript 1st party, mais avec une configuration server-side en first-party, la mesure reste plus fiable.

  • Cela garantit un tracking plus précis, fournissant aux partenaires des signaux de meilleure qualité pour la mesure, l'attribution et l'optimisation.

2. Avantages d'utiliser Commanders Gateway

En plus des bénéfices de toute approche de gateway, Commanders Gateway ajoute des avantages uniques :

  • Pas limité à Google Tag Gateway — la même configuration durable s'applique à tous vos partenaires (Meta, Snapchat, Bing, Awin, etc.).

  • Configuration unifiée : un chemin unique (/metrics) sert et reverse-proxy toutes les bibliothèques des vendors.

  • Des noms de fichiers JavaScript obfusqués sont automatiquement fournis par Commanders Act, rendant la détection par les listes de blocage beaucoup plus difficile.

  • Avec le même chemin simple, vous pouvez aussi activer d'autres fonctionnalités d'hébergement et de tracking en first-party telles que : héberger vos containers de tag management, du tracking d'événements server-side, ou des statistiques anonymes CMP. Une seule configuration alimente l'ensemble de votre système d'hébergement et de tracking en first‑party.

  • Une configuration centralisée simplifie le déploiement et la maintenance tout en restant préparée pour l'avenir face aux prochaines restrictions des navigateurs.


Aperçu

Commanders Gateway vous permet de déployer des tags marketing et de mesure en utilisant votre propre infrastructure en first-party, hébergée sur le domaine de votre site. Cette infrastructure se situe entre votre site web et les services de vos partenaires (Google, Meta, Bing, Snapchat, Awin, etc.).

Avec Commanders Gateway :

  • Les bibliothèques Google (gtag.js / gtm.js) sont chargées directement depuis votre domaine en first-party.

  • Les autres bibliothèques vendors sont servies depuis /metrics/js/ en utilisant des noms de fichiers obfusqués.

  • Toutes les requêtes de mesure sont proxyfiées via votre domaine avant d'être transférées vers les endpoints des partenaires respectifs.


Architecture

Avec Commanders Gateway, vous réservez un chemin unique sur votre domaine, par exemple :

  • Scripts Google (gtag.js / gtm.js) sont chargés directement depuis /metrics/.

  • Autres scripts vendors (Meta, Snapchat, Bing, Awin, etc.) sont servis depuis /metrics/js/ avec un nom de fichier obfusqué généré par Commanders Act.

Exemple :

La correspondance entre chaque vendor et son nom de fichier script obfusqué est fournie dans l'interface Commanders Act First-Party Hosting.

Schéma (conceptuel) :


Filtrage et gouvernance des cookies

Certaines organisations, en particulier celles ayant des politiques de confidentialité strictes, peuvent craindre d'envoyer des cookies en first-party à des partenaires externes comme Google. Commanders Gateway prend en charge la minimisation des données et fournit des mécanismes pour contrôler quels cookies peuvent transiter par la gateway. Deux approches complémentaires peuvent être utilisées :

Liste noire des cookies au niveau edge

Les clients peuvent filtrer les cookies directement au niveau du CDN ou de la couche edge (Cloudflare Worker, Fastly Compute, etc.). Cela peut être fait en configurant simplement le code Worker fourni dans ce guide pour supprimer des cookies spécifiques avant que la requête soit transférée à Commanders Gateway.

Cela permet de retirer des cookies spécifiques de la requête avant qu'elle n'atteigne Commanders Gateway, en s'assurant que seuls les cookies approuvés par l'organisation quittent son infrastructure.

Liste blanche de cookies avant transfert aux partenaires

Commanders Gateway peut également appliquer une liste blanche de cookies lors du transfert des requêtes aux partenaires.

Par exemple, lors du transfert de requêtes de mesure à Google, la gateway peut être configurée pour n'inclure que les cookies liés à Google (tels que _ga ou _gcl_*). Tous les autres cookies sont automatiquement exclus de la requête envoyée à Google.

Avant de commencer

Ce guide suppose que votre site est déjà configuré avec :

  • Un système de tag management (Commanders Act, Google Tag Manager, ou équivalent).

  • Un CDN ou un load balancer (Cloudflare, Akamai, Fastly, Nginx, etc.) capable de transférer des requêtes vers des endpoints externes.


Étape 1 : Choisir le chemin de service des tags

Vous devez réserver un chemin sur le domaine de votre site.

Exemple :

Attention : cette configuration reroute tout le trafic utilisant le chemin choisi. Pour éviter d'affecter votre site, choisissez un chemin qui n'est pas déjà utilisé.


Étape 2 : Router le trafic

Pour servir votre tag dans Commanders Gateway, vous allez créer une entrée CNAME pour un nouveau sous-domaine, créer une Origin Rulearrow-up-right pour transférer les requêtes, et créer une Transform Rulearrow-up-right pour inclure les informations de géolocalisation. Pour compléter cette configuration, vous devrez disposer d'un plan Cloudflare Enterprise. Si vous n'avez pas de plan Enterprise, envisagez d'utiliser à la place la configuration automatisée Cloudflare.

Créer l'entrée CNAME

Remarque : Les tags n'utiliseront pas cette entrée CNAME ; Cloudflare l'utilise pour router les requêtes en interne.

Choisissez un sous-domaine à réserver pour l'entrée CNAME. Ce CNAME n'est jamais exposé en dehors de votre configuration Cloudflare, donc le nom est arbitraire.

  1. Dans l'onglet DNS , ouvrez la section Records .

  2. Ajoutez un nouvel enregistrement avec :

    • Type : CNAME

    • Name : metrics

    • Target : s1234.commander4.com => remplacez 1234 par l'ID de votre site (alias workspace)

  3. Enregistrez l'enregistrement CNAME.

Créer l'Origin Rule

  1. Dans l'onglet Onglet Rules , ouvrez Origin Rules

  2. et créez une nouvelle règle. Saisissez un nom de règle, tel que.

  3. Route measurement

  1. (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics")) Mettez à jour l' Host Header → Réécrire en :

  2. (http.host eq "example.com" and starts_with(http.request.uri.path, "/metrics")) s1234.commander4.com. Enregistrement DNS → Remplacer par :.

  3. metrics.example.com

Enregistrez l'Origin Rule.

  1. Dans l'onglet Onglet Rules Inclure les informations de géolocalisation (optionnel).

  2. Paramètres Activez l'option Add visitor location headers

  3. .

Attendez quelques minutes pour la propagation.

https://example.com/metrics/healthy Cela devrait retourner.


Étape 3 : Mettre à jour les scripts dans votre tag management system ou votre site web

Remplacez les URLs des scripts des vendors par les nouveaux first-party paths.

Exemples :

Google

Meta (Facebook Pixel)

Snapchat

Bing (UET)

Chaque nom de fichier obfusqué est généré automatiquement et disponible dans le Commanders Act First-Party Hosting.

OneTag

Vous pouvez changer manuellement le domaine de votre configuration cact() avec le collectionDomain propriété Exemple :

Attention : ne PAS ajouter un / à la fin du chemin


Étape 4 : Vérifier la configuration

  • Pour le chemin global, vérifiez l'endpoint health :

    • Vous pouvez vérifier en naviguant vers : → devrait renvoyer Cela devrait retourner

  • Utilisez les DevTools du navigateur pour vérifier que :

    • Les scripts Google sont chargés depuis /metrics/

    • Les autres scripts vendors sont chargés depuis /metrics/js/{obfuscated}.js

    • Des requêtes sont effectuées vers votre domaine en first-party.

  • Assurez-vous que les événements apparaissent dans les dashboards des partenaires respectifs (Google Analytics, Facebook Events Manager, etc.).


Avantages

  • Durabilité: Le tracking continue de fonctionner même avec ITP de Safari et les restrictions sur les third-party cookie.

  • Résilience: Servir les scripts depuis votre domaine avec des noms de fichiers obfusqués rend plus difficile l'interférence des règles de blocage.

  • Configuration centralisée: Un seul chemin (/metrics) gère tous les vendors.

  • Préparation pour l'avenir: S'adapte au privacy sandbox et aux futures restrictions des navigateurs.

Configurer la collecte de données first party pour les fonctionnalités Commanders Act (via Gateway)

Ce chapitre explique comment router la collecte de données Commanders Act via votre first party gateway path (par exemple /metrics) pour les principales fonctionnalités Commanders Act.

Remarques importantes :

  • Le chemin gateway montré dans les exemples (/metrics) n'est qu'un exemple. Les clients choisissent leur propre chemin lors de la configuration du gateway dans leur CDN ou outil edge (Cloudflare, Akamai, etc.).

  • Tous les exemples ci-dessous supposent que votre gateway est healthy : Vous pouvez vérifier en naviguant vers : retourne Cela devrait retourner.


1. Destinations server-side via le gateway (exemple : Meta Facebook CAPI)

Le tracking server-side de Commanders Act repose sur oneTag tags. Typiquement, vous aurez un oneTag par événement que vous souhaitez collecter, par exemple :

  • page_view

  • add_to_cart

  • purchase

Pour router ces événements oneTag via le gateway, vous devez mettre à jour la oneTag tag configuration de sorte que le cact() setup utilise votre domaine et chemin de collecte first party.

Dans votre tag oneTag (ou dans le snippet partagé utilisé par vos tags oneTag), définissez collectionDomain:

--ssl-sni-hostname s1234.commander4.com

  • Remplacez www.yourdomain.com/metrics avec votre propre domaine et le chemin que vous avez configuré dans votre gateway.

  • NE PAS ajouter une barre oblique terminale / à la fin du chemin.

  • Une fois ceci défini, tous les événements oneTag (page_view, add_to_cart, purchase, etc.) seront collectés via votre chemin gateway first party.


2. CDP, Campaign Analytics et collecte CMP via le gateway

(Data Activation, Campaign Analytics, statistiques CMP et preuve de consentement)

Ces trois fonctionnalités reposent sur le même mécanisme de routage. Pour envoyer leurs données via le gateway, vous devez définir la variable tC.clientCollectDns soit :

  • directement à l'intérieur de chaque tag concerné, ou

  • dans un global configuration tag qui s'exécute avant tous les tags Commanders Act (recommandé).

Exemple :

Comportement :

  • Dès que tC.clientCollectDns est défini, la collecte pour Data Activation, Campaign Analytics, et le tracking lié au CMP sera effectuée via le gateway.

  • metrics n'est fourni qu'à titre d'exemple. Les clients peuvent utiliser n'importe quel chemin qu'ils ont configuré dans leur setup gateway.

Options d'implémentation :

  • Option A (simple) : ajoutez la ligne directement à l'intérieur du tag Data Activation / Campaign Analytics / CMP.

  • Option B (recommandée) : ajoutez-la dans un global configuration tag qui s'exécute avant tous les tags Commanders Act.


Checklist de vérification

Après avoir appliqué les changements ci-dessus, vérifiez :

  • L'endpoint de santé du gateway : Vous pouvez vérifier en naviguant vers : retourne Cela devrait retourner.

  • Dans les DevTools du navigateur (onglet Network), les requêtes de collecte Commanders Act vont vers votre domaine et chemin first party (par exemple https://example.com/metrics/...).

  • Les événements et les données apparaissent comme prévu dans :

    • Les dashboards des destinations server-side (exemple : Meta Events Manager pour CAPI)

    • Les flux Data Activation

    • Les statistiques CMP et les rapports de preuve de consentement (le cas échéant)

    • Les rapports Campaign Analytics

Mis à jour

Ce contenu vous a-t-il été utile ?