Proxy di Flowsery Analytics con PHP
Instrada Flowsery Analytics attraverso il tuo server PHP per evitare il blocco degli adblocker e raccogliere dati più precisi sui visitatori.
1. Crea gli endpoint del proxy
Crea due file PHP che gestiscono le richieste passate dal proxy:
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;Nota: se la tua applicazione ha già un endpoint /api/track, usa l'attributo data-api sul tag script di Flowsery Analytics per indirizzare gli eventi a un percorso diverso. Per esempio, data-api="/flowsery-events" instrada i dati verso /flowsery-events.
Importante: se nella dashboard tutti i visitatori risultano nella stessa località, verifica che l'header x-flowsery-real-ip contenga l'IP reale del visitatore (non quello del server proxy) quando inoltri le richieste all'endpoint /events di Flowsery Analytics.
2. Configura il routing del web server
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. Modifica il tag script
Sostituisci lo snippet originale di Flowsery Analytics con la versione che passa dal proxy:
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>4. Pubblica
Dopo il deploy delle modifiche, la configurazione del proxy si attiva da sola.
Verifica che funzioni
Per controllare che il proxy funzioni correttamente:
- Vai sul tuo sito
- Apri gli strumenti per sviluppatori del browser e passa alla scheda Network
- Verifica che le richieste di analytics partano dal tuo dominio e non da analytics.flowsery.com
Risoluzione dei problemi
Tutti i visitatori risultano dalla stessa località
Se tutti i visitatori compaiono in un'unica località geografica (per esempio la regione del tuo server), il proxy non sta inoltrando correttamente gli IP reali dei visitatori.
Soluzione:
- Assicurati che il proxy includa l'header
x-flowsery-real-ipcon l'indirizzo IP reale del visitatore (non quello del server) quando inoltra le richieste all'endpoint/eventsdi Flowsery Analytics - Se PHP si trova dietro un altro proxy (Cloudflare, Vercel e così via),
$_SERVER['REMOTE_ADDR']sarà il proxy a monte: leggi invece direttamente$_SERVER['HTTP_CF_CONNECTING_IP']o$_SERVER['HTTP_X_REAL_IP']