Proxy Flowsery Analytics avec Express.js
Faites transiter Flowsery Analytics via votre serveur Express.js afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.
1. Installer les dépendances
npm install express-http-proxy2. Mettre en place le proxy
Ajoutez la configuration proxy suivante à votre application Express.js :
const express = require('express');
const proxy = require('express-http-proxy');
const app = express();
app.set('trust proxy', true);
// Proxy the tracking script
app.use(
'/js/main.js',
proxy('analytics.flowsery.com', {
https: true,
proxyReqPathResolver: function (req) {
return '/js/main.js';
},
})
);
// Proxy the event collection endpoint + forward real visitor IP
app.use(
'/api/track',
proxy('analytics.flowsery.com', {
https: true,
proxyReqPathResolver: function (req) {
return '/analytics/events';
},
proxyReqOptDecorator: function (proxyReqOpts, srcReq) {
// Determine the real visitor IP. Use whichever header your edge provides.
const clientIp =
srcReq.headers['cf-connecting-ip'] || srcReq.headers['x-real-ip'] || srcReq.headers['x-forwarded-for']?.split(',')[0]?.trim() || srcReq.ip;
// CRITICAL: Flowsery reads `x-flowsery-real-ip` as the authoritative
// visitor IP. Without it, every visitor resolves to your server's
// region because the proxy hop rewrites `cf-connecting-ip`.
if (clientIp) {
proxyReqOpts.headers['x-flowsery-real-ip'] = clientIp;
}
return proxyReqOpts;
},
})
);
// Your other routes...
app.listen(3000);Remarque : si votre application utilise déjà /api/track, ajoutez data-api à la balise script Flowsery Analytics pour rediriger les événements ailleurs. Par exemple, data-api="/flowsery-events" envoie les données vers /flowsery-events.
Important : si tous les visiteurs apparaissent au même endroit dans votre tableau de bord, vérifiez que x-flowsery-real-ip est bien défini sur la vraie IP du visiteur (et non celle du serveur proxy) lors du transfert des requêtes vers le endpoint /events de Flowsery Analytics.
3. Modifier la balise script
Remplacez le snippet Flowsery Analytics par la version proxifiée :
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Déployer
Après le déploiement de votre serveur, la configuration proxy s'active automatiquement.
Vérifier que cela fonctionne
Pour valider le bon fonctionnement du proxy :
- Ouvrez votre site web
- Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
- Vérifiez que les requêtes analytics sont servies depuis votre domaine plutôt que depuis analytics.flowsery.com
Dépannage
Tous les visiteurs apparaissent au même endroit
Lorsque tous les visiteurs affichent une seule localisation géographique, comme la région de votre serveur, le proxy ne transmet pas correctement les vraies IP des visiteurs.
Résolution :
- Assurez-vous que votre proxy définit
x-flowsery-real-ipsur la vraie IP du visiteur (et non l'IP du serveur) lors du transfert des requêtes vers le endpoint/eventsde Flowsery Analytics. - Si Express est derrière un autre proxy (Nginx, Cloudflare, etc.),
srcReq.ipsera l'IP de ce proxy amont, pas celle du visiteur. Lisez directementcf-connecting-ipoux-real-ip, comme montré à l'étape 2.