Proxy Flowsery Analytics avec Firebase Hosting
Faites transiter Flowsery Analytics via Firebase Hosting à l'aide de Cloud Functions afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.
Remarque : Firebase Hosting ne prend pas en charge nativement les rewrites de reverse proxy vers des destinations externes. Ce guide utilise donc Firebase Cloud Functions comme alternative.
1. Initialiser Firebase Functions (si ce n'est pas déjà fait)
Si votre projet n'inclut pas encore Firebase Functions, lancez :
firebase init functionsSuivez les invites de configuration adaptées à votre environnement. À la fin, un dossier /functions sera présent dans votre projet.
2. Installer les dépendances
Placez-vous dans le dossier functions/ puis installez les paquets nécessaires :
cd functions/
npm i -s express express-http-proxy3. Construire la fonction de reverse proxy
Créez ou mettez à jour functions/index.js avec le contenu suivant :
const { onRequest } = require('firebase-functions/v2/https');
const express = require('express');
const proxy = require('express-http-proxy');
const app = express();
app.set('trust proxy', true);
// Proxy the Flowsery Analytics tracking script
app.use(
'/js/main.js',
proxy('https://analytics.flowsery.com', {
proxyReqPathResolver: () => '/js/main.js',
})
);
// Proxy the event collection endpoint
app.use(
'/api/track',
proxy('https://analytics.flowsery.com', {
proxyReqPathResolver: () => '/analytics/events',
proxyReqOptDecorator: (proxyReqOpts, srcReq) => {
// Forward the real visitor IP for accurate geolocation
const clientIp =
srcReq.headers['cf-connecting-ip'] || srcReq.headers['x-real-ip'] || srcReq.headers['x-forwarded-for']?.split(',')[0]?.trim() || srcReq.ip;
proxyReqOpts.headers['x-forwarded-for'] = clientIp;
if (clientIp) {
// CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
proxyReqOpts.headers['x-flowsery-real-ip'] = clientIp;
}
return proxyReqOpts;
},
})
);
exports.reverseProxy = onRequest(app);Remarque : si votre projet utilise déjà une route /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 l'en-tête 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.
4. Configurer les rewrites Firebase Hosting
Mettez à jour firebase.json pour router les chemins correspondants vers la fonction reverseProxy :
{
"hosting": {
"public": "public",
"ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
"rewrites": [
{
"source": "/js/main.js",
"function": "reverseProxy"
},
{
"source": "/api/track",
"function": "reverseProxy"
}
]
},
"functions": [
{
"source": "functions",
"codebase": "default",
"ignore": ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log", "*.local"]
}
]
}5. 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>6. Déployer l'hosting et les functions
Déployez l'hosting et les functions en une seule commande :
firebase deploy --only hosting,functionsVé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 inclut l'en-tête
x-flowsery-real-ipcontenant la vraie adresse IP du visiteur (et non celle du serveur) lors du transfert des requêtes vers le endpoint/eventsde Flowsery Analytics - Si la Cloud Function est derrière un autre proxy (Cloudflare, Vercel, etc.),
srcReq.ipsera l'IP du proxy amont : utilisez plutôtcf-connecting-ipoux-real-ip