Proxy Flowsery Analytics avec PHP
Faites transiter Flowsery Analytics via votre serveur PHP afin d'éviter les interférences des bloqueurs de publicités et de capturer des données visiteurs plus précises.
1. Créer les endpoints proxy
Configurez deux fichiers PHP pour gérer les requêtes proxifiées :
script.php
<?php
header('Content-Type: application/javascript');
header('Cache-Control: public, max-age=31536000');
$ch = curl_init('https://cdn.flowsery.com/main.js');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$script = curl_exec($ch);
curl_close($ch);
echo $script;<?php
header('Content-Type: application/json');
// Resolve the real visitor IP
function getClientIp() {
if (!empty($_SERVER['HTTP_CF_CONNECTING_IP'])) {
return $_SERVER['HTTP_CF_CONNECTING_IP'];
}
if (!empty($_SERVER['HTTP_X_REAL_IP'])) {
return $_SERVER['HTTP_X_REAL_IP'];
}
if (!empty($_SERVER['HTTP_X_FORWARDED_FOR'])) {
$ips = explode(',', $_SERVER['HTTP_X_FORWARDED_FOR']);
return trim($ips[0]);
}
return $_SERVER['REMOTE_ADDR'] ?? '';
}
// Determine the origin from request headers or build it from server variables
$origin = $_SERVER['HTTP_ORIGIN'] ??
($_SERVER['HTTPS'] === 'on' ? 'https://' : 'http://') . $_SERVER['HTTP_HOST'];
$clientIp = getClientIp();
$requestHeaders = [
'Content-Type: application/json',
'User-Agent: ' . $_SERVER['HTTP_USER_AGENT'],
'Origin: ' . $origin,
'x-forwarded-for: ' . $clientIp,
];
if (!empty($clientIp)) {
// CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
$requestHeaders[] = 'x-flowsery-real-ip: ' . $clientIp;
}
$ch = curl_init('https://analytics.flowsery.com/analytics/events');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, file_get_contents('php://input'));
curl_setopt($ch, CURLOPT_HTTPHEADER, $requestHeaders);
$response = curl_exec($ch);
curl_close($ch);
echo $response;Remarque : si votre application possède déjà un endpoint /api/track, utilisez l'attribut data-api sur la balise script Flowsery Analytics pour diriger les événements vers un autre chemin. Par exemple, data-api="/flowsery-events" redirige 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 l'endpoint /events de Flowsery Analytics.
2. Configurer le routage du serveur web
Apache (.htaccess)
RewriteEngine On
RewriteRule ^js/script\.js$ script.php [L]
RewriteRule ^api/events$ events.php [L]location /js/main.js {
try_files $uri $uri/ /script.php?$query_string;
}
location /api/track {
try_files $uri $uri/ /events.php?$query_string;
}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
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 PHP est derrière un autre proxy (Cloudflare, Vercel, etc.),
$_SERVER['REMOTE_ADDR']sera l'IP du proxy amont : lisez plutôt$_SERVER['HTTP_CF_CONNECTING_IP']ou$_SERVER['HTTP_X_REAL_IP']