Metas e funis

As visualizações de página não podem dizer se a documentação funcionou. Uma meta é você declarar o que significa “funcionou” para o seu projeto; um funil é você declarar o caminho até ela. Tudo abaixo é então medido em relação a essas declarações, em vez de em relação a um padrão escolhido por outra pessoa.

O que você obtém#

Dê um nome a um resultado — reached_pricing, copied_the_install_snippet, left_for_signup — e o Docsbook informa quantas visitas o concluíram durante o período, com a série diária por trás dele e, (se você declarou quanto vale uma visita), quanto elas valeram. Encadeie vários em uma rota e você obterá um funil passo a passo que identifica a pior transição, não apenas a menor etapa.

Novas metas são comparadas retroativamente com o histórico já registrado, portanto uma meta que você declara hoje informa imediatamente os números da semana passada, em vez de começar do zero.

Os quatro tipos de objetivo#

Tipo	Corresponde a	Use-o para
`page`	Um caminho de página	"Eles chegaram à página de preços"
`event`	Um dos eventos `docs.*` monitorados	"Eles copiaram um bloco de código", "eles perguntaram ao assistente"
`section`	Uma âncora de título rolada até ficar visível, com ou sem o `#`	"Eles chegaram até a parte da página onde estão as etapas de instalação"
`outbound`	Um host de destino para o qual saíram	"Eles foram para seu aplicativo, seu repositório ou o cadastro"

Um objetivo event pode ser restringido a uma página com um escopo opcional, que é o que permite que um único evento seja dois objetivos diferentes — "copiaram o trecho de início rápido" e "copiaram o trecho de autenticação" são o mesmo evento em páginas diferentes.

Como é construído#

Contado por visita, nunca por evento. Uma meta section é acionada sempre que um leitor passa por essa seção; contar eventos registraria uma pessoa como cinco conversões. O valor potencial do funil vai além e conta por pessoa, portanto um leitor que percorreu a rota duas vezes contribui com o valor de um leitor, e não com dois.

A ordem é imposta comparando os horários dos acessos, não pela participação. Para cada etapa, o Docsbook procura o primeiro acesso ocorrido no momento ou após o acesso da etapa anterior. Um leitor que chegou primeiro à etapa 3 e só depois viu a etapa 1 corretamente não é contado como tendo alcançado a etapa 3.

A janela de conversão limita por quanto tempo uma etapa posterior ainda conta. Deixe-a vazia e a própria visita será a janela, que é o padrão honesto para um site de documentação. Defina-a, e ela será limitada ao histórico que realmente existe — uma janela mais longa que a retenção descreve conversões que nunca podem ser observadas.

As taxas são ocultadas quando os dados são insuficientes. A taxa de conversão geral de um funil é ocultada com menos de 30 visitas, e cada etapa recebe a indicação lowSample quando a etapa anterior teve menos de 30 — portanto, uma etapa 2 sólida ainda exibe uma taxa, enquanto uma etapa 5 com poucos dados não. O tempo mediano e o p90 até a conversão são ocultados com menos de 5 conversões, quando a lista de conversores é a resposta e um percentil não é.

leak_index identifica a pior transição, não a menor etapa. A menor etapa quase sempre é a última; a maior queda proporcional entre duas etapas adjacentes é onde a rota realmente falha.

O dinheiro permanece desativado, a menos que você o ative. Um valor de meta de 0 é recusado diretamente — null e 0 são afirmações diferentes, e apenas uma delas pertence a um valor de receita. Quando nenhum valor é declarado, as colunas monetárias ficam em branco em vez de $0.

O que o validador recusa e sobre o que ele apenas avisa#

Estas regras são aplicadas da mesma forma, quer você crie um objetivo no painel, por MCP, ou por meio do assistente — uma única regra, para que nenhuma interface aceite o que outra rejeita.

Regra	Nível	Justificativa fornecida
Um objetivo `event` que nomeia um evento que estes documentos não emitem	Recusado	Ele nunca poderia ser acionado, e um objetivo que nunca é acionado parece exatamente um objetivo com 100% de abandono
Um valor de objetivo igual a `0`	Recusado	`$0` é interpretado como uma medição, em vez de uma declaração ausente
Um funil com menos de 2 etapas	Recusado	Com uma etapa, não há transição a medir — isso é um objetivo
Uma etapa do funil que nomeia um objetivo inexistente	Recusado	Um funil que descarta silenciosamente uma etapa informa uma taxa de conversão melhor do que a real
Mais de 8 etapas	Recusado	Divida-o em dois, para que cada metade tenha um denominador que valha a pena analisar
Mais de 5 etapas	Aviso	Mesmo com 60% por etapa, menos de 8% chega ao final
Uma única página como etapa 1	Aviso	A maioria dos leitores dos documentos chega a páginas mais profundas por meio de uma pesquisa ou de uma resposta de IA; uma entrada restrita exclui a maioria do tráfego antes que qualquer medição seja feita
Um funil que termina em uma rolagem ou visualização de seção	Aviso	Isso mede atenção, não resultado
Um nome de objetivo contendo um caminho, id, `@` ou um número longo	Aviso	É um problema de cardinalidade e também de privacidade — os nomes dos objetivos chegam às exportações e às respostas do chat
Mais de 6 objetivos ativos	Aviso	Depois de seis, a lista deixa de classificar e se torna um registro

Excluir um objetivo o arquiva, em vez de destruí-lo, porque, caso contrário, uma etapa do funil que aponte para um objetivo desaparecido levaria a etapa consigo.

Os relatórios criados com base nisso#

Relatório	O que ele responde
Visão geral das metas	Conclusões por meta durante o período, além da série diária
Funil	Conclusão passo a passo, a proporção do passo anterior que prosseguiu, principais fontes e países em cada passo, e `leak_index`
Jornadas até a meta	Todas as pessoas que concluíram uma meta e quanto tempo levaram desde a primeira visualização até a conversão
Visitantes da meta	Leitores recentes e quais metas cada um concluiu
Resultados das visitas	A divisão entre sucesso / beco sem saída / rejeição / parcial para cada visita, sem nenhuma meta declarada
Funil reverso	Parte de trás para frente, a partir das visitas que terminaram bem: quais páginas de entrada levam ao sucesso e em quantos passos
Retenção	Taxa de retorno na semana 1/semana 4 por coorte semanal

O tempo até a conversão é informado como mediana e p90, nunca como média. O tempo até a conversão em um site de documentação é bimodal — leitores que chegam prontos e leitores que avaliam por semanas — e a média cai no vale vazio entre os dois modos, descrevendo um visitante que não existe.

O funil reverso não precisa de uma hipótese. Um funil declarado só pode medir a rota que você imaginou; trabalhar de trás para frente a partir das visitas bem-sucedidas informa a rota que os leitores realmente encontraram, que muitas vezes é uma rota que ninguém projetou. Quando essa rota é real, a ação é promover seu ponto de entrada na navegação.

O valor potencial é uma parcela de prontidão, não uma previsão. Quando um leitor ainda não converteu, o Docsbook ainda pode classificá-lo: ele cria um perfil de como eram os conversores antes de converterem — tempo de leitura, páginas e, fundamentalmente, as páginas que os conversores abrem mais do que todas as outras pessoas — e atribui uma pontuação a cada leitor com base nesse perfil. Uma página aberta por 80% dos conversores e por 8% de todas as outras pessoas contém a descoberta; uma página aberta por 92% e 90% não contém nenhuma. O perfil só é criado com 5 ou mais conversores e contém no máximo 12 caminhos discriminantes.

Por que esta é a maneira certa#

Regra	Por que funciona	Fonte
Meça a conclusão da tarefa, não o tráfego	"se os usuários não conseguem realizar a tarefa desejada, todo o resto é irrelevante. O sucesso do usuário é o ponto principal da usabilidade" — Nielsen & Budiu, 2001, revisado em 2021	NN/g: Taxa de sucesso
Suprima as taxas com denominadores pequenos	O limite de supressão é o mesmo limite de 30 visitas usado por todas as taxas do produto; ele é aplicado por etapa porque as etapas posteriores de um funil são sempre as mais estreitas	Como funciona a medição
As etapas devem estar ordenadas, não apenas presentes	Um relatório não ordenado sobre "eles acessaram estas páginas" não consegue distinguir uma jornada de três acessos independentes — pelo mesmo motivo que existe a análise de rotas, em vez de uma lista das páginas mais acessadas	Mecanismo, esta página
Conte os resultados por visita, o valor por pessoa	Uma rolagem repetida é a intenção de um leitor expressa duas vezes; somá-la como receita é como um funil inventar dinheiro a partir de uma atualização da página	Mecanismo, esta página

Limites e questões em aberto#

Um visitante é um IP com hash. Cada contagem aqui herda essa característica: a NAT corporativa mescla leitores, e as redes móveis os dividem. Leia cinco linhas de visitantes-alvo para entender quem está avaliando você; não interprete o total como uma contagem de pessoas. Consulte Como a medição funciona.
A origem mostrada em uma jornada é o último toque e atribui crédito excessivo ao Direto. Trate-a como uma indicação, nunca como atribuição.
As coortes de retenção são limitadas pelo histórico de 30 dias. A W4 precisa de uma janela de 30 dias para existir; em um período de 24 horas ou 7 dias, ela é estruturalmente zero e não significa nada. Não há uma visualização ano a ano, nem pode haver uma.
A retenção não tem uma direção universalmente boa. Um retorno alto é saudável para documentação de referência e um fracasso para a integração — o número não pode saber qual seção está descrevendo.
O valor potencial é inferido, não ajustado. Seus pesos não são calibrados com base em uma taxa observada, portanto ele classifica os leitores uns em relação aos outros de forma honesta e nunca deve ser somado a um valor do pipeline.
Um funil mede a rota que você declarou. Se os leitores obtiverem sucesso por um caminho que você não descreveu, o funil relatará uma falha, enquanto o funil reverso relatará a verdade. Leia ambos.

Como funciona a medição — a definição de visita, os filtros de bots e os limites mínimos da amostra que todos os números aqui incorporam
Visão geral da análise — taxa de conversão e receita na faixa de destaque
Referência de eventos rastreados — os nomes de eventos aos quais uma meta event pode corresponder
Referência das ferramentas MCP — create_goal, create_funnel, get_funnel, get_retention e o restante