Commanders Tag Gateway (closed beta)

Ce document s'adresse aux utilisateurs qui souhaitent déployer Google Tag Gateway (via Commanders Act) ou son équivalent pour d'autres partenaires (Meta, Bing, Snapchat, Awin, etc.).

Si votre objectif est d'implémenter Google Tag Gateway, vous êtes au bon endroit : Commanders Gateway suit exactement les mêmes principes de configuration que Google Tag Gateway, mais les étend à tous les principaux partenaires publicitaires et d'analytics.

---

Pourquoi utiliser Commanders Gateway ?

1. Avantages d'utiliser une gateway

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

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

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

• Ceci garantit un suivi plus précis, en 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 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 proxy toutes les bibliothèques des vendors.

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

• Avec ce même chemin simple, vous pouvez aussi activer d'autres fonctions d'hébergement et de suivi First-party telles que : hébergement de vos containers de tag management, tracking d'événements server-side, ou statistiques anonymes de CMP. Une seule configuration alimente l'ensemble de votre système d'hébergement et de suivi First-party.

• Une configuration centralisée simplifie le déploiement et la maintenance tout en restant à l'épreuve du futur 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 First-party, hébergée sur le domaine de votre site web. Cette infrastructure se situe entre votre site web et les services de vos partenaires (Google, Meta, Bing, Snapchat, Awin, etc.).

Avec Commanders Gateway :

• Les libraries Google (gtag.js / gtm.js) sont chargées directement depuis votre domaine First-party.

• Les autres libraries des 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 transmises aux endpoints respectifs des partenaires.

---

Architecture

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

https://example.com/metrics/

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

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

Exemple :

https://example.com/metrics/js/f4558899203.js

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

Diagramme (conceptuel):

Site web  →  example.com/metrics/ (Google tags)
         →  example.com/metrics/js/f4558899203.js (Meta, Snap, Bing…)
         →  Commanders Gateway  →  Endpoint du vendor

---

Avant de commencer

Ce guide suppose que votre site web 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.) pouvant transférer les 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 web.

Exemple :

/metrics

Attention : cette configuration réachemine tout le trafic correspondant au chemin choisi. Pour éviter d'impacter votre site, choisissez un chemin qui n'est pas déjà utilisé.

---

Étape 2 : Router le trafic

Cloudflare Enterprise

Pour servir votre tag dans Commanders Gateway, vous allez créer une entrée CNAME pour un nouveau sous-domaine, créer une Origin Rule pour transférer les requêtes, et créer une Transform Rule pour inclure l'information 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 configuration automatisée Cloudflare à la place.

Créer une 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.

Sous-domaine CNAME : metrics
Cible : s1234.commander4.com

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 (aussi appelé workspace id)

3. Enregistrez l'enregistrement CNAME.

Créer la 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, par exemple.

3. Route measurement

Faites correspondre les requêtes entrantes en fonction d'une expression de filtre personnalisée :

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. DNS Record → Remplacer par :.

3. metrics.example.com

Enregistrez la Origin Rule.

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

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

3. .

Attendez quelques minutes pour la propagation.

Vous pouvez vérifier en naviguant vers :

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

ok

Cloudflare Free Lorsque vous utilisez Cloudflare Free, la configuration repose sur un simple Worker /metricsqui proxyfie tout le trafic depuis le chemin choisi (par ex.

) vers l'infrastructure Commanders Gateway.

1. Étape 1 : Créer le Worker Dans le Dashboard Cloudflare, allez à Workers & Pages → Workers & Pages Create application.

2. Worker

Copiez/collez le code suivant :
const prefix = "/metrics"; // Chemin exemple, remplacez par le chemin que vous avez choisi à l'étape précédente

const sid = "12345"; // Exemple d'ID de workspace (aka site ID), remplacez par votre propre ID
  addEventListener("fetch", event => {
});

event.respondWith(handleRequest(event.request));
  async function handleRequest(request) {
  const url = new URL(request.url);
    if (url.pathname.startsWith(prefix)) {
    // Construire l'URL cible (elle remplace ${sid} par l'ID de votre workspace/site ci‑dessus)

    const targetUrl = `https://s${sid}.commander4.com${url.pathname}${url.search}`;
    // Cloner les en-têtes de la requête
    const newHeaders = new Headers(request.headers);

    newHeaders.set("X-Forwarded-Host", url.host);
    const country = request.cf?.country || "";
    const region = request.cf?.region || "";
    if (country) newHeaders.set("X-Forwarded-Country", country);
    if (region) newHeaders.set("X-Forwarded-Region", region);
      if (country && region) {
    }

    newHeaders.set("X-Forwarded-CountryRegion", `${country}-${region}`);
    // Supprimer l'en-tête Host pour éviter les conflits

    newHeaders.delete("host");
    // Proxyfier la requête vers l'infra Commanders Gateway
      const proxyRequest = new Request(targetUrl, {
      method: request.method,
      headers: newHeaders,
      body: request.body,
    });
    redirect: "follow"
  }
  return fetch(proxyRequest);
}

