Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Express.js

Stuur Flowsery Analytics via je Express.js-server om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen.

1. Installeer de dependencies

Terminal
npm install express-http-proxy

2. Stel de proxy in

Voeg de volgende proxyconfiguratie toe aan je Express.js-app:

JavaScript
const express = require('express');
const proxy = require('express-http-proxy');
const app = express();
 
app.set('trust proxy', true);
 
// Proxy the tracking script
app.use(
  '/js/main.js',
  proxy('analytics.flowsery.com', {
    https: true,
    proxyReqPathResolver: function (req) {
      return '/js/main.js';
    },
  })
);
 
// Proxy the event collection endpoint + forward real visitor IP
app.use(
  '/api/track',
  proxy('analytics.flowsery.com', {
    https: true,
    proxyReqPathResolver: function (req) {
      return '/analytics/events';
    },
    proxyReqOptDecorator: function (proxyReqOpts, srcReq) {
      // Determine the real visitor IP. Use whichever header your edge provides.
      const clientIp =
        srcReq.headers['cf-connecting-ip'] || srcReq.headers['x-real-ip'] || srcReq.headers['x-forwarded-for']?.split(',')[0]?.trim() || srcReq.ip;
 
      // CRITICAL: Flowsery reads `x-flowsery-real-ip` as the authoritative
      // visitor IP. Without it, every visitor resolves to your server's
      // region because the proxy hop rewrites `cf-connecting-ip`.
      if (clientIp) {
        proxyReqOpts.headers['x-flowsery-real-ip'] = clientIp;
      }
 
      return proxyReqOpts;
    },
  })
);
 
// Your other routes...
app.listen(3000);

Let op: gebruikt je app /api/track al, voeg dan data-api toe aan de scripttag van Flowsery Analytics om events ergens anders heen te sturen. Met data-api="/flowsery-events" gaat de data bijvoorbeeld naar /flowsery-events.

Belangrijk: lijken alle bezoekers in je dashboard vanaf dezelfde locatie te komen, controleer dan of x-flowsery-real-ip het echte IP-adres van de bezoeker bevat (niet dat van de proxyserver) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.

3. Pas de scripttag aan

Vervang de oorspronkelijke snippet van Flowsery Analytics door de geproxyde versie:

HTML
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>

4. Deploy

Zodra je server gedeployed is, werkt de proxyconfiguratie automatisch.

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 de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com

Problemen oplossen

Alle bezoekers komen vanaf dezelfde locatie

Tonen alle bezoekers één geografische locatie, bijvoorbeeld 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 het IP-adres van de server) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics.
  2. Staat Express achter een andere proxy (Nginx, Cloudflare, enz.), dan is srcReq.ip die upstream-proxy en niet de bezoeker. Lees in dat geval rechtstreeks cf-connecting-ip / x-real-ip uit, zoals in stap 2.