Análises

Comece pela visão geral de auto-hospedagem se você quiser ver antes a arquitetura completa. Esta página foca nas decisões de analítica que você precisa tomar para um deploy auto-hospedado.

Para que o Fluxo usa as análises

Hoje, o Fluxo usa o Tinybird para:

• a analítica da caixa de entrada
• a presença de visitantes ao vivo
• o enriquecimento ao vivo de "visto pela última vez no app" nas telas do painel que dependem do Tinybird

À parte, a documentação e o site de marketing incluem um script do DataFast para a analítica web hospedada.

São duas coisas independentes:

• o Tinybird alimenta a analítica de produto e os recursos de presença ao vivo dentro do app
• o DataFast é um script de analítica de site de terceiros que pode ser desativado separadamente

Chaves de execução

Na auto-hospedagem, todos os interruptores ligados à analítica valem true por padrão:

CopiarTINYBIRD_ENABLED=true
NEXT_PUBLIC_TINYBIRD_ENABLED=true
NEXT_PUBLIC_DATAFAST_ENABLED=true

A leitura do valor é estrita:

• "true" ativa a funcionalidade
• qualquer outro valor a desativa

Caminho com o Tinybird ativado

Se você quer a analítica da caixa de entrada e os painéis de visitantes ao vivo, deixe o Tinybird ativado e aponte o app para a sua instância do Tinybird:

CopiarTINYBIRD_ENABLED=true
NEXT_PUBLIC_TINYBIRD_ENABLED=true
TINYBIRD_HOST=https://your-tinybird.example.com
TINYBIRD_TOKEN=...
TINYBIRD_SIGNING_KEY=...
TINYBIRD_WORKSPACE=...

Se você quer auto-hospedar ou autogerenciar o próprio Tinybird, comece pelos guias oficiais dele:

• Infraestrutura do Tinybird e visão geral da auto-hospedagem
• Guia de instalação autogerenciada do Tinybird

Só instalar o Tinybird não basta. Faça o deploy dos arquivos do projeto Fluxo que estão em tinybird/datasources, tinybird/pipes e tinybird/endpoints; são esses nomes que a API e o painel consultam. A partir do diretório tinybird/ do repositório, valide o contexto da CLI com tb info e faça o deploy do projeto com tb --cloud deploy (ou o equivalente autogerenciado). O fluxo de trabalho local e a lista de endpoints esperados estão documentados em tinybird/README.md.

Verifique se inbox_analytics, unique_visitors, online_now, visitor_presence e presence_locations respondem antes de ativar a interface.

Caminho com o Tinybird desativado

Se manter o Tinybird for complicado no seu ambiente, você pode desativá-lo de forma limpa:

CopiarTINYBIRD_ENABLED=false
NEXT_PUBLIC_TINYBIRD_ENABLED=false

Com o Tinybird desativado:

• a ingestão para o Tinybird para do lado da API
• a geração do JWT ou token do Tinybird para
• a interface de analítica da caixa de entrada fica oculta
• a camada de visitantes ao vivo, os contadores de presença ao vivo e os mapas ao vivo que dependem do Tinybird ficam ocultos

O que continua funcionando:

• os carimbos de tempo lastSeenAt de visitantes e usuários guardados no Postgres continuam sendo atualizados
• os lugares do app que já recorrem ao lastSeenAt do banco de dados continuam mostrando esses carimbos de tempo
• o resto do produto continua funcionando sem o Tinybird

Mantenha TINYBIRD_ENABLED e NEXT_PUBLIC_TINYBIRD_ENABLED alinhados. Se você desativar só a flag do servidor, o navegador pode renderizar telas de analítica que não conseguem receber tokens nem dados. Se desativar só a do navegador, a API pode continuar ingerindo eventos que nenhuma tela do painel exibe.

O que isso não faz:

• não recria a analítica do Tinybird sobre o Postgres
• não mantém visíveis, com dados substitutos, os painéis que só existem graças ao Tinybird

DataFast

O DataFast é tratado como uma dependência opcional de analítica de terceiros para a analítica do site hospedado. A flag vem ativada, então quem auto-hospeda e não escolher explicitamente esse processador deve desativá-la antes do primeiro carregamento de página.

Para desativá-lo ao auto-hospedar:

CopiarNEXT_PUBLIC_DATAFAST_ENABLED=false

Quando desativado, o layout raiz da web simplesmente omite o script do datafa.st.

Padrões recomendados ao auto-hospedar

Se você quer primeiro o caminho de auto-hospedagem mais simples:

1. Decida se você realmente precisa da interface de analítica baseada no Tinybird desde o primeiro dia.
2. Se não, defina TINYBIRD_ENABLED=false e NEXT_PUBLIC_TINYBIRD_ENABLED=false.
3. Desative NEXT_PUBLIC_DATAFAST_ENABLED, a menos que você queira expressamente esse script de terceiros.
4. Traga o Tinybird de volta mais tarde só se você quiser a analítica da caixa de entrada e os painéis de visitantes ao vivo.

Com qualquer uma das duas configurações, teste o endpoint de tokens da API e o painel com as ferramentas de desenvolvedor do navegador abertas: no modo ativado ele deve devolver dados utilizáveis de cada pipe nomeado; no modo desativado não deve aparecer nenhuma requisição ao Tinybird ou DataFast nem interface de analítica.