Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Firebase Hosting

Stuur Flowsery Analytics via Firebase Hosting met Cloud Functions om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen.

Let op: Firebase Hosting ondersteunt zelf geen reverse-proxy-rewrites naar externe bestemmingen. Deze handleiding gebruikt daarom Firebase Cloud Functions als alternatief.

1. Initialiseer Firebase Functions (als dat nog niet is gebeurd)

Heeft je project nog geen Firebase Functions, voer dan uit:

Terminal
firebase init functions

Volg de installatievragen voor je omgeving. Daarna staat er een map /functions in je project.

2. Installeer de dependencies

Ga naar de map functions/ en installeer de benodigde pakketten:

Terminal
cd functions/
npm i -s express express-http-proxy

3. Bouw de reverse-proxyfunctie

Maak of wijzig functions/index.js met het volgende:

JavaScript
const { onRequest } = require('firebase-functions/v2/https');
const express = require('express');
const proxy = require('express-http-proxy');
 
const app = express();
 
app.set('trust proxy', true);
 
// Proxy the Flowsery Analytics tracking script
app.use(
  '/js/main.js',
  proxy('https://analytics.flowsery.com', {
    proxyReqPathResolver: () => '/js/main.js',
  })
);
 
// Proxy the event collection endpoint
app.use(
  '/api/track',
  proxy('https://analytics.flowsery.com', {
    proxyReqPathResolver: () => '/analytics/events',
    proxyReqOptDecorator: (proxyReqOpts, srcReq) => {
      // Forward the real visitor IP for accurate geolocation
      const clientIp =
        srcReq.headers['cf-connecting-ip'] || srcReq.headers['x-real-ip'] || srcReq.headers['x-forwarded-for']?.split(',')[0]?.trim() || srcReq.ip;
      proxyReqOpts.headers['x-forwarded-for'] = clientIp;
      if (clientIp) {
        // CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
        proxyReqOpts.headers['x-flowsery-real-ip'] = clientIp;
      }
      return proxyReqOpts;
    },
  })
);
 
exports.reverseProxy = onRequest(app);

Let op: gebruikt je project al een /api/track-route, 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 de header 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.

4. Stel de rewrites in Firebase Hosting in

Pas firebase.json aan zodat de bijbehorende paden naar de functie reverseProxy gaan:

JSON
{
  "hosting": {
    "public": "public",
    "ignore": ["firebase.json", "**/.*", "**/node_modules/**"],
    "rewrites": [
      {
        "source": "/js/main.js",
        "function": "reverseProxy"
      },
      {
        "source": "/api/track",
        "function": "reverseProxy"
      }
    ]
  },
  "functions": [
    {
      "source": "functions",
      "codebase": "default",
      "ignore": ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log", "*.local"]
    }
  ]
}

5. Pas de scripttag aan

Vervang de oorspronkelijke snippet van Flowsery Analytics door de geproxyde versie:

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

6. Deploy Hosting en Functions

Deploy hosting en functions in één keer:

Terminal
firebase deploy --only hosting,functions

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

  1. Zorg dat je proxy de header x-flowsery-real-ip meestuurt met 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
  2. Staat de Cloud Function achter een andere proxy (Cloudflare, Vercel, enz.), dan is srcReq.ip die upstream-proxy; gebruik in dat geval rechtstreeks cf-connecting-ip of x-real-ip