Configuration du proxy de première partie
Servez le suivi Zenovay via votre propre domaine pour contourner la protection du suivi du navigateur et les bloqueurs de publicités.
Un proxy de première partie route le suivi via VOTRE domaine, afin que les navigateurs le voient comme première partie et l'autorisent. Cela peut récupérer 15-30% de visiteurs supplémentaires.
Pourquoi utiliser un proxy de première partie ?
Les navigateurs modernes bloquent les scripts de suivi tiers. Voici ce que chaque navigateur bloque :
| Navigateur | Protection | Bloque api.zenovay.com ? |
|---|---|---|
| Firefox | Enhanced Tracking Protection (ETP) | Oui |
| Brave | Shields | Oui |
| Edge | Tracking Prevention | Oui |
| Opera | Built-in Blocker | Oui |
| Safari | Intelligent Tracking Prevention (ITP) | Partiellement |
| Chrome | Limité (pour le moment) | Certaines extensions |
Comment cela fonctionne-t-il ?
Sans proxy (bloqué) :
Navigateur → api.zenovay.com ❌ (Tierce partie = bloquée par les navigateurs)
Avec proxy (fonctionne) :
Navigateur → votredomaine.com/api/_z/* ✅ (Première partie = autorisée)
↓
Votre serveur → api.zenovay.com/fp/* (Serveur à serveur = fonctionne toujours)Le navigateur voit uniquement les requêtes vers VOTRE domaine, donc la protection du suivi ne s'applique pas.
Comprendre l'origine du même domaine (Critique !)
C'est le concept le plus important à comprendre.
Toutes les approches « première partie » ne sont pas égales. Il existe une différence critique entre proxy du même domaine et sous-domaine personnalisé.
Les deux approches
| Approche | Exemple | Firefox ETP | Pourquoi |
|---|---|---|---|
| Proxy du même domaine | /api/_z/script.js | ✅ FONCTIONNE | Même origine |
| Sous-domaine personnalisé | z.votredomaine.com | ❌ BLOQUÉ | Origine différente |
Qu'est-ce que « Même origine » ?
Les navigateurs définissent « même origine » comme : même protocole + même domaine + même port
https://votredomaine.com (votre site)
❌ https://z.votredomaine.com → Origine différente (sous-domaine différent)
❌ https://api.votredomaine.com → Origine différente (sous-domaine différent)
✅ https://votredomaine.com/api/ → MÊME origine (juste un chemin)Pourquoi les sous-domaines ne fonctionnent pas pour Firefox
Même si z.votredomaine.com semble « première partie », Firefox ETP le traite comme tierce partie car :
- Vérification de l'origine :
z.votredomaine.com≠votredomaine.com - Requête interdomaines : Le navigateur effectue une requête vers une origine différente
- Blocage ETP : Firefox bloque les requêtes de suivi interdomaines
Pourquoi le proxy du même domaine fonctionne
Avec /api/_z/script.js :
- Vérification de l'origine :
votredomaine.com/api/_z/=votredomaine.com✅ - Requête de même origine : Le navigateur effectue une requête première partie
- ETP autorise : Firefox autorise les requêtes de même origine
- Serveur proxifie : Votre serveur transfère vers Zenovay (le navigateur ne voit jamais cela)
Résumé : Si vous avez besoin de compatibilité Firefox, utilisez l'approche proxy du même domaine (Vercel, Netlify, Next.js, Cloudflare Pages, nginx, Apache, Astro).
L'approche du sous-domaine personnalisé de Cloudflare Workers (z.votredomaine.com) ne contourne PAS Firefox ETP - elle contourne seulement certains bloqueurs de publicités.
Choisissez votre plateforme
Sélectionnez votre plateforme d'hébergement pour commencer avec un guide étape par étape détaillé :
Next.js
Utilisez les rewrites next.config.js. L'option la plus simple pour les projets Next.js.
Cloudflare Workers
Parfait pour les utilisateurs d'hébergement partagé. Créez un Worker gratuit en 5 minutes.
Cloudflare Pages
Utilisez Pages Functions si vous êtes déjà hébergé sur Cloudflare Pages.
Vercel
Utilisez les rewrites vercel.json ou Edge Middleware. Fonctionne avec n'importe quel cadre.
Netlify
Fichier _redirects simple ou configuration netlify.toml.
nginx / Apache
Serveurs auto-hébergés utilisant la configuration du proxy inverse.
Astro
Routes API pour les projets Astro avec SSR activé.
Référence rapide
| Votre configuration | Meilleure option | Guide |
|---|---|---|
| Projet Next.js | Rewrites next.config.js | Guide Next.js |
| Vercel (n'importe quel cadre) | Rewrites vercel.json | Guide Vercel |
| Netlify | Fichier _redirects | Guide Netlify |
| Cloudflare Pages | Pages Functions | Guide CF Pages |
| Cloudflare (général) | Cloudflare Workers | Guide CF Workers |
| Serveur auto-hébergé | Proxy nginx/Apache | Guide nginx/Apache |
| Astro | Routes API | Guide Astro |
| Hébergement partagé (Hostinger, GoDaddy, etc.) | Cloudflare Workers (gratuit) | Guide CF Workers |
Utilisez-vous un hébergement partagé (Hostinger, GoDaddy, Bluehost) ?
Ces plateformes ne supportent pas le proxying côté serveur. Créez un compte Cloudflare GRATUIT et utilisez Cloudflare Workers à la place. Cela prend 5 minutes et fonctionne parfaitement.
Après la configuration : Mettez à jour votre script
Une fois que vous avez configuré le proxy, mettez à jour votre script de suivi. Vous pouvez trouver l'extrait de première partie dans les paramètres de votre domaine : ouvrez Domaines, cliquez sur votre site, puis accédez à la page Général et sélectionnez l'onglet Première partie dans la carte du script de suivi.
<script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="https://api.zenovay.com/z.js">
</script><script defer
data-tracking-code="YOUR_TRACKING_CODE"
src="/api/_z/script.js">
</script>IMPORTANT : Limitation de Cloudflare Workers
L'approche de Cloudflare Workers (z.votredomaine.com) ne contourne PAS Firefox ETP car les sous-domaines sont toujours des origines différentes.
Pour la compatibilité Firefox, utilisez plutôt l'une des options de proxy du même domaine :
Vérifiez que cela fonctionne
Après la configuration, vérifiez que le proxy fonctionne :
1. Vérifiez l'onglet Réseau
- Ouvrez DevTools (F12 ou Cmd+Option+I)
- Allez à l'onglet Réseau
- Rechargez votre page
- Recherchez
/api/_z/script.js(ou votre chemin de domaine personnalisé) - Devrait afficher le statut 200 de VOTRE domaine
2. Testez dans Firefox (Le plus strict)
Firefox dispose de la protection du suivi la plus stricte :
- Ouvrez Firefox
- Paramètres → Confidentialité et sécurité → Enhanced Tracking Protection : Strict
- Visitez votre site web
- Vérifiez que le script se charge avec succès
S'il fonctionne en mode strict Firefox, il fonctionne partout.
Référence des points de terminaison API
Votre proxy doit transférer ces chemins :
| Votre chemin | API Zenovay | Objectif |
|---|---|---|
/api/_z/script.js | /fp/script.js | Script de suivi |
/api/_z/e/:code | /fp/e/:code | Événements de vue de page |
/api/_z/settings/:code | /fp/settings/:code | Paramètres du site web |
/api/_z/load | /fp/load | Chargeur dynamique |
Dépannage
Vous avez des problèmes ? Vérifiez ces problèmes courants :
- Le script retourne 404 - Vérifiez votre configuration de chemin proxy
- Erreurs CORS - Assurez-vous que votre proxy ajoute les en-têtes CORS
- Géolocalisation incorrecte - Transférez l'IP du client avec l'en-tête
X-Zenovay-Real-IP - Toujours bloqué - Assurez-vous que vous utilisez le chemin proxifié, pas l'URL directe
Pour un dépannage détaillé, consultez le guide spécifique de chaque plateforme ou la page de dépannage générale.
Prochaines étapes
- Événements personnalisés - Suivez les clics de boutons et les soumissions de formulaires
- Identification des visiteurs - Connectez l'analyse à vos comptes utilisateur
- Dépannage - Problèmes courants et solutions