Support/Proxyhandleidingen
Proxyhandleidingen

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:

JavaScript
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:

TypeScript
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:

TypeScript
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:

TypeScript
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:

HTML
<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

  1. Open je site in een gewoon browsertabblad.
  2. Open DevTools → Network. Filter op /api/track.
  3. Controleer dat elk verzoek naar je eigen domein gaat (niet naar analytics.flowsery.com).
  4. 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/track als 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 } }), niet response.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).