Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Vue.js

Stuur Flowsery Analytics via je Vue.js-ontwikkelserver, zodat adblockers er niet tussen komen en je nauwkeurigere bezoekersdata verzamelt.

1. De proxy van de Vue.js-ontwikkelserver instellen

Gebruik je Vue CLI, werk dan je vue.config.js bij met de volgende proxyregels:

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',
        },
      },
    },
  },
};

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

2. Productieconfiguratie: de webserver instellen

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>

Belangrijk: lijkt elke bezoeker in je dashboard op dezelfde locatie te zitten, controleer dan dat de header x-flowsery-real-ip het echte IP-adres van de bezoeker bevat (niet dat van de proxyserver) wanneer verzoeken worden doorgestuurd naar het /events-endpoint van Flowsery Analytics.

3. De scripttag aanpassen

Vervang het oorspronkelijke Flowsery Analytics-fragment door de geproxyde versie:

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

4. Deployen

Zodra je de wijzigingen hebt gedeployd, 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 dat de analyticsverzoeken vanaf je eigen domein worden geladen en niet vanaf analytics.flowsery.com

In productie raden we een aparte webserver (Nginx of Apache) aan in plaats van de proxy van de ontwikkelserver.

Probleemoplossing

Elke bezoeker lijkt van dezelfde locatie te komen

Tonen alle bezoekers één en dezelfde 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 de header x-flowsery-real-ip meestuurt met het echte IP-adres van de bezoeker (niet dat van de server) wanneer verzoeken worden doorgestuurd naar het /events-endpoint van Flowsery Analytics
  2. Zit de webserver achter een andere proxy (Cloudflare, Vercel, enzovoort), dan is $remote_addr / %{REMOTE_ADDR}e de upstream-proxy; gebruik in dat geval rechtstreeks $http_cf_connecting_ip / %{HTTP:CF-Connecting-IP} of $http_x_real_ip