return new Response("Not Found", { status: 404 }); // Retourne 404 si le chemin de la requête ne correspond pas au préfixeCe Worker proxyfie les requêtes tout en ajoutant des en-têtes supplémentaires (, X-Forwarded-Host, X-Forwarded-Country).

X-Forwarded-Region

1. Étape 2 : Lier le Worker au chemin

2. Dans Cloudflare, ouvrez les paramètres de votre domaine. Naviguez vers.

3. Workers Routes

   • Ajoutez une nouvelle route avec :: Pattern d'URL

   • Create applicationwww.example.com/metrics*

: sélectionnez le Worker créé à l'étape 1. /metrics Une fois enregistré, toutes les requêtes vers

seront proxyfiées vers Commanders Gateway.

Akamai Commanders Gateway avec Akamai est enbeta

. Si vous avez une question ou un problème avec votre configuration, contactez le support

1. Créer la règle de redirection Créez une nouvelle version de votre configuration de delivery dans.

2. Property Manager Sous la section Property Configuration Settings

   • ajoutez une nouvelle Rule : Saisissez un nom de règle, par exemple

3. Nommez-la : Ajoutez un nouveau:

   • Match Type de match :

   • Path Condition :

   • est l'un de Valeur :

4. Nommez-la : /metrics/*:

   • Comportement Sélectionnez Standard Property Behavior et choisissez Origin Server

   • comme comportement. Définissez Origin Server Hostname → Réécrire en :

   • comme comportement. sur Origin Server Hostname Forward Host Header.

5. Origin Hostname

   • Enregistrez la nouvelle règle et déployez vos modifications. ⚠️ Testez la règle de redirection dans votre environnement de staging

   • avant de la déployer en production. Assurez-vous qu'aucune autre règle ne modifie/supprime les en-têtes de réponse sortants (par ex.,Content-Type

---

) car cela pourrait casser les scripts.

1. Inclure l'information de géolocalisation Naviguez vers la section Property Variables

et ajoutez les variables suivantes :	Nom de la variable
Paramètres de sécurité	USER_REGION
Hidden	USER_REGION

1. USER_COUNTRY Choisissez votre Redirect rule

2. (créée ci‑dessus) sous Property Configuration Settings. Ajoutez deux nouveaux Set Variable

comportements (un par variable) :	Variable	Create Value From	Get Data From	Edgescape Field
Opération	PMUSER_USER_REGION	Extract	Edgescape Data	Region Code
None	PMUSER_USER_REGION	Extract	PMUSER_USER_COUNTRY	Region Code

1. (créée ci‑dessus) sous Property Configuration Settings. Country Code Modify Outgoing Request Header

comportements :	Action	Sélectionner le nom de l'en-tête	Nom d'en-tête personnalisé
Valeur de l'en-tête	Ajouter	X-Forwarded-Country	Autre...
Valeur de l'en-tête	Ajouter	X-Forwarded-Host	{{user.PMUSER_USER_REGION}}

1. Origin Hostname

2. {{user.PMUSER_USER_COUNTRY}}

   • Vérifiez la configuration : Vous pouvez vérifier en naviguant vers : Naviguez vers : Cela devrait renvoyer.

   • → devrait afficher Tester les en-têtes de géolocalisation : https://example.com/metrics/?validate_geo=healthy Cela devrait renvoyer.

→ devrait également afficher

Fastly

---

Bientôt

Étape 3 : Mettez à jour les scripts dans votre système de tag management ou sur votre site web Remplacez les URLs des scripts des vendors par les nouveaux.

chemins First-party

Exemples :

Google
<!-- Au lieu de -->

<script async src="https://www.googletagmanager.com/gtag/js?id=G-12345"></script>
<!-- Utilisez -->

<script async src="/metrics/"></script>

Google
Meta (Facebook Pixel)

<script src="https://connect.facebook.net/en_US/fbevents.js"></script>
<!-- Utilisez (chemin obfusqué fourni dans l'interface Commanders Act) -->

<script src="/metrics/js/f4558899203.js"></script>

Snapchat

<script src="/metrics/js/a82b99df732.js"></script>

Bing (UET)

<script src="/metrics/js/c77ac91be11.js"></script> Commanders Act First-Party Hosting.

---

Chaque nom de fichier obfusqué est généré automatiquement et disponible dans la

• Étape 4 : Vérifier la configuration

  • Vous pouvez vérifier en naviguant vers : Pour le chemin global, vérifiez l'endpoint de santé : Cela devrait renvoyer

• → devrait renvoyer

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

  • Les scripts Google sont chargés depuis Les autres scripts vendor sont chargés depuis

  • /metrics/js/{obfuscated}.js domaine First-party.

• Des requêtes sont effectuées vers votre

---

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

• BénéficesDurabilité

• : Le tracking continue de fonctionner même avec l'ITP de Safari et les restrictions sur les cookies third-party.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/metrics: Un seul chemin (

• ) gère tous les vendors.À l'épreuve du futur