Proxy Flowsery Analytics przez Express.js
Kieruj Flowsery Analytics przez serwer Express.js, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.
1. Zainstaluj zależności
npm install express-http-proxy2. Skonfiguruj proxy
Dodaj poniższą konfigurację proxy do aplikacji Express.js:
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);Uwaga: jeśli twoja aplikacja używa już /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować zdarzenia w inne miejsce. Na przykład data-api="/flowsery-events" wysyła dane na /flowsery-events.
Ważne: jeśli w panelu wszyscy odwiedzający są w tej samej lokalizacji, sprawdź, czy przy przekazywaniu żądań do endpointu /events Flowsery Analytics nagłówek x-flowsery-real-ip zawiera prawdziwy adres IP odwiedzającego, a nie adres serwera proxy.
3. Zmień tag skryptu
Zastąp oryginalny fragment kodu Flowsery Analytics wersją korzystającą z proxy:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Wdróż zmiany
Po wdrożeniu serwera konfiguracja proxy zacznie działać automatycznie.
Sprawdź, czy to działa
Aby upewnić się, że proxy działa poprawnie:
- Otwórz swoją witrynę
- Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
- Sprawdź, czy żądania analityczne są obsługiwane przez twoją domenę, a nie przez analytics.flowsery.com
Rozwiązywanie problemów
Wszyscy odwiedzający są z tej samej lokalizacji
Jeśli wszyscy odwiedzający mają jedną lokalizację geograficzną, na przykład region twojego serwera, proxy nie przekazuje poprawnie ich prawdziwych adresów IP.
Rozwiązanie:
- Upewnij się, że przy przekazywaniu żądań do endpointu
/eventsFlowsery Analytics proxy ustawiax-flowsery-real-ipna prawdziwy adres IP odwiedzającego, a nie adres serwera. - Jeśli Express działa za innym proxy (Nginx, Cloudflare itp.),
srcReq.ipwskazuje to nadrzędne proxy, a nie odwiedzającego. Odczytuj wtedy bezpośredniocf-connecting-ip/x-real-ip, jak pokazano w kroku 2.