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:
php artisan make:controller FlowseryProxyController2. Zaimplementuj logikę proxy
Dodaj poniższy kod do pliku app/Http/Controllers/FlowseryProxyController.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:
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:
<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:
- Otwórz swoją witrynę
- Otwórz narzędzia deweloperskie przeglądarki i przejdź na kartę Network
- 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:
- Upewnij się, że przy przekazywaniu żądań do endpointu
/eventsFlowsery Analytics proxy dołącza nagłówekx-flowsery-real-ipz prawdziwym adresem IP odwiedzającego, a nie adresem serwera - 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')