Suporte/Guias de instalação
Guias de instalação

Configurar o Flowsery Analytics em um projeto Astro

Este guia explica como adicionar o rastreamento do Flowsery Analytics ao seu site Astro.

Inserir o snippet de rastreamento no seu layout

A melhor abordagem para carregar scripts em todas as páginas de um aplicativo Astro é por meio de um componente de layout compartilhado.

  1. Abra (ou crie) seu arquivo de layout principal -- normalmente em src/layouts/Layout.astro.

  2. Coloque a tag de script do Flowsery Analytics dentro do <head>:

JavaScript
---
// src/layouts/Layout.astro
export interface Props {
  title: string;
}
 
const { title } = Astro.props;
---
 
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="description" content="Astro description" />
    <meta name="viewport" content="width=device-width" />
    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
    <title>{title}</title>
    <script
      defer
      data-fl-website-id="flid_******"
      src="https://cdn.flowsery.com/main.js"
    ></script>
  </head>
  <body>
    <slot />
  </body>
</html>

Substitua flid_****** pelo Website ID mostrado nas configurações do Flowsery Analytics.

  • Confirme que todas as páginas do seu projeto usam este layout:

  • HTML
    ---
    // src/pages/index.astro
    import Layout from '../layouts/Layout.astro';
    ---
     
    <Layout title="Welcome to Astro">
      <main>
        <h1>Welcome to Astro</h1>
      </main>
    </Layout>

    Alternativa: gerenciamento de head integrado do Astro

    Você também pode incorporar o script diretamente em qualquer página .astro:

    HTML
    ---
    // Any .astro page
    ---
     
    <html lang="en">
      <head>
        <script defer data-fl-website-id="flid_******" src="https://cdn.flowsery.com/main.js"></script>
      </head>
      <body>
        <!-- Your page content -->
      </body>
    </html>

    Confirmar que tudo está funcionando

    Depois de implementar um dos métodos acima:

    • Faça build e publique seu site Astro
    • Navegue até sua URL em produção
    • Abra seu painel do Flowsery Analytics e procure pageviews recebidos
    • Os primeiros dados podem demorar alguns minutos a aparecer

    Para opções adicionais como rastreamento em localhost, endpoints de API personalizados ou configuração entre domínios, consulte a referência de configuração do script.

    O Flowsery Analytics ignora tráfego de localhost por padrão para não inflar seus números durante o desenvolvimento.