Flowsery Analytics proxyen met Next.js
Stuur Flowsery Analytics via je eigen domein in een Next.js-app, zodat adblockers er niet tussen komen en je nauwkeurige bezoekersdata verzamelt.
Een volledige proxy bestaat uit twee stappen: een rewrite (maakt de tracker first-party, zodat hij adblockers overleeft) en middleware (stuurt het echte IP-adres van de bezoeker door naar de backend van Flowsery). Met alleen rewrites komen events wel aan, maar lijkt elke bezoeker uit de regio van je server te komen. Je hebt dus allebei nodig.
1. Rewrites instellen
Voeg next.config.js toe in de hoofdmap van je project, of werk het bestaande bestand bij:
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',
},
];
},
};Gebruikt je project /api/track al, kies dan een ander pad en geef dat door via data-api op het trackerscript (bijvoorbeeld data-api="/flowsery-events").
2. Het echte IP-adres van de bezoeker doorgeven (middleware)
Next.js-rewrites doen een fetch van server naar server, dus de Cloudflare-edge verderop vervangt cf-connecting-ip door het IP-adres van je Next.js-server. Flowsery ziet dan elke bezoeker als "jouw server" en bepaalt de locatie op basis van je hostingregio.
Los dit op met middleware die bij binnenkomst het echte IP-adres van de bezoeker uitleest en vastlegt in de eigen header x-flowsery-real-ip. Die header komt ongewijzigd door de proxystap heen, en de backend van Flowsery geeft er voorrang aan boven cf-connecting-ip als hij aanwezig is.
Maak middleware.ts aan in de hoofdmap van je project, of werk het bestaande bestand bij:
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'],
};Als je al middleware hebt
Twee onderdelen moet je zorgvuldig samenvoegen:
1. De handler. Voer voor /api/track-paden eerst de logica van de trackingproxy uit en ga daarna verder met je bestaande logica:
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. De matcher. De meeste middleware op paginaniveau gebruikt een negatieve lookahead zoals /((?!api/|_next/...).*) om API-routes uit te sluiten. Dat patroon sluit ook /api/track uit, waardoor de middleware nooit draait voor het trackingpad. Breid de matcher-array uit om het pad weer mee te nemen:
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',
],
};De volgorde maakt niet uit. De matcher-items werken als OF: een pad start de middleware zodra een van de items erop past. Paginaroutes blijven op je bestaande patroon uitkomen; /api/track komt uit op het nieuwe, expliciete item en bereikt de handler van je trackingproxy hierboven.
3. De scripttag aanpassen
Laat het script naar het lokale proxypad wijzen:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Deployen
De rewrite en de middleware werken zodra je deployt.
Controleren of het werkt
- Open je site in een gewoon browsertabblad.
- Open DevTools → Network. Filter op
/api/track. - Controleer dat elk verzoek naar je eigen domein gaat (niet naar
analytics.flowsery.com). - Controleer in je Flowsery-dashboard dat de landen en steden van bezoekers bij je publiek passen (en niet bij je hostingregio).
Probleemoplossing
Elke bezoeker lijkt van dezelfde locatie te komen
Tonen alle bezoekers één en dezelfde geografische locatie, zoals de regio van je server, dan zet de middleware de header x-flowsery-real-ip niet.
Veelvoorkomende oorzaken:
- De matcher van de middleware bevat het trackingpad niet. De meeste bestaande matchers gebruiken een negatieve lookahead zoals
/((?!api/|...).*), die/api/*uitsluit. Voeg/api/track(en/:locale/api/trackals je URL's met een taalprefix gebruikt) als expliciete items toe aan de matcher-array. - Je hebt de header aan de response toegevoegd in plaats van aan de request. De backend leest request-headers; gebruik
NextResponse.next({ request: { headers } }), nietresponse.headers.set(...). - Je edgeprovider is niet Cloudflare. Zit je achter Vercel, Fly.io of een andere edge, lees het IP-adres van de bezoeker dan uit de header van die edge (
x-real-ip,x-vercel-forwarded-for,fly-client-ip, enzovoort).