Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met PHP

Stuur Flowsery Analytics via je PHP-server, zodat adblockers er niet tussen komen en je nauwkeurigere bezoekersdata verzamelt.

1. De proxy-endpoints aanmaken

Maak twee PHP-bestanden aan die de geproxyde verzoeken afhandelen:

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;

Let op: heeft je applicatie al een /api/track-endpoint, gebruik dan het attribuut data-api op de scripttag van Flowsery Analytics om events naar een ander pad te sturen. Met data-api="/flowsery-events" gaat de data bijvoorbeeld naar /flowsery-events.

Belangrijk: lijkt elke bezoeker in je dashboard op dezelfde locatie te zitten, controleer dan dat de header x-flowsery-real-ip het echte IP-adres van de bezoeker bevat (niet dat van de proxyserver) wanneer verzoeken worden doorgestuurd naar het /events-endpoint van Flowsery Analytics.

2. Routing op de webserver instellen

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. De scripttag aanpassen

Vervang het oorspronkelijke Flowsery Analytics-fragment door de geproxyde versie:

HTML
<script defer data-fl-website-id="flid_******" src="/js/main.js"></script>

4. Deployen

Zodra je de wijzigingen hebt gedeployd, werkt de proxyconfiguratie automatisch.

Controleren of het werkt

Zo controleer je of de proxy goed werkt:

  1. Ga naar je website
  2. Open de ontwikkelaarstools van je browser en ga naar het tabblad Network
  3. Controleer dat de analyticsverzoeken vanaf je eigen domein worden geladen en niet vanaf analytics.flowsery.com

Probleemoplossing

Elke bezoeker lijkt van dezelfde locatie te komen

Tonen alle bezoekers één en dezelfde geografische locatie (bijvoorbeeld de regio van je server), dan stuurt de proxy de echte IP-adressen van bezoekers niet goed door.

Oplossing:

  1. Zorg dat je proxy de header x-flowsery-real-ip meestuurt met het echte IP-adres van de bezoeker (niet dat van de server) wanneer verzoeken worden doorgestuurd naar het /events-endpoint van Flowsery Analytics
  2. Zit PHP achter een andere proxy (Cloudflare, Vercel, enzovoort), dan is $_SERVER['REMOTE_ADDR'] de upstream-proxy; lees in dat geval rechtstreeks $_SERVER['HTTP_CF_CONNECTING_IP'] of $_SERVER['HTTP_X_REAL_IP'] uit