Proxy Flowsery Analytics avec Next.js
Faites transiter Flowsery Analytics via votre propre domaine dans une application Next.js afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs précises.
Un proxy complet comporte deux étapes : un rewrite (qui rend le tracker first-party pour survivre aux bloqueurs) et un middleware (qui transfère la vraie IP du visiteur au backend de Flowsery). Les rewrites seuls enverront bien les événements, mais tous les visiteurs sembleront venir de la région de votre serveur : il faut les deux.
1. Configurer les rewrites
Ajoutez ou mettez à jour votre next.config.js à la racine du projet :
module.exports = {
async rewrites() {
return [
{
source: '/js/main.js',
destination: 'https://cdn.flowsery.com/main.js',
},
{
source: '/api/track',
destination: 'https://analytics.flowsery.com/analytics/events',
},
{
source: '/:locale/api/track',
destination: 'https://analytics.flowsery.com/analytics/events',
},
];
},
};Si votre projet utilise déjà /api/track, choisissez un autre chemin et passez-le via data-api sur le script tracker (par exemple data-api="/flowsery-events").
2. Injecter la vraie IP du visiteur (middleware)
Les rewrites Next.js effectuent une requête de serveur à serveur, donc le edge Cloudflare en aval remplace cf-connecting-ip par l'IP de votre serveur Next.js. Flowsery voit alors chaque visiteur comme "votre serveur" et résout la géolocalisation vers votre région d'hébergement.
Pour corriger cela, ajoutez un middleware qui lit la vraie IP du visiteur à l'arrivée et la fige dans un en-tête personnalisé x-flowsery-real-ip. Cet en-tête personnalisé traverse le saut proxy sans être modifié, et le backend de Flowsery le privilégie par rapport à cf-connecting-ip lorsqu'il est présent.
Créez ou mettez à jour middleware.ts à la racine du projet :
import { NextRequest, NextResponse } from 'next/server';
const TRACKING_PROXY_PATHS = /\/api\/track$/;
export default function middleware(request: NextRequest) {
if (!TRACKING_PROXY_PATHS.test(request.nextUrl.pathname)) {
return NextResponse.next();
}
const realIp = request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for')?.split(',')[0]?.trim();
if (!realIp) return NextResponse.next();
const forwardedHeaders = new Headers(request.headers);
forwardedHeaders.set('x-flowsery-real-ip', realIp);
return NextResponse.next({
request: { headers: forwardedHeaders },
});
}
export const config = {
matcher: ['/api/track', '/:locale/api/track'],
};Si vous avez déjà un middleware
Deux points à fusionner avec soin :
1. Le handler. Appelez d'abord la logique du proxy de tracking pour les chemins /api/track, puis laissez la main à votre logique existante :
export default function middleware(request: NextRequest) {
// Runs for /api/track + /:locale/api/track. Returns a response only when
// the path matches, otherwise returns NextResponse.next() so your existing
// logic runs below.
if (/\/api\/track$/.test(request.nextUrl.pathname)) {
const realIp = request.headers.get('cf-connecting-ip') || request.headers.get('x-forwarded-for')?.split(',')[0]?.trim();
if (realIp) {
const headers = new Headers(request.headers);
headers.set('x-flowsery-real-ip', realIp);
return NextResponse.next({ request: { headers } });
}
return NextResponse.next();
}
// ...your existing middleware logic here (locale detection, auth, etc.)
}2. Le matcher. La plupart des middlewares de pages utilisent un negative lookahead du type /((?!api/|_next/...).*) pour exclure les routes API. Ce motif exclura aussi /api/track, donc le middleware ne s'exécutera jamais sur le chemin de tracking. Étendez le tableau matcher pour le réinclure :
export const config = {
matcher: [
// Your existing page-level pattern, leave it alone.
'/((?!api/|js/|_next/static|_next/image|favicon.ico|locales|ingest).*)',
// Added so middleware also runs for the tracking proxy paths.
'/api/track',
'/:locale/api/track',
],
};L'ordre n'a pas d'importance. Les entrées du matcher sont reliées par un OR : un chemin déclenche le middleware si n'importe quelle entrée correspond. Les routes de pages continuent d'utiliser votre motif existant ; /api/track utilise la nouvelle entrée explicite et atteint le handler de proxy ci-dessus.
3. Modifier la balise script
Pointez le script vers le chemin local proxifié :
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Déployer
Le rewrite et le middleware prennent effet au déploiement.
Vérifier que cela fonctionne
- Ouvrez votre site dans un onglet de navigateur classique.
- Ouvrez DevTools → Réseau. Filtrez sur
/api/track. - Vérifiez que chaque requête part vers votre propre domaine (et non
analytics.flowsery.com). - Dans votre tableau de bord Flowsery, vérifiez que les pays et villes des visiteurs correspondent à votre audience (et non à votre région d'hébergement).
Dépannage
Tous les visiteurs apparaissent au même endroit
Si tous les visiteurs affichent une seule localisation géographique, comme la région de votre serveur, l'étape middleware n'applique pas l'en-tête x-flowsery-real-ip.
Causes fréquentes :
- Le matcher du middleware n'inclut pas le chemin de tracking. La plupart des matchers existants utilisent un negative lookahead comme
/((?!api/|...).*), qui exclut/api/*. Ajoutez/api/track(et/:locale/api/tracksi vous utilisez des URL préfixées par locale) comme entrées explicites dans le tableaumatcher. - Vous avez ajouté l'en-tête à la réponse au lieu de la requête. Le backend lit les en-têtes de requête ; utilisez
NextResponse.next({ request: { headers } }), pasresponse.headers.set(...). - Votre fournisseur edge n'est pas Cloudflare. Si vous êtes derrière Vercel, Fly.io ou un autre edge, lisez l'IP visiteur dans l'en-tête fourni par ce edge (
x-real-ip,x-vercel-forwarded-for,fly-client-ip, etc.).