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
pip install fastapi uvicorn httpx2. Stel de proxy in
Voeg het volgende toe aan je FastAPI-applicatie:
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:
<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:
- Ga naar je website
- Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
- Controleer of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com