Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Astro

Leid Flowsery Analytics via middleware door je Astro-applicatie, zodat adblockers er geen roet in het eten gooien en je nauwkeurigere bezoekersgegevens verzamelt.

1. Maak de middleware aan

Maak een middlewarebestand aan op src/middleware.js (of src/middleware.ts voor TypeScript-projecten):

JavaScript
// 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. Zet server-side rendering aan in Astro

Pas je astro.config.mjs aan zodat SSR wordt ondersteund (nodig voor middleware):

JavaScript
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
 
export default defineConfig({
  output: 'server', // or 'hybrid'
  adapter: node({
    mode: 'standalone',
  }),
});

Je hebt ook de Node.js-adapter nodig: npm install @astrojs/node

3. Alternatief: statische site met API-routes

Wil je je site liever volledig statisch houden, maak dan API-routes aan in plaats van middleware:

Proxyroute voor het script

Maak src/pages/js/main.js.js aan:

JavaScript
// 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',
    },
  });
}

Proxyroute voor events

Maak src/pages/api/track.js aan:

JavaScript
// 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',
    },
  });
}

Let op: gebruikt je project al een route /api/track, voeg dan data-api toe aan de scripttag van Flowsery Analytics om events naar een ander pad te sturen. Met data-api="/flowsery-events" gaan de gegevens bijvoorbeeld naar /flowsery-events.

Belangrijk: lijkt in je dashboard elke bezoeker op dezelfde locatie te zitten, controleer dan of x-flowsery-real-ip is ingesteld op het echte IP-adres van de bezoeker (niet dat van de proxyserver) als je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.

4. Pas de scripttag aan

Vervang het oorspronkelijke Flowsery Analytics-fragment in je layout door de versie via de proxy:

ASTRO
---
// 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. Deploy

Na het deployen werkt de proxyconfiguratie automatisch. Controleer of je hostingprovider het volgende ondersteunt:

  • Server-side rendering (voor de aanpak met middleware)
  • API-routes (voor de aanpak met een statische site)

Veelgebruikte hosts die met Astro werken, zijn Vercel, Netlify en Cloudflare Pages.

Controleren of het werkt

Zo controleer je of de proxy goed werkt:

  1. Ga naar je website
  2. Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
  3. Controleer of analyticsverzoeken via je eigen domein lopen in plaats van via analytics.flowsery.com

Let op: de aanpak met middleware vereist server-side rendering, terwijl API-routes werken op zowel statische als server-gerenderde sites.

Probleemoplossing

Elke bezoeker komt van dezelfde locatie

Tonen alle bezoekers één en dezelfde geografische locatie, zoals de regio van je server, dan stuurt de proxy de echte IP-adressen van bezoekers niet goed door.

Oplossing:

  1. Zorg dat je proxy x-flowsery-real-ip instelt op het echte IP-adres van de bezoeker (niet dat van de server) als die verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.
  2. Draait je Astro-deployment achter nog een proxy (Vercel, Cloudflare, Netlify), dan staat het IP-adres dat je zoekt meestal in cf-connecting-ip, x-vercel-forwarded-for of x-real-ip: lees de header die je edge als eerste aanlevert.