Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy Flowsery Analytics przez Flask

Kieruj Flowsery Analytics przez aplikację Flask, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.

1. Zainstaluj zależności

Terminal
pip install flask requests

2. Skonfiguruj proxy

Dodaj poniższe trasy i funkcję pomocniczą do aplikacji Flask:

Python
from flask import Flask, request, Response
import requests
 
app = Flask(__name__)
 
 
def get_client_ip():
    """
    Determine the actual visitor IP address.
    When behind Cloudflare, prefer CF-Connecting-IP. Then X-Real-IP.
    Then X-Forwarded-For's first entry. Finally fall back to request.remote_addr.
    """
    cf_ip = request.headers.get("CF-Connecting-IP")
    if cf_ip:
        return cf_ip
    real_ip = request.headers.get("X-Real-IP")
    if real_ip:
        return real_ip
    xff = request.headers.get("X-Forwarded-For")
    if xff:
        # Comma-separated list: "client, proxy1, proxy2"
        parts = [ip.strip() for ip in xff.split(",")]
        if parts:
            return parts[0]  # the leftmost entry is the original client
    return request.remote_addr
 
 
@app.route("/js/main.js")
def proxy_script():
    response = requests.get("https://cdn.flowsery.com/main.js")
    return Response(
        response.content,
        content_type="application/javascript",
        headers={"Cache-Control": "public, max-age=31536000"},
    )
 
 
@app.route("/api/track", methods=["POST"])
def proxy_events():
    # Copy incoming headers but omit those that should match the target
    excluded = {"host", "content-length"}
    headers = {
        key: value
        for key, value in request.headers.items()
        if key.lower() not in excluded
    }
 
    # The Origin header is required by the Flowsery Analytics API
    if "Origin" not in headers:
        scheme = request.scheme
        host = request.host
        headers["Origin"] = f"{scheme}://{host}"
 
    # Attach the real visitor IP for accurate geolocation
    client_ip = get_client_ip()
    headers["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
 
    # Forward the request body and headers to Flowsery Analytics
    response = requests.post(
        "https://analytics.flowsery.com/analytics/events",
        data=request.get_data(),
        headers=headers,
        timeout=5,
    )
 
    # Return the upstream response to the browser
    return Response(
        response.content,
        status=response.status_code,
        content_type=response.headers.get("Content-Type", "application/json"),
    )

Uwaga: jeśli twoja aplikacja ma już endpoint /api/track, użyj atrybutu data-api w tagu skryptu Flowsery Analytics, aby wysyłać zdarzenia na inną ścieżkę. Na przykład data-api="/flowsery-events" kieruje dane na /flowsery-events.

Ważne: jeśli w panelu wszyscy odwiedzający są w tej samej lokalizacji, sprawdź, czy przy przekazywaniu żądań do endpointu /events Flowsery Analytics nagłówek x-flowsery-real-ip zawiera prawdziwy adres IP odwiedzającego, a nie adres serwera proxy.

3. Zmień tag skryptu

Zastąp oryginalny fragment kodu Flowsery Analytics wersją korzystającą z proxy:

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

4. Wdróż zmiany

Po wdrożeniu serwera konfiguracja proxy zacznie działać automatycznie.

Sprawdź, czy to działa

Aby upewnić się, że proxy działa poprawnie:

  1. Otwórz swoją witrynę
  2. Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
  3. Sprawdź, czy żądania analityczne są obsługiwane przez twoją domenę, a nie przez analytics.flowsery.com

Rozwiązywanie problemów

Wszyscy odwiedzający są z tej samej lokalizacji

Jeśli wszyscy odwiedzający mają jedną lokalizację geograficzną, na przykład region twojego serwera, proxy nie przekazuje poprawnie ich prawdziwych adresów IP.

Rozwiązanie:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy dołącza nagłówek x-flowsery-real-ip z prawdziwym adresem IP odwiedzającego, a nie adresem serwera
  2. Jeśli Flask działa za innym proxy (Cloudflare, Vercel itp.), request.remote_addr wskaże to nadrzędne proxy. Odczytuj wtedy bezpośrednio request.headers.get('CF-Connecting-IP') lub request.headers.get('X-Real-IP')