Assistance/Guides proxy
Guides proxy

Proxy Flowsery Analytics avec DigitalOcean

Faites transiter Flowsery Analytics via DigitalOcean afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises. Ce guide couvre à la fois App Platform et les configurations basées sur Droplet.

Option 1 : DigitalOcean App Platform

Si vous utilisez DigitalOcean App Platform avec Node.js, reportez-vous au guide spécifique au framework correspondant à votre stack :

App Platform gère automatiquement le transfert des IP via l'en-tête X-Forwarded-For, donc les configurations de ces guides fonctionnent sans modification.

Option 2 : DigitalOcean Droplet avec Nginx

Si vous utilisez un DigitalOcean Droplet avec Nginx comme serveur web ou reverse proxy, utilisez la configuration suivante.

1. Vous connecter à votre Droplet

Terminal
ssh root@your-droplet-ip

2. Ouvrir la configuration Nginx

Modifiez le fichier de configuration de votre site, par exemple /etc/nginx/sites-available/your-site :

Terminal
sudo nano /etc/nginx/sites-available/your-site

3. Ajouter les blocs location proxy

Insérez les blocs location suivants dans votre configuration serveur :

Nginx
server {
    listen 80;
    server_name your_domain.com;
 
    # Your existing configuration...
 
    # Proxy the analytics script
    location /js/main.js {
        proxy_pass https://cdn.flowsery.com/main.js;
        proxy_set_header Host analytics.flowsery.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
 
        # Cache the script for 1 year
        add_header Cache-Control "public, max-age=31536000";
        expires 1y;
    }
 
    # Proxy the event collection endpoint
    location /api/track {
        proxy_pass https://analytics.flowsery.com/analytics/events;
        proxy_set_header Host analytics.flowsery.com;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        # CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
        proxy_set_header x-flowsery-real-ip $remote_addr;
 
        # Allow POST requests
        proxy_method POST;
        proxy_pass_request_body on;
    }
 
    # Your other location blocks...
}

Remarque : si vous avez déjà un bloc location /api/track, ajoutez data-api à la balise script Flowsery Analytics pour rediriger les événements. Par exemple, data-api="/flowsery-events" envoie les données vers /flowsery-events.

4. Tester et recharger Nginx

Vérifiez la configuration pour détecter les erreurs de syntaxe :

Terminal
sudo nginx -t

Si le test est concluant, rechargez Nginx :

Terminal
sudo systemctl reload nginx

5. Optionnel : activer le cache

Pour améliorer les performances, configurez une zone de cache Nginx :

Nginx
# Place this outside the server block (typically at the top of nginx.conf)
proxy_cache_path /var/cache/nginx/flowsery_cache
    levels=1:2
    keys_zone=flowsery_cache:10m
    max_size=100m
    inactive=60m
    use_temp_path=off;
 
# In your server block, update the script location
location /js/main.js {
    proxy_cache flowsery_cache;
    proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504;
    proxy_cache_valid 200 1y;
    proxy_cache_bypass $http_pragma;
    proxy_cache_revalidate on;
 
    proxy_pass https://cdn.flowsery.com/main.js;
    proxy_set_header Host analytics.flowsery.com;
 
    add_header Cache-Control "public, max-age=31536000";
    expires 1y;
}

Option 3 : DigitalOcean Spaces CDN

Si vous utilisez DigitalOcean Spaces CDN devant votre Droplet, assurez-vous qu'il transfère correctement les IP clientes :

  1. Dans le tableau de bord DigitalOcean, allez dans Networking > CDN
  2. Vérifiez que votre CDN est configuré pour laisser passer les en-têtes de requête
  3. Le CDN ajoute automatiquement des en-têtes X-Forwarded-For
  4. Votre configuration Nginx récupérera les IP visiteurs depuis ces en-têtes

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>

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
  4. Vérifiez dans votre tableau de bord Flowsery Analytics que les localisations des visiteurs sont affichées correctement

Dépannage

Tous les visiteurs apparaissent au même endroit

Lorsque tous les visiteurs affichent une seule localisation géographique, comme la région de votre serveur, le proxy ne transmet pas correctement les vraies IP des visiteurs.

Résolution :

  1. Assurez-vous que votre proxy inclut l'en-tête x-flowsery-real-ip contenant la vraie adresse IP du visiteur (et non celle du serveur) lors du transfert des requêtes vers le endpoint /events de Flowsery Analytics
  2. Si Nginx est derrière un autre proxy (Cloudflare, Vercel, etc.), $remote_addr sera l'IP du proxy amont : lisez plutôt $http_cf_connecting_ip ou $http_x_real_ip