Assistenza/Guide proxy
Guide proxy

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
<?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
<?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)

APACHE
RewriteEngine On
RewriteRule ^js/script\.js$ script.php [L]
RewriteRule ^api/events$ events.php [L]
Nginx
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:

HTML
<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:

  1. Vai sul tuo sito
  2. Apri gli strumenti per sviluppatori del browser e passa alla scheda Network
  3. 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:

  1. Assicurati che il proxy includa l'header x-flowsery-real-ip con l'indirizzo IP reale del visitatore (non quello del server) quando inoltra le richieste all'endpoint /events di Flowsery Analytics
  2. 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']