Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met FastAPI

Stuur Flowsery Analytics via je FastAPI-server om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen.

1. Installeer de dependencies

Terminal
pip install fastapi uvicorn httpx

2. Stel de proxy in

Voeg het volgende toe aan je FastAPI-applicatie:

Python
from fastapi import FastAPI, Request
from fastapi.responses import Response
import httpx
 
app = FastAPI()
 
def get_client_ip(request: Request) -> str:
    """Resolve the actual visitor IP address"""
    # Prefer Cloudflare's CF-Connecting-IP if available
    if cf_connecting_ip := request.headers.get("cf-connecting-ip"):
        return cf_connecting_ip
 
    # Then X-Real-IP
    if x_real_ip := request.headers.get("x-real-ip"):
        return x_real_ip
 
    # Fall back to X-Forwarded-For (first entry)
    if x_forwarded_for := request.headers.get("x-forwarded-for"):
        return x_forwarded_for.split(",")[0].strip()
 
    # Last resort: direct connection host
    return request.client.host if request.client else ""
 
@app.get("/js/main.js")
async def proxy_script():
    async with httpx.AsyncClient() as client:
        response = await client.get('https://cdn.flowsery.com/main.js')
        return Response(
            content=response.content,
            media_type='application/javascript',
            headers={
                'Cache-Control': 'public, max-age=31536000'
            }
        )
 
@app.post("/api/track")
async def proxy_events(request: Request):
    body = await request.json()
 
    # Determine the origin from the request or construct it from the base URL
    origin = request.headers.get('origin') or str(request.base_url).rstrip('/')
 
    # Resolve visitor IP for accurate geolocation
    client_ip = get_client_ip(request)
 
    async with httpx.AsyncClient() as client:
        headers = {
            'Content-Type': 'application/json',
            'User-Agent': request.headers.get('user-agent'),
            'Origin': origin,
            'x-forwarded-for': client_ip
        }
 
        if client_ip:
            # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
            headers['x-flowsery-real-ip'] = client_ip
 
        response = await client.post(
            'https://analytics.flowsery.com/analytics/events',
            json=body,
            headers=headers
        )
        return Response(
            content=response.content,
            media_type='application/json',
            status_code=response.status_code
        )
 
if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)

Let op: heeft je applicatie al een /api/track-endpoint, gebruik dan het attribuut data-api op de scripttag van Flowsery Analytics om events naar een ander pad 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. Staat FastAPI achter een andere proxy (Cloudflare, Vercel, enz.), dan is request.client.host die upstream-proxy; lees in dat geval rechtstreeks cf-connecting-ip of x-real-ip uit.

3. 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>

4. Deploy

Zodra je server gedeployed is, 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 of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com