Cloudflare Zaraz

Déployez Zenovay Analytics via Cloudflare Zaraz sans toucher au code source de votre site. Zaraz déplace les scripts tiers vers l'edge, ce qui rend l'ajout d'analytics quasiment indétectable sur le temps de chargement.

---

Pourquoi Zaraz ?

Zaraz est le produit de gestion de tags de Cloudflare. Contrairement aux gestionnaires de tags côté client classiques, Zaraz :

• S'exécute à l'edge — le script de suivi est injecté par le réseau Cloudflare, pas par un CDN tiers.
• N'a aucun impact bloquant sur le rendu des Core Web Vitals (LCP, INP).
• Respecte le consentement via son Consent Manager intégré (fonctionne avec le mode sans cookies de Zenovay).
• Aucune étape de build — collez un snippet Custom HTML, enregistrez, c'est fini.

Zaraz est inclus dans toutes les offres Cloudflare, y compris l'offre gratuite.

---

Installation via Custom HTML (Recommandé)

Durée : environ 3 minutes

Étape 1 — Ouvrir Zaraz

1. Connectez-vous au tableau de bord Cloudflare
2. Sélectionnez le compte propriétaire de votre zone (Zaraz se configure au niveau du compte, pas par zone)
3. Dans la barre latérale, déroulez Tag Management → cliquez sur Zaraz

Ou ouvrez Zaraz directement — l'espace réservé :account se résout automatiquement vers votre compte Cloudflare actuellement sélectionné.

Étape 2 — Ajouter l'outil Custom HTML

1. Cliquez sur Add new tool
2. Dans le catalogue, descendez jusqu'à Custom Code et sélectionnez Custom HTML
3. Donnez un nom à l'outil : Zenovay Analytics

Étape 3 — Coller le snippet de suivi

Dans le champ HTML, collez :

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://api.zenovay.com/z.js">
</script>

Étape 4 — Configurer le déclencheur

Réglez le Firing Trigger sur Pageview.

• Firing Trigger : Pageview (obligatoire)
• Blocking Triggers : laisser vide
• Match : Toutes les pages (aucun filtre)

Étape 5 — Enregistrer et publier

1. Cliquez sur Save
2. Zaraz publie immédiatement — aucune étape de déploiement séparée

Ouvrez votre site dans un nouvel onglet. En moins d'une minute, votre premier visiteur devrait apparaître dans le tableau de bord Zenovay.

---

Mode sans cookies

Le mode sans cookies de Zenovay fonctionne aussi avec Zaraz. Remplacez le snippet de l'étape 3 par :

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  data-cookieless="true"
  src="https://api.zenovay.com/z.js">
</script>

Avec data-cookieless="true", Zenovay n'écrit ni cookie ni localStorage. Cela s'accorde naturellement avec l'exécution edge de Zaraz : le navigateur du visiteur ne reçoit jamais de cookie de suivi, ce qui satisfait par défaut ePrivacy / TDDDG / FMG art. 45c.

---

Événements personnalisés

Zaraz peut appeler window.zenovay() directement depuis n'importe quelle Action Zaraz. Pour envoyer un événement personnalisé :

1. Dans Zaraz, ouvrez Custom HTML → ajoutez un second outil (ou modifiez l'outil existant)
2. Utilisez ce modèle de snippet :

<script>
  if (window.zenovay) {
    window.zenovay('track', 'signup', { plan: 'pro' });
  }
</script>

3. Définissez le déclencheur sur votre événement Zaraz personnalisé (par exemple un Click trigger sur le bouton d'inscription)

Pour tous les helpers d'événements disponibles, consultez Custom Events.

---

Mode consentement (RGPD / ePrivacy)

Si vous utilisez le Consent Manager intégré à Zaraz :

1. Ouvrez l'outil Zenovay → onglet Consent
2. Définissez Consent Purpose sur Analytics (ou la catégorie validée par vos visiteurs)
3. Enregistrez

Si vos visiteurs refusent le consentement analytics, Zaraz ne déclenche pas l'outil Zenovay. Pour fonctionner sans bandeau de consentement, activez le mode sans cookies ci-dessus — Zenovay opère alors de manière conforme sous ePrivacy art. 5(3) sans consentement.

---

Proxy first-party (contournement des bloqueurs de publicité)

Si vous avez configuré un proxy first-party sur votre propre sous-domaine (par ex. analytics.votredomaine.com), changez le src du snippet Zaraz pour votre URL de proxy :

<script
  defer
  data-id="YOUR_TRACKING_CODE"
  src="https://analytics.votredomaine.com/z.js">
</script>

Comme Zaraz s'exécute déjà à l'edge pour votre zone, l'associer à un proxy first-party offre une résistance maximale aux bloqueurs de publicité.

---

Support SPA (React, Next.js, Vue, Angular)

Le script de suivi Zenovay détecte automatiquement les changements de route dans les applications single-page. Aucun déclencheur Zaraz supplémentaire n'est nécessaire — le déclencheur Pageview par défaut suffit.

---

Vérifier l'installation

Après publication dans Zaraz, le moyen le plus simple de vérifier est :

1. Ouvrez votre site dans une fenêtre Incognito / Privée
2. Ouvrez les Outils de développement → onglet Network
3. Filtrez par zenovay
4. Rechargez la page

Vous devriez voir une requête vers https://api.zenovay.com/z.js (le bundle du tracker) et au moins une requête vers /api/track/... (l'événement Pageview). Les deux devraient retourner HTTP 200.

Dans le tableau de bord Zenovay, la carte Setup → Installation de votre domaine passe à « Verified » dans les 30 secondes qui suivent le premier événement.

---

Dépannage

---

Impact sur les performances

Comme Zaraz injecte le script à l'edge Cloudflare — avant que le HTML soit envoyé au navigateur du visiteur — le tracker est considéré comme faisant partie de l'origine de votre site. Aucune résolution DNS tierce, aucun handshake TLS supplémentaire, aucune requête externe bloquante.

Sur un site typique, passer d'un tracker Zenovay injecté dans le <head> à un tracker injecté via Zaraz retire une résolution DNS (~20-60 ms) et un handshake TLS (~80-200 ms) du chemin critique.

---

Ressources liées

• Référence du script de suivi
• Custom Events
• Conformité vie privée
• Tracking first-party
• Google Tag Manager — voie de gestion de tags alternative
• Documentation Cloudflare Zaraz (externe)

---

Besoin d'aide ? Contactez [email protected] ou visitez notre Centre d'aide.