Suporte/Guias de proxy
Guias de proxy

Proxy do Flowsery Analytics com Astro

Encaminhe o Flowsery Analytics pela sua aplicação Astro usando middleware para evitar a interferência de bloqueadores de anúncios e capturar dados de visitantes mais precisos.

1. Criar o middleware

Crie um arquivo de middleware em src/middleware.js (ou src/middleware.ts para projetos TypeScript):

JavaScript
// src/middleware.js
export async function onRequest(context, next) {
  const { request } = context;
  const url = new URL(request.url);
 
  // Proxy the Flowsery Analytics tracking script
  if (url.pathname === '/js/main.js') {
    const response = await fetch('https://cdn.flowsery.com/main.js');
    const script = await response.text();
 
    return new Response(script, {
      headers: {
        'Content-Type': 'application/javascript',
        'Cache-Control': 'public, max-age=31536000',
      },
    });
  }
 
  // Proxy the event collection endpoint
  if (url.pathname === '/api/track' && request.method === 'POST') {
    const body = await request.text();
 
    // Resolve the real visitor IP for accurate geolocation
    const clientIp =
      request.headers.get('cf-connecting-ip') || request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || '';
 
    const response = await fetch('https://analytics.flowsery.com/analytics/events', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'User-Agent': request.headers.get('User-Agent') || '',
        Origin: request.headers.get('Origin') || url.origin,
        // Flowsery reads `x-flowsery-real-ip` as the authoritative visitor IP.
        // Without it, every visitor resolves to your server's region because
        // Cloudflare rewrites `cf-connecting-ip` on the proxy hop.
        ...(clientIp && { 'x-flowsery-real-ip': clientIp }),
      },
      body: body,
    });
 
    const responseText = await response.text();
 
    return new Response(responseText, {
      status: response.status,
      headers: {
        'Content-Type': 'application/json',
      },
    });
  }
 
  return next();
}

2. Ativar server-side rendering no Astro

Atualize seu astro.config.mjs para suportar SSR (obrigatório para middleware):

JavaScript
// astro.config.mjs
import { defineConfig } from 'astro/config';
import node from '@astrojs/node';
 
export default defineConfig({
  output: 'server', // or 'hybrid'
  adapter: node({
    mode: 'standalone',
  }),
});

Você também vai precisar do adaptador Node.js: npm install @astrojs/node

3. Alternativa: site estático com rotas de API

Se você preferir manter o site totalmente estático, crie rotas de API em vez de middleware:

Rota proxy do script

Crie src/pages/js/main.js.js:

JavaScript
// src/pages/js/main.js.js
export async function GET() {
  const response = await fetch('https://cdn.flowsery.com/main.js');
  const script = await response.text();
 
  return new Response(script, {
    headers: {
      'Content-Type': 'application/javascript',
      'Cache-Control': 'public, max-age=31536000',
    },
  });
}

Rota proxy dos eventos

Crie src/pages/api/track.js:

JavaScript
// src/pages/api/track.js
export async function POST({ request }) {
  const body = await request.text();
  const url = new URL(request.url);
 
  // Resolve the real visitor IP for accurate geolocation
  const clientIp =
    request.headers.get('x-real-ip') || request.headers.get('x-forwarded-for')?.split(',')[0] || request.headers.get('cf-connecting-ip') || '';
 
  const response = await fetch('https://analytics.flowsery.com/analytics/events', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'User-Agent': request.headers.get('User-Agent') || '',
      Origin: request.headers.get('Origin') || url.origin,
      'x-forwarded-for': clientIp,
    },
    body: body,
  });
 
  const responseText = await response.text();
 
  return new Response(responseText, {
    status: response.status,
    headers: {
      'Content-Type': 'application/json',
    },
  });
}

Observação: se seu projeto já usa uma rota /api/track, adicione data-api à tag de script do Flowsery Analytics para encaminhar os eventos para outro caminho. Por exemplo, data-api="/flowsery-events" envia os dados para /flowsery-events.

Importante: se todos os visitantes aparecerem na mesma localização no seu painel, confirme que x-flowsery-real-ip está definido com o IP real do visitante (e não o IP do servidor proxy) ao encaminhar requisições para o endpoint /events do Flowsery Analytics.

4. Modificar a tag de script

Substitua o snippet original do Flowsery Analytics no seu layout pela versão com proxy:

ASTRO
---
// src/layouts/Layout.astro
const { title } = Astro.props;
---
 
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width" />
    <title>{title}</title>
    <script
      defer
      data-fl-website-id="flid_******"
      src="/js/main.js"
    ></script>
  </head>
  <body>
    <slot />
  </body>
</html>

5. Fazer deploy

Depois do deploy, a configuração de proxy entra em vigor automaticamente. Verifique se seu provedor de hospedagem oferece suporte a:

  • Server-side rendering (para a abordagem com middleware)
  • Rotas de API (para a abordagem do site estático)

Entre os hosts compatíveis com Astro mais comuns estão Vercel, Netlify e Cloudflare Pages.

Confirmar que funciona

Para confirmar que o proxy está funcionando corretamente:

  1. Acesse seu site
  2. Abra as ferramentas de desenvolvedor do navegador e vá para a aba Network
  3. Verifique se as requisições de analytics são servidas pelo seu domínio em vez de analytics.flowsery.com

Observação: a abordagem com middleware exige server-side rendering, enquanto as rotas de API funcionam tanto em sites estáticos quanto em sites renderizados no servidor.

Solução de problemas

Todos os visitantes aparecem da mesma localização

Quando todos os visitantes mostram uma única localização geográfica, como a região do seu servidor, o proxy não está encaminhando corretamente os IPs reais dos visitantes.

Solução:

  1. Garanta que seu proxy defina x-flowsery-real-ip com o IP real do visitante (e não com o IP do servidor) ao encaminhar requisições para o endpoint /events do Flowsery Analytics.
  2. Se sua implementação Astro estiver atrás de outro proxy (Vercel, Cloudflare, Netlify), o IP que você quer normalmente está em cf-connecting-ip, x-vercel-forwarded-for ou x-real-ip. Leia primeiro o cabeçalho que sua edge fornece.