Analytics

Analytics integrado em todos os apps publicados no Proyecta. Abra Admin > Analytics no builder para ver tráfego, Web Vitals e distribuição por dispositivos.

Todo app do Proyecta já vem com analytics. Não há nada para instalar, nenhum trecho de código para colar e nenhuma conta em serviços externos necessária. A coleta de dados acontece automaticamente em todos os apps publicados; o painel de analytics no builder está disponível no plano Pro e superiores. Abra Admin > Analytics no builder para visualizar os dados do seu site publicado.

As três visões

O Analytics possui três visões, listadas na barra lateral do admin:

Visão	O que exibe
Overview	Tráfego — visualizações de página, visitantes, sessões, páginas mais acessadas e um gráfico de série temporal diária (referenciadores aparecem na aba Devices)
Web Vitals	Core Web Vitals (LCP, INP, CLS) coletados de usuários reais
Devices	Navegadores e fontes de tráfego (referenciadores)

Quais dados são rastreados?

Os analytics são coletados automaticamente do seu site publicado (seu subdomínio *.proyecta.live ou seu domínio personalizado). O tráfego de preview dentro do builder não é contabilizado.

A janela atual corresponde aos últimos 7 dias. Um seletor de intervalo de datas configurável está no roadmap.

Como acesso o Analytics?

Abra seu projeto no builder, mude para a visão Admin e escolha Analytics na barra lateral. Para visualizá-lo, é necessário um plano Pro ou superior — no plano Free, será exibido um aviso de upgrade. Em um plano pago, a visão Overview carrega por padrão; use a barra lateral para navegar entre Overview, Web Vitals e Devices.

Rastrear eventos personalizados

Além da coleta automática de pageviews e Web Vitals, seu app pode registrar seus próprios eventos personalizados — cadastros, compras, uso de funcionalidades, o que for relevante para você. Os eventos personalizados são atribuídos ao seu app automaticamente.

Seu app já vem com o rastreador configurado, então basta chamar track() de qualquer lugar no seu código React:

import { track } from '@proyecta-ai/analytics';

// Fire from an event handler, an effect, or right after a successful write.
track('signup', { plan: 'pro', referrer: 'newsletter' });

track('add_to_cart', { sku: 'ABC-1' });
track('checkout', { total: 49 });

As propriedades são um objeto simples de strings e números. track() nunca lança erros e não precisa de verificação de nulo — se o analytics ainda não foi inicializado, a chamada é simplesmente descartada, portanto é seguro chamá-lo durante a renderização ou no primeiro paint.

Peça à IA para configurar isso: "Track a 'signup' event whenever a new user registers."

FAQ

Preciso adicionar o Google Analytics ou o Mixpanel?

Não. O analytics já está integrado e é ativado automaticamente em todos os apps publicados. Se você quiser um provedor externo além do nativo, ainda pode pedir à IA para integrá-lo — adicione a chave de API do seu provedor na seção Environment Variables da página Settings e diga "Add Google Analytics to my app".

Preciso de um plano pago?

A coleta de dados acontece em todos os apps publicados, independentemente do plano. A seção Analytics no Admin é um recurso Pro — no plano Free, ela exibe um aviso de upgrade. O rastreamento de eventos personalizados funciona em qualquer plano.

Por que não estou vendo nenhum dado?

O analytics rastreia apenas a versão publicada do seu app. Se você ainda não publicou, ou se seu site publicado não teve tráfego nos últimos 7 dias, o painel estará vazio. O tráfego de preview dentro do builder não é contabilizado. (Verifique também se você está em um plano Pro — o painel em si requer Pro.)

Posso exportar os dados?

Ainda não. A exportação em CSV está no roadmap.

Posso escolher um intervalo de datas diferente?

Ainda não. O painel exibe os últimos 7 dias. Intervalos personalizados estão no roadmap.

Os dados dos visitantes são anonimizados?

O analytics do Proyecta usa um cookie próprio (_pry_vid) para identificar visitantes recorrentes. Ele não rastreia usuários em sites de terceiros. Se você precisa de um banner de consentimento de cookies depende da jurisdição dos seus usuários (por exemplo, o GDPR na União Europeia pode exigir consentimento para identificadores persistentes). Consulte seu assessor jurídico.

Em breve

• Intervalos de datas configuráveis (24h, 30d, personalizado)
• Exportação em CSV
• Rastreamento de conversões e metas