Assistance/Guides proxy
Guides proxy

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

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. Activer le rendu côté serveur dans Astro

Mettez à jour astro.config.mjs pour activer le SSR (nécessaire pour le 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',
  }),
});

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 :

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

Route proxy pour les événements

Créez src/pages/api/track.js :

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

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 :

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

  1. Ouvrez votre site web
  2. Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
  3. 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 :

  1. Assurez-vous que votre proxy définit x-flowsery-real-ip sur la vraie IP du visiteur (et non l'IP du serveur) lors du transfert des requêtes vers le endpoint /events de Flowsery Analytics.
  2. 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-for ou x-real-ip : lisez d'abord celui que votre edge fournit.