Proxy Flowsery Analytics avec Vue.js
Faites transiter Flowsery Analytics via votre serveur de développement Vue.js afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.
1. Configurer le proxy du serveur de dev Vue.js
Si vous utilisez Vue CLI, mettez à jour votre vue.config.js avec les règles proxy suivantes :
module.exports = {
devServer: {
proxy: {
'/js/main.js': {
target: 'https://analytics.flowsery.com',
changeOrigin: true,
pathRewrite: {
'^/js/main.js': '/js/main.js',
},
},
'/api/track': {
target: 'https://analytics.flowsery.com',
changeOrigin: true,
pathRewrite: {
'^/api/track': '/analytics/events',
},
},
},
},
};Remarque : si votre projet utilise déjà une route /api/track, ajoutez data-api à la balise script Flowsery Analytics pour rediriger les données d'événements ailleurs. Par exemple, data-api="/flowsery-events" redirige les données vers /flowsery-events.
2. Configuration de production : configurer le serveur web
Nginx
location /js/main.js {
proxy_pass https://cdn.flowsery.com/main.js;
proxy_set_header Host analytics.flowsery.com;
proxy_cache_valid 200 1y;
add_header Cache-Control "public, max-age=31536000";
expires 1y;
}
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;
proxy_set_header x-forwarded-for $remote_addr;
# 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;
}<Location "/js/main.js">
ProxyPass https://cdn.flowsery.com/main.js
ProxyPassReverse https://cdn.flowsery.com/main.js
Header set Cache-Control "public, max-age=31536000"
</Location>
<Location "/api/track">
ProxyPass https://analytics.flowsery.com/analytics/events
ProxyPassReverse https://analytics.flowsery.com/analytics/events
RequestHeader set x-forwarded-for %{REMOTE_ADDR}e
# CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
RequestHeader set x-flowsery-real-ip %{REMOTE_ADDR}e
</Location>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 l'endpoint /events de Flowsery Analytics.
3. Modifier la balise script
Remplacez le snippet Flowsery Analytics par la version proxifiée :
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Déployer
Après le déploiement de vos changements, la configuration proxy s'active automatiquement.
Vérifier que cela fonctionne
Pour valider le bon fonctionnement du proxy :
- Ouvrez votre site web
- Ouvrez les outils de développement de votre navigateur et passez à l'onglet Réseau
- Vérifiez que les requêtes analytics sont servies depuis votre domaine plutôt que depuis analytics.flowsery.com
En production, il est recommandé d'utiliser un serveur web dédié (Nginx ou Apache) plutôt que de s'appuyer sur le proxy du serveur de développement.
Dépannage
Tous les visiteurs apparaissent au même endroit
Lorsque tous les visiteurs affichent une seule localisation géographique (par exemple la région de votre serveur), le proxy ne transmet pas correctement les vraies IP des visiteurs.
Résolution :
- Assurez-vous que votre proxy inclut l'en-tête
x-flowsery-real-ipcontenant la vraie adresse IP du visiteur (et non celle du serveur) lors du transfert des requêtes vers l'endpoint/eventsde Flowsery Analytics - Si le serveur web est derrière un autre proxy (Cloudflare, Vercel, etc.),
$remote_addr/%{REMOTE_ADDR}esera l'IP du proxy amont : utilisez plutôt$http_cf_connecting_ip/%{HTTP:CF-Connecting-IP}ou$http_x_real_ip