Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy Flowsery Analytics przez Laravel

Kieruj Flowsery Analytics przez aplikację Laravel, aby uniknąć zakłóceń ze strony blokad reklam i zbierać dokładniejsze dane o odwiedzających.

1. Wygeneruj kontroler proxy

Utwórz osobny kontroler do obsługi żądań proxy:

Terminal
php artisan make:controller FlowseryProxyController

2. Zaimplementuj logikę proxy

Dodaj poniższy kod do pliku 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());
    }
}

Uwaga: jeśli twoja aplikacja ma już trasę /api/track, dodaj data-api do tagu skryptu Flowsery Analytics, aby kierować zdarzenia na inną ścieżkę. Na przykład data-api="/flowsery-events" wysyła dane na /flowsery-events.

3. Zarejestruj trasy

Dodaj poniższy kod do pliku routes/web.php:

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

4. Zmień tag skryptu

Zastąp oryginalny fragment kodu Flowsery Analytics wersją korzystającą z proxy:

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

5. Wdróż zmiany

Po wdrożeniu aplikacji konfiguracja proxy zacznie działać automatycznie.

Sprawdź, czy to działa

Aby upewnić się, że proxy działa poprawnie:

  1. Otwórz swoją witrynę
  2. Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
  3. Sprawdź, czy żądania analityczne są obsługiwane przez twoją domenę, a nie przez analytics.flowsery.com

Rozwiązywanie problemów

Wszyscy odwiedzający są z tej samej lokalizacji

Jeśli wszyscy odwiedzający mają jedną lokalizację geograficzną, na przykład region twojego serwera, proxy nie przekazuje poprawnie ich prawdziwych adresów IP.

Rozwiązanie:

  1. Upewnij się, że przy przekazywaniu żądań do endpointu /events Flowsery Analytics proxy dołącza nagłówek x-flowsery-real-ip z prawdziwym adresem IP odwiedzającego, a nie adresem serwera
  2. Jeśli Laravel działa za innym proxy (Cloudflare, Vercel itp.), $request->ip() wskaże to nadrzędne proxy. Odczytuj wtedy bezpośrednio $request->header('CF-Connecting-IP') lub $request->header('X-Real-IP')