Assistance/Guides proxy
Guides proxy

Proxy Flowsery Analytics avec FastAPI

Faites transiter Flowsery Analytics via votre serveur FastAPI afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.

1. Installer les dépendances

Terminal
pip install fastapi uvicorn httpx

2. Mettre en place le proxy

Ajoutez ce qui suit à votre application FastAPI :

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)

Remarque : si votre application possède déjà un endpoint /api/track, utilisez l'attribut data-api sur la balise script Flowsery Analytics pour envoyer les événements vers un autre chemin. Par exemple, data-api="/flowsery-events" envoie les données vers /flowsery-events.

Important : si tous les visiteurs apparaissent au même endroit dans votre tableau de bord, vérifiez que l'en-tête x-flowsery-real-ip est bien défini sur la vraie IP du visiteur (et non celle du serveur proxy) lors du transfert des requêtes vers le endpoint /events de Flowsery Analytics. Si FastAPI est derrière un autre proxy (Cloudflare, Vercel, etc.), request.client.host sera l'IP du proxy amont : lisez plutôt cf-connecting-ip ou x-real-ip.

3. Modifier la balise script

Remplacez le snippet Flowsery Analytics par la version proxifiée :

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

4. Déployer

Après le déploiement de votre serveur, la configuration proxy s'active automatiquement.

Vérifier que cela fonctionne

Pour valider le bon fonctionnement du proxy :

  1. Ouvrez votre site web
  2. Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
  3. Vérifiez que les requêtes analytics sont servies depuis votre domaine plutôt que depuis analytics.flowsery.com