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
npm install express-http-proxy2. Stel de proxy in
Voeg de volgende proxyconfiguratie toe aan je Express.js-app:
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:
<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:
- Ga naar je website
- Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
- 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:
- Zorg dat je proxy
x-flowsery-real-ipinstelt 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. - Staat Express achter een andere proxy (Nginx, Cloudflare, enz.), dan is
srcReq.ipdie upstream-proxy en niet de bezoeker. Lees in dat geval rechtstreekscf-connecting-ip/x-real-ipuit, zoals in stap 2.