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.
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.
<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.
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.
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, em centavos; 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.
analytics.trackGoal('cadastro')
→ taxa de conversão sobre as visitas
analytics.trackGoal('compra', 4900)
→ com valor, em centavos
analytics.trackEvent('abriu-o-video')
→ só contagem5 · 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, por faixa de latência e pela revisão do protocolo.
$ 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.
Para o agente
O agente lê a documentação inteira.
E a documentação diz, antes, o que o produto não faz.
llms.txt
A documentação inteira, para o agente ler antes
O llms.txt é a documentação inteira: o script, as rotas, o diagnóstico e o que o produto não faz — com uma lista de checagem para agentes. Cole o endereço no Claude Code, Cursor, Codex ou Windsurf e peça a integração; o painel abre o mesmo texto em "Documentação".
Leia https://myoperations.click/products/analytics/llms.txt e instale o Analytics neste site com o instalador. → acha o <head> do projeto → data-spa="auto" se for SPA → mostra a mudança antes de salvar
O que o agente faz, e o que não faz
O agente instala e mede. Os números, você lê no painel.
Com o llms.txt, o agente põe o script, cria metas e eventos e envolve um servidor MCP. Ler os números é no painel e na API de leitura, com a sessão do login: o Analytics não tem servidor MCP para isso. A única chave do produto, a ask_, só grava chamadas de um MCP.
instalar o script sim, pelo llms.txt
criar meta ou evento sim
medir um servidor MCP sim, com a ask_
ler os números painel e API de leitura
(sessão do login)Sendo justo
Reconhecer a pessoa pede um cookie.
A pergunta "como foi?", não.
O analytics completo, com cookie
Onde ele já resolve sozinho
Reconhecer a mesma pessoa dias depois
Ele tem
Tela de visitantes agora, em tempo real
Ele tem
Funil de várias sessões e coorte
Ele tem
Exportar e mandar relatório por e-mail
Ele tem
Fique com ele se
O seu caso depende de reconhecer a pessoa
Para isso ele guarda um identificador no navegador de quem visita — e é essa a troca.
Operations Analytics
A parte que se responde sem guardar nada no navegador: de onde vêm as visitas, que página funciona, que meta foi cumprida — e o seu servidor MCP no mesmo painel.
- Uma linha no <head>, sem cookie
- Visita é visitante distinto no dia
- Recorte por qualquer dimensão, 90 dias
- Metas com taxa de conversão e valor
- Mede também o seu servidor MCP
- Vazio não é zero
A régua
O Que Ele Faz, e o Que Ele Não Faz
Os limites ditos antes de você precisar perguntar. Os que estão em cinza são escolhas de desenho, e cada um tem o porquê ao lado.
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.
FAQ
As Dúvidas, na Ordem Em Que Aparecem
Achou um limite que não está escrito aqui?
Fala direto com quem escreveu o código. Se você encontrou onde quebra, a gente quer publicar isso antes do próximo visitante descobrir sozinho.
Operations · Analytics
Uma linha no <head>, e o tráfego do site aparece.
Sem cookie. Nenhum identificador fica no navegador de quem visita.