Support/Proxyhandleidingen
Proxyhandleidingen

Flowsery Analytics proxyen met Laravel

Stuur Flowsery Analytics via je Laravel-applicatie om adblockers te omzeilen en nauwkeurigere bezoekersdata te verzamelen.

1. Genereer de proxycontroller

Maak een aparte controller voor het afhandelen van proxyverzoeken:

Terminal
php artisan make:controller FlowseryProxyController

2. Schrijf de proxylogica

Voeg het volgende toe aan app/Http/Controllers/FlowseryProxyController.php:

PHP
<?php
 
namespace App\Http\Controllers;
 
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Cache;
 
class FlowseryProxyController extends Controller
{
    public function script()
    {
        // Cache the tracking script for 1 day
        return Cache::remember('flowsery_script', 86400, function () {
            $response = Http::get('https://cdn.flowsery.com/main.js');
            return response($response->body(), 200, [
                'Content-Type' => 'application/javascript',
                'Cache-Control' => 'public, max-age=86400'
            ]);
        });
    }
 
    public function events(Request $request)
    {
        // Determine the origin from the request or build it from the URL
        $origin = $request->header('Origin') ?? $request->getSchemeAndHttpHost();
 
        // Resolve the real visitor IP for accurate geolocation
        $clientIp = $request->header('CF-Connecting-IP')
            ?? $request->header('X-Real-IP')
            ?? $request->header('X-Forwarded-For')
            ?? $request->ip();
 
        if (str_contains($clientIp, ',')) {
            $clientIp = trim(explode(',', $clientIp)[0]);
        }
 
        $headers = [
            'User-Agent' => $request->header('User-Agent'),
            'Content-Type' => 'application/json',
            'Origin' => $origin,
            'x-forwarded-for' => $clientIp,
        ];
 
        if ($clientIp) {
            // CRITICAL: Flowsery reads this as the authoritative visitor IP. Without it, every visitor resolves to your server's region.
            $headers['x-flowsery-real-ip'] = $clientIp;
        }
 
        $response = Http::withHeaders($headers)
            ->post('https://analytics.flowsery.com/analytics/events', $request->all());
 
        return response($response->body(), $response->status());
    }
}

Let op: heeft je applicatie al een /api/track-route, voeg dan data-api toe aan 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.

3. Registreer de routes

Voeg het volgende toe aan routes/web.php:

PHP
Route::get('/js/main.js', [FlowseryProxyController::class, 'script']);
Route::post('/api/track', [FlowseryProxyController::class, 'events']);

4. Pas de scripttag aan

Vervang de oorspronkelijke snippet van Flowsery Analytics door de geproxyde versie:

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

5. Deploy

Zodra je applicatie gedeployed is, 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 of de analyticsverzoeken vanaf je eigen domein komen in plaats van vanaf analytics.flowsery.com

Problemen oplossen

Alle bezoekers komen vanaf dezelfde locatie

Tonen alle bezoekers één 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 het IP-adres van de server) wanneer je verzoeken doorstuurt naar het /events-endpoint van Flowsery Analytics
  2. Staat Laravel achter een andere proxy (Cloudflare, Vercel, enz.), dan is $request->ip() die upstream-proxy; lees in dat geval rechtstreeks $request->header('CF-Connecting-IP') of $request->header('X-Real-IP') uit