Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy dla Flowsery Analytics w Vue.js

Kieruj Flowsery Analytics przez serwer deweloperski Vue.js, aby adblockery nie zakłócały śledzenia, a dane o odwiedzających były dokładniejsze.

1. Skonfiguruj proxy serwera deweloperskiego Vue.js

Jeśli korzystasz z Vue CLI, dodaj do pliku vue.config.js poniższe reguły proxy:

JavaScript
module.exports = {
  devServer: {
    proxy: {
      '/js/main.js': {
        target: 'https://analytics.flowsery.com',
        changeOrigin: true,
        pathRewrite: {
          '^/js/main.js': '/js/main.js',
        },
      },
      '/api/track': {
        target: 'https://analytics.flowsery.com',
        changeOrigin: true,
        pathRewrite: {
          '^/api/track': '/analytics/events',
        },
      },
    },
  },
};

Uwaga: Jeśli twój projekt ma już trasę /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować dane o zdarzeniach w inne miejsce. Na przykład data-api="/flowsery-events" przekieruje dane na /flowsery-events.

2. Konfiguracja produkcyjna: serwer WWW

Nginx

Nginx
location /js/main.js {
    proxy_pass https://cdn.flowsery.com/main.js;
    proxy_set_header Host analytics.flowsery.com;
    proxy_cache_valid 200 1y;
    add_header Cache-Control "public, max-age=31536000";
    expires 1y;
}
 
location /api/track {
    proxy_pass https://analytics.flowsery.com/analytics/events;
    proxy_set_header Host analytics.flowsery.com;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header x-forwarded-for $remote_addr;
    # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
    proxy_set_header x-flowsery-real-ip $remote_addr;
 
    # Allow POST requests
    proxy_method POST;
    proxy_pass_request_body on;
}
APACHE
<Location "/js/main.js">
    ProxyPass https://cdn.flowsery.com/main.js
    ProxyPassReverse https://cdn.flowsery.com/main.js
    Header set Cache-Control "public, max-age=31536000"
</Location>
 
<Location "/api/track">
    ProxyPass https://analytics.flowsery.com/analytics/events
    ProxyPassReverse https://analytics.flowsery.com/analytics/events
    RequestHeader set x-forwarded-for %{REMOTE_ADDR}e
    # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
    RequestHeader set x-flowsery-real-ip %{REMOTE_ADDR}e
</Location>

Ważne: Jeśli w panelu wszyscy odwiedzający mają tę samą lokalizację, 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 zmian konfiguracja proxy zacznie działać automatycznie.

Sprawdzenie, czy wszystko działa

Aby upewnić się, że proxy działa prawidłowo:

  1. Otwórz swoją stronę
  2. Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
  3. Sprawdź, czy żądania analityczne są obsługiwane z twojej domeny, a nie z analytics.flowsery.com

W środowisku produkcyjnym zalecamy dedykowany serwer WWW (Nginx lub Apache) zamiast proxy serwera deweloperskiego.

Rozwiązywanie problemów

Wszyscy odwiedzający pochodzą z tej samej lokalizacji

Jeśli wszyscy odwiedzający mają jedną lokalizację (na przykład region twojego serwera), proxy nie przekazuje prawidłowo ich prawdziwych adresów IP.

Rozwiązanie:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy dołącza nagłówek x-flowsery-real-ip z rzeczywistym adresem IP odwiedzającego (a nie adresem serwera)
  2. Jeśli serwer WWW działa za innym proxy (Cloudflare, Vercel itp.), $remote_addr / %{REMOTE_ADDR}e będzie adresem tego proxy, dlatego użyj bezpośrednio $http_cf_connecting_ip / %{HTTP:CF-Connecting-IP} lub $http_x_real_ip