Google Tag Manager : router Zenovay via un proxy first-party

Si vous voulez garder le tracking sur votre propre domaine et réduire les pertes dues aux bloqueurs de pub, le moyen avec Zenovay est un proxy first-party — un sous-domaine sur votre propre domaine qui transmet les requêtes de tracking à Zenovay, de sorte que le navigateur parle uniquement à votre domaine.

Il y a deux choses différentes que les gens veulent dire par "server-side GTM" avec Zenovay. Cet article couvre les deux et est clair sur ce que chacun peut et ne peut pas faire.

Option A — Déployer via le modèle Zenovay GTM

C'est la solution sans code. Le tag charge z.js directement depuis https://api.zenovay.com. Cela ne routage PAS via un proxy — si contourner les bloqueurs de pub est votre objectif, utilisez plutôt l'Option B.

Étape 1 — Ajouter le modèle Zenovay GTM

1. Dans Google Tag Manager (votre conteneur Web), allez à Modèles → Modèles de tags → Parcourir la galerie.
2. Recherchez Zenovay et ajoutez Zenovay Analytics à votre espace de travail. (S'il n'est pas encore dans la galerie, vous pouvez importer template.tpl depuis le référentiel de modèles Zenovay GTM à la place.)
3. Cliquez sur Ajouter à l'espace de travail.

Étape 2 — Configurer le tag

1. Tags → Nouveau → Zenovay Analytics (sous Personnalisé).
2. Paramètres (le modèle a exactement ces quatre champs):
   • Tracking Code — collez votre code de tracking Zenovay (depuis Paramètres → Général sur le tableau de bord de votre site).
   • Cookieless Mode — optionnel. Voir Mode cookieless ci-dessous.
   • Track Outbound Links — optionnel ; suit automatiquement les clics vers des domaines externes.
   • Debug Mode — optionnel ; journalisation verbale de la console. Désactivez-le avant de publier.
3. Définissez le déclencheur sur Toutes les pages.
4. Enregistrer → Soumettre → Publier.

Étape 3 — Vérifier

1. Ouvrez une vraie visite sur votre site.
2. En mode Aperçu GTM, confirmez que le tag Zenovay Analytics se déclenche sur la page.
3. DevTools → Réseau → filtrez par z.js — vous devriez le voir charger depuis api.zenovay.com.
4. Ouvrez l'onglet Live View dans le tableau de bord de votre site — la visite devrait apparaître en quelques secondes.

Option B — Proxy first-party (contournement des bloqueurs de pub)

Un proxy first-party garde le tracking sur votre propre domaine. Cela ajoute une surcharge opérationnelle — vous exécutez un petit reverse-proxy sur un sous-domaine de votre propre domaine et le maintenez. C'est utile si :

• Vous constatez une perte de données significative due au blocage des publicités et vous voulez une livraison en domaine first-party.
• Votre équipe de sécurité/juridique exige que toutes les requêtes HTTP tierces soient servies depuis votre propre origine.

Si aucun de ces éléments ne s'applique, le tracker client habituel (Option A ou un simple snippet) est plus simple. Le proxy first-party est disponible sur tous les plans.

Comment ça marche

Navigateur  →  https://analytics.example.com  →  https://api.zenovay.com
                (votre proxy first-party)

Le navigateur ne voit que analytics.example.com (votre domaine). Votre proxy récupère z.js depuis Zenovay et transmet les requêtes de tracking à Zenovay.

Étape 1 — Mettre en place un proxy first-party

Créez un sous-domaine sur votre propre domaine (par ex. analytics.example.com) et configurez-le pour reverse-proxy vers https://api.zenovay.com. Les étapes exactes dépendent de votre pile (Cloudflare, nginx, Cloud Run / fonction serverless, etc.) — le guide First-party tracking vous guide à travers les options.

Le proxy doit :

• Servir z.js (transféré depuis https://api.zenovay.com/z.js).
• Transférer les requêtes de tracking à Zenovay, en passant l'IP réelle du visiteur via X-Forwarded-For pour que la détection pays/ville fonctionne toujours du côté de Zenovay.

Étape 2 — Pointer le snippet de tracking vers votre proxy

Installez le tracker manuellement (pas via le modèle GTM), avec src et data-api-url définis sur votre sous-domaine proxy :

<script
  defer
  src="https://analytics.example.com/z.js"
  data-tracking-code="YOUR_TRACKING_CODE"
  data-api-url="https://analytics.example.com"
></script>

Vous pouvez toujours placer ce snippet via GTM si vous voulez — utilisez une balise Custom HTML avec le déclencheur Toutes les pages au lieu du tag modèle Zenovay.

Étape 3 — Vérifier de bout en bout

1. Ouvrez une vraie visite sur votre site.
2. DevTools → Réseau → filtrez par analytics.example.com — vous devriez voir z.js se charger et les requêtes de tracking routées via votre domaine proxy.
3. Ouvrez l'onglet Live View dans le tableau de bord de votre site — la visite devrait apparaître en quelques secondes.

Mode cookieless

Vous pouvez exécuter sans cookie de l'une ou l'autre manière. Dans le modèle GTM, activez Cookieless Mode ; avec un snippet manuel, ajoutez data-cookieless="true". En mode sans cookie, le tracker n'utilise que des ID en mémoire, limités à la fenêtre — aucun cookie n'est écrit, ni sur la page ni via un proxy.

Disponibilité du plan

Le modèle GTM et le proxy first-party fonctionnent sur tous les plans, Free inclus. Les événements suivis comptent pour votre allocations d'événements mensuelle du plan de la même façon, indépendamment de la façon dont le tracker est chargé.

Lectures connexes

• Aperçu du tracking server-side
• First-party vs third-party tracking
• Aperçu de l'API