Operationsby Ciro Cesar Maciel
Abrir o Analytics

Operations · Analytics

Saiba de onde vem quem visita o seu site.

Uma linha no <head>, e o tráfego do site aparece: visitas, páginas, origens, países, metas e eventos. Sem cookie. Nenhum identificador fica no navegador de quem visita.

Abrir o AnalyticsAbrir o llms.txt

Para o agente: cole o endereço do llms.txt no seu agente, e ele instala. Para entrar no painel, chega um código no seu e-mail.

Por que isso existe

Hoje, ver o próprio tráfego vira
UM PROJETO.

Você só queria saber de onde vêm as visitas e qual página funciona. No caminho aparecem configuração, cookie, relatório que ninguém abre e número que diz zero quando, na verdade, não mediu nada. Aqui a pergunta tem resposta numa tela.

  • O script que pede configuração antes do primeiro número
  • O cookie que fica no navegador de quem visita
  • O zero que esconde um "não foi medido"

O caminho inteiro

Instala, lê, recorta, mede.

Uma linha no começo, e nenhum servidor para montar.

1 · Instalar

Uma linha no <head>, e o tráfego do site aparece.

Cole a linha, ou deixe o instalador colar: ele reconhece projetos Next, Vite, Create React App, Astro e HTML puro, e mostra a mudança antes de salvar. Em Configurações, o site passa de "Aguardando" para "Recebendo" quando a primeira visita chega.

html
<script defer
  src="https://analytics.worker.myoperations.click/tracker.js"
  data-site="<id do site>"
  data-spa="auto"></script>

$ npx @ciromaciel/analytics web init --site <id>
→ mostra a mudança antes de salvar

2 · Ler

Os números que respondem "como foi?"

Visualizações, visitas, rejeição e a mediana do tempo em que a página ficou visível, numa série diária, com a comparação com a janela anterior. Janelas de 7, 30 e 90 dias, e até oito janelas para trás.

painel
janela      7 · 30 · 90 dias
voltar      até 8 janelas

visitas     visitante distinto no dia
rejeição    visualização com menos de 15 s
tempo       mediana do tempo visível

3 · Recortar

Recorte a tela por qualquer coisa.

De onde veio, que página viu, que meta cumpriu. Os filtros se combinam com "e" — página, origem, campanha UTM, país, dispositivo, navegador, sistema, meta ou evento — sobre os registros dos últimos 90 dias.

filtro
origem     = instagram
e página   = /precos
e país     = Brasil

→ a tela inteira passa a contar
  só essas visitas

4 · Metas e eventos

O que importa no site, contado à parte.

Uma meta tem taxa de conversão sobre as visitas e um valor opcional; um evento é só contagem. Os dois aparecem em listas separadas. O assistente "Medir uma ação" transforma uma frase no nome, no código e no pedido para o agente — e acende quando o nome chega.

javascript
analytics.trackGoal('cadastro')
→ taxa de conversão sobre as visitas

analytics.trackEvent('abriu-o-video')
→ só contagem

5 · Servidor MCP

Mede também o seu servidor MCP: cada chamada de tool, com cliente, sessão, latência e erro.

Um site do tipo MCP recebe uma chave de servidor, e o instalador envolve o seu servidor. O relatório mostra chamadas, sessões, taxa de erro e mediana de latência, por tool, por cliente e pela revisão do protocolo.

bash
$ npx @ciromaciel/analytics mcp init --key ask_…
→ envolve o servidor com withAnalytics
→ mostra a mudança antes de salvar

chamadas · sessões · erro · latência
por tool · por cliente · por protocolo

O que fica no navegador

Nada. Nem cookie, nem identificador.

O que o Analytics sabe de quem visita é calculado no servidor e trocado todo dia.

O que isso quer dizer na prática

  • Sem cookie. Nenhum identificador fica no navegador de quem visita. O visitante é um hash calculado no servidor, a partir de um segredo, do dia, do site, do IP e do navegador — e ele muda todo dia.
  • Visita é visitante distinto no dia. Não existe visitante recorrente aqui, e é de propósito: com o hash trocado todo dia, não há como reconhecer a mesma pessoa no dia seguinte.
  • Do Not Track é respeitado. Com data-honor-dnt, quem pediu para não ser medido pelo navegador (Do Not Track ou Global Privacy Control) não entra na conta.
  • Contadores diários, e registros que vencem. Cada visualização soma em contadores diários; os registros por visualização, que servem aos filtros, são apagados depois de 90 dias.

O que isso não é: certificação jurídica. É a descrição técnica do código, e ela não substitui a política de privacidade do seu site.

A régua

O Que Ele Faz, e o Que Ele Não Faz

Os limites ditos antes de você precisar perguntar.

Até onde o recorte volta

90 dias

Os filtros leem registros por visualização que vivem 90 dias; um cron de hora em hora apaga o que passou disso.

Visitante recorrente

Não existe aqui

O hash do visitante muda todo dia, por desenho. Sem ele, não há coorte nem retenção de visitantes.

Tempo real

Não há

Não existe tela de visitantes agora. Os números são diários.

Exportar

Não há CSV nem relatório por e-mail

Os números ficam no painel e na API de leitura, com a sessão do login.

Para o agente

llms.txt, sem MCP de leitura

O agente lê a documentação inteira e instala o script. Ler os números é no painel: o Analytics não tem servidor MCP para isso.

Bloqueador de anúncio

Pode bloquear o script

O script vem do worker do Analytics, sem proxy no seu domínio. E um robô que finge ser navegador é contado; só os que se declaram são descartados.

As Dúvidas, na Ordem Em Que Aparecem

Operations · Analytics

Uma linha no <head>, e o tráfego do site aparece.

Sem cookie. Nenhum identificador fica no navegador de quem visita.