Analytics

Análises web de origem própria — Vercel Web Analytics, PostHog ou qualquer script personalizado — configuradas a partir do blume.config.ts.

O Blume injeta as análises por si a partir de um único bloco analytics no blume.config.ts. O Vercel Web Analytics e o PostHog são suportados de forma nativa, e uma válvula de escape scripts cobre todos os outros fornecedores — Plausible, Fathom, Google Analytics, Umami e os restantes.

As análises são carregadas apenas em builds de produção. Os scripts são emitidos pelo blume build, nunca pelo blume dev, por isso o tráfego local nunca chega aos seus painéis e não precisa de um projeto de “desenvolvimento” separado.

Vercel Web Analytics

Defina vercel: true para adicionar o Vercel Web Analytics. O Blume injeta o script nativo da Vercel, que é servido a partir do seu próprio domínio assim que o Web Analytics estiver ativado para o projeto no painel da Vercel.

analytics: {
  vercel: true,
}

Não são necessárias chaves — o script reporta para o projeto sob o qual está implementado. Isto só recolhe dados em implementações na Vercel, onde existe o endpoint /_vercel/insights.

PostHog

Forneça a sua chave de API do projeto para adicionar o PostHog. O host assume por predefinição o PostHog Cloud US; defina host para o EU Cloud (https://eu.i.posthog.com) ou para uma instância auto-alojada.

analytics: {
  posthog: {
    key: "phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    host: "https://us.i.posthog.com", // optional, this is the default
  },
}

A chave de API do projeto pode ser enviada para o browser em segurança — é uma chave pública, apenas de escrita.

Scripts personalizados

Use scripts para carregar qualquer outro fornecedor de análises. Cada entrada gera uma etiqueta <script> e tem de definir exatamente um de src (externo) ou content (inline).

analytics: {
  scripts: [
    // Plausible
    {
      src: "https://plausible.io/js/script.js",
      strategy: "defer",
      attributes: { "data-domain": "example.com" },
    },
    // Fathom
    {
      src: "https://cdn.usefathom.com/script.js",
      strategy: "defer",
      attributes: { "data-site": "ABCDEFG" },
    },
    // An inline snippet
    {
      content: "console.log('analytics ready')",
    },
  ],
}

attributes é um mapa de atributos HTML adicionais (data-*, id, …) aplicados à etiqueta, e strategy adiciona async ou defer a scripts externos.

Opções

Os três podem ser combinados — ative a Vercel, o PostHog e scripts personalizados em conjunto. Para implementar o seu site já construído, consulte Implementação.