Pomoc/Przewodniki proxy
Przewodniki proxy

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

Terminal
npm install express-http-proxy

2. Skonfiguruj proxy

Dodaj poniższą konfigurację proxy do aplikacji Express.js:

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

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:

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

  1. Otwórz swoją witrynę
  2. Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
  3. 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:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy ustawia x-flowsery-real-ip na prawdziwy adres IP odwiedzającego, a nie adres serwera.
  2. Jeśli Express działa za innym proxy (Nginx, Cloudflare itp.), srcReq.ip wskazuje to nadrzędne proxy, a nie odwiedzającego. Odczytuj wtedy bezpośrednio cf-connecting-ip / x-real-ip, jak pokazano w kroku 2.