Proxy Flowsery Analytics avec Astro
Faites transiter Flowsery Analytics via votre application Astro avec du middleware afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.
1. Créer le middleware
Créez un fichier middleware dans src/middleware.js (ou src/middleware.ts pour les projets TypeScript) :
// src/middleware.js
export async function onRequest(context, next) {
const { request } = context;
const url = new URL(request.url);
// Proxy the Flowsery Analytics tracking script
if (url.pathname === '/js/main.js') {
const response = await fetch('https://cdn.flowsery.com/main.js');
const script = await response.text();
return new Response(script, {
headers: {
'Content-Type': 'application/javascript',
'Cache-Control': 'public, max-age=31536000',
},
});
}
// Proxy the event collection endpoint
if (url.pathname === '/api/track' && request.method === 'POST') {
const body = await request.text();
// Resolve the real visitor IP for accurate geolocation
const clientIp =
request.headers.get('cf-connecting-ip') || request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || '';
const response = await fetch('https://analytics.flowsery.com/analytics/events', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'User-Agent': request.headers.get('User-Agent') || '',
Origin: request.headers.get('Origin') || url.origin,
// Flowsery reads `x-flowsery-real-ip` as the authoritative visitor IP.
// Without it, every visitor resolves to your server's region because
// Cloudflare rewrites `cf-connecting-ip` on the proxy hop.
...(clientIp && { 'x-flowsery-real-ip': clientIp }),
},
body: body,
});
const responseText = await response.text();
return new Response(responseText, {
status: response.status,
headers: {
'Content-Type': 'application/json',
},
});
}
return next();
}2. Activer le rendu côté serveur dans Astro
Mettez à jour astro.config.mjs pour activer le SSR (nécessaire pour le middleware) :
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
export default defineConfig({
output: 'server', // or 'hybrid'
adapter: node({
mode: 'standalone',
}),
});Vous aurez aussi besoin de l'adapter Node.js : npm install @astrojs/node
3. Alternative : site statique avec routes API
Si vous préférez garder votre site entièrement statique, créez des routes API plutôt qu'un middleware :
Route proxy pour le script
Créez src/pages/js/main.js.js :
// src/pages/js/main.js.js
export async function GET() {
const response = await fetch('https://cdn.flowsery.com/main.js');
const script = await response.text();
return new Response(script, {
headers: {
'Content-Type': 'application/javascript',
'Cache-Control': 'public, max-age=31536000',
},
});
}Route proxy pour les événements
Créez src/pages/api/track.js :
// src/pages/api/track.js
export async function POST({ request }) {
const body = await request.text();
const url = new URL(request.url);
// Resolve the real visitor IP for accurate geolocation
const clientIp =
request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || request.headers.get('cf-connecting-ip') || '';
const response = await fetch('https://analytics.flowsery.com/analytics/events', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'User-Agent': request.headers.get('User-Agent') || '',
Origin: request.headers.get('Origin') || url.origin,
'x-forwarded-for': clientIp,
},
body: body,
});
const responseText = await response.text();
return new Response(responseText, {
status: response.status,
headers: {
'Content-Type': 'application/json',
},
});
}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 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. Modifier la balise script
Remplacez le snippet Flowsery Analytics dans votre layout par la version proxifiée :
---
// src/layouts/Layout.astro
const { title } = Astro.props;
---
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width" />
<title>{title}</title>
<script
defer
data-fl-website-id="flid_******"
src="/js/main.js"
></script>
</head>
<body>
<slot />
</body>
</html>5. Déployer
Après le déploiement, la configuration proxy prend effet automatiquement. Vérifiez simplement que votre hébergeur prend en charge :
- le rendu côté serveur (pour l'approche middleware)
- les routes API (pour l'approche site statique)
Parmi les hébergeurs compatibles Astro, on trouve notamment Vercel, Netlify et Cloudflare Pages.
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
Remarque : l'approche middleware nécessite le rendu côté serveur, alors que les routes API fonctionnent aussi bien avec des sites statiques qu'avec des sites rendus côté serveur.
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 votre déploiement Astro est derrière un autre proxy (Vercel, Cloudflare, Netlify), l'IP utile se trouve en général dans
cf-connecting-ip,x-vercel-forwarded-foroux-real-ip: lisez d'abord celui que votre edge fournit.