Pomoc/Przewodniki proxy
Przewodniki proxy

Proxy dla Flowsery Analytics w PHP

Kieruj Flowsery Analytics przez swój serwer PHP, aby adblockery nie zakłócały śledzenia, a dane o odwiedzających były dokładniejsze.

1. Utwórz endpointy proxy

Przygotuj dwa pliki PHP obsługujące żądania przechodzące przez 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;

Uwaga: Jeśli twoja aplikacja ma już endpoint /api/track, użyj atrybutu data-api w tagu skryptu Flowsery Analytics, aby kierować zdarzenia na inną ścieżkę. Na przykład data-api="/flowsery-events" przekieruje dane na /flowsery-events.

Ważne: Jeśli w panelu wszyscy odwiedzający mają tę samą lokalizację, sprawdź, czy przy przekazywaniu żądań do endpointu /events Flowsery Analytics nagłówek x-flowsery-real-ip zawiera prawdziwy adres IP odwiedzającego (a nie adres serwera proxy).

2. Skonfiguruj routing serwera WWW

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. 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>

4. Wdróż zmiany

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

Sprawdzenie, czy wszystko działa

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

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

Rozwiązywanie problemów

Wszyscy odwiedzający pochodzą z tej samej lokalizacji

Jeśli wszyscy odwiedzający mają jedną lokalizację (na przykład region twojego serwera), proxy nie przekazuje prawidłowo 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 rzeczywistym adresem IP odwiedzającego (a nie adresem serwera)
  2. Jeśli PHP działa za innym proxy (Cloudflare, Vercel itp.), $_SERVER['REMOTE_ADDR'] będzie adresem tego proxy, dlatego odczytuj bezpośrednio $_SERVER['HTTP_CF_CONNECTING_IP'] lub $_SERVER['HTTP_X_REAL_IP']