Visão geral das análises
É fácil criar um painel de documentação impressionante e difícil torná-lo útil. A diferença está em saber se cada número declara o que não consegue ver. Esta página passa pelo painel bloco a bloco e aba a aba e, para cada um, informa o que conta, de onde vem e qual interpretação ele não permite. As definições subjacentes a tudo isso — quem conta como visitante, como os bots e a sua própria equipe são excluídos, por quanto tempo os dados são mantidos — estão em como a medição funciona e não são repetidas aqui.
O que você obtém#
Uma página que responde às perguntas que um proprietário realmente tem, a partir de uma única fonte. Seis dos sete blocos de destaque são propriedades de uma visita, e os seis são derivados do mesmo fluxo de eventos reconstruído, em vez de seis contadores independentes — portanto, a taxa de rejeição aqui e a taxa de rejeição na divisão de resultados são o mesmo cálculo, não dois números com um único nome. Ler qualquer parte disso não custa nada do saldo do seu projeto, e nada disso é restrito pelo plano.
Como é construído#
Os sete blocos#
| Bloco | Definição | Pode ser exibido em gráfico |
|---|---|---|
| Visitantes | Visitantes distintos com pelo menos uma visita humana no período, divididos entre novos / recorrentes | sim |
| Receita | Conversões × seu preço médio de produto | não |
| Gasto | O que saiu do saldo deste projeto — chamadas de IA mais chamadas MCP | sim |
| Taxa de conversão | Conversões ÷ visitantes | sim |
| Receita/visitante | Receita ÷ visitantes | sim |
| Taxa de rejeição | Visitas classificadas como rejeição ÷ visitas | sim |
| Tempo de sessão | Duração média da visita | sim |
Receita é um bloco, mas nunca um gráfico. Ela é o número de conversões multiplicado por uma constante, portanto sua linha seria a linha de conversões com um rótulo de eixo diferente: um fato desenhado duas vezes. Seu formato ao longo do tempo é obtido pela taxa de conversão.
Uma conversão é um clique que sai da sua documentação para o host da URL da sua chamada para
ação. A correspondência é feita pelo host, com www. incluído e os outros subdomínios
deliberadamente não incluídos — sua documentação normalmente fica em um subdomínio, e incluir
esses subdomínios contaria "voltou para a documentação" como uma venda. Um visitante que clica
cinco vezes é uma conversão.
Os dois blocos monetários permanecem desativados até que existam duas configurações: a URL da chamada para ação
define qual clique é uma conversão, e o preço médio do produto define quanto ela vale. Até que
ambos sejam definidos, eles exibem um traço e informam qual está faltando —
nunca $0. Um preço ausente não é um preço igual a zero, e a receita é o valor
sobre o qual um proprietário age sem verificar como ele foi produzido. Ambos ficam em
Marca. Um preço armazenado de 0 é recusado pelo
validador pelo mesmo motivo.
O gasto é a exceção em todos os aspectos. É dinheiro que sai, e não uma
propriedade de uma visita; vem do registro contábil de faturamento, e não do fluxo
de eventos; e é o único valor aqui cujo 0 é uma leitura real. Consequências
que vale a pena conhecer:
- Ele não é compensado. Uma recarga não faz com que diminua; Gasto responde "quanto este projeto me custou", e essa pergunta tem uma única direção.
- Ele ignora seus filtros. Um filtro reduz visitas, e uma execução de tradução não é uma visita — "Estados Unidos" não tem nada a dizer sobre um trabalho de incorporação.
- Ele permanece mesmo em uma janela vazia. Uma execução de tradução às 3h da manhã é uma cobrança real, sem nenhum leitor por trás dela, e isso geralmente é o que há de mais útil para este bloco mostrar. Todos os outros blocos exibem "não há visitas para medir" em uma janela desse tipo.
- Sua seta não tem cor. O aumento do gasto porque os leitores estão solicitando mais significa que o produto está funcionando; o aumento do gasto porque um trabalho está travado significa que há um incêndio. Todas as outras variações são verdes quando representam boas notícias — a taxa de rejeição diminuir é verde — e esta permanece cinza, porque o painel não tem evidências para saber qual dos casos se aplica.
- Um registro contábil ilegível desativa o bloco e informa isso, em vez de mostrar
$0. O que ele contabiliza está em Uso e custo de IA.
Cada bloco também mostra a variação em relação à janela imediatamente anterior de
mesma duração. O crescimento a partir de um valor anterior igual a zero não desenha seta alguma:
ele é indefinido, não +100%.
Os quatro cartões de detalhamento#
Cada cartão é uma faixa rolável de abas; dez das abas são dimensões classificadas extraídas do mesmo fluxo de visitas que os blocos, e quatro vêm de outro lugar.
| Cartão | Abas | Um valor por visita? |
|---|---|---|
| Páginas | Páginas, Títulos, Entrada, Saída | Entrada e Saída sim; Páginas e Títulos não |
| Fontes | Referenciadores, Canais, UTM, Palavra-chave | Referenciadores e Canais sim |
| Público | Dispositivos, Navegadores, Países, Idiomas | sim |
| Conversões | Cliques em CTA, Feedback, Pesquisas | contadas por evento |
Dimensões de valor único particionam a janela — suas contagens de visitantes somam o total. Páginas e Títulos não: a conversão de uma visita é atribuída a todas as páginas que ela acessou, portanto essas linhas representam crédito assistido e deliberadamente somam mais do que o valor principal. O cartão informa isso na tela.
Cada linha em uma aba classificada traz ambos os números — quantos visitantes ela trouxe e quanto eles valeram — com duas barras atrás: uma para aquilo pelo qual a lista é classificada, outra sempre para o dinheiro. As linhas são ordenadas no servidor por visitantes e reordenadas no navegador, porque um servidor que retornasse "as principais linhas por receita" devolveria um conjunto diferente dependendo de um alternador, e as linhas apareceriam e desapareceriam conforme você alternasse.
Páginas e Títulos oferecem duas classificações extras, Views e Reading time.
Elas significam algo para uma linha que nomeia um local na sua documentação e
nada para uma linha que nomeia um país, portanto são oferecidas ali e em nenhum outro lugar. Uma página
sem medições de tempo de leitura exibe um travessão, nunca 0.
Filtragem#
Filtrar por uma linha restringe tudo — os outros cartões e os blocos acima do gráfico — para que um país, um dispositivo ou um referenciador possa ser analisado de ponta a ponta. Os filtros se acumulam e são removidos ao clicar no chip. Os cartões e os blocos aplicam o mesmo predicado às mesmas visitas reconstruídas, o que impede que "Estados Unidos" signifique uma coisa em um cartão e outra no gráfico acima dele.
As abas contabilizadas por evento, em vez de por visita — Títulos, UTM, Visualizações de IA, Cliques em CTA, Feedback e Pesquisas — não podem ser filtradas dessa forma. Elas informam isso acima de suas linhas enquanto um filtro está ativo, em vez de exibir números não filtrados sob um título filtrado.
As quatro abas que não vêm dos seus visitantes#
- Palavra-chave vem do Google Search Console. Uma impressão que nunca se tornou um clique é invisível para qualquer coisa em execução no seu site, portanto estes são os dados do Google: consultas, posição, impressões, cliques e CTR. Conecte o Search Console primeiro. Sua coluna de receita é explicitamente uma estimativa — cliques × sua receita por visitante em todo o site — identificada e exibida como uma só, porque um valor modelado ao lado de valores medidos não deve parecer ser a mesma coisa.
- Cliques em CTA classifica cada destino para o qual os leitores saíram da sua documentação e a partir de qual página.
- Feedback classifica as páginas pelos votos de positivo ou negativo que receberam, com os negativos primeiro: a página em que as pessoas votaram negativamente é a que deve ser reescrita. Os dois widgets de votação são contabilizados juntos — a avaliação no rodapé de uma página e os votos positivos ou negativos em uma resposta de IA fornecida ali — porque a questão é qual página os leitores aprovam, não qual botão pressionaram. Os zeros são sempre exibidos.
- Pesquisas classifica o que os leitores digitaram na caixa de pesquisa da sua página, com a frequência com que encontrou algo e a frequência com que voltou vazia — as mesmas palavras podem ter ambas as contagens. Uma consulta sem resultados é o leitor dizendo, com suas próprias palavras, o que a documentação deveria abordar. Ela não tem menu de métricas: estas linhas são por pesquisa, não por visita, portanto não há receita para classificar.
Canais, e por que uma linha de canal não é suficiente#
A aba Canais agrupa as visitas pelo tipo de origem — pesquisa orgânica, pesquisa
paga, redes sociais, assistente de IA, referência, direta, interna — classificados quando o
evento é registrado, e não quando é lido. Isso é importante por dois motivos: as referências
de IA chegam com um referenciador vazio, portanto agrupá-las apenas pelo referenciador as
oculta em Direta; e um clique pago do Google e um resultado orgânico do Google compartilham
o mesmo referenciador, portanto um utm_medium pago precisa prevalecer sobre ele. Ao
passar o cursor sobre um canal, são nomeados os três sites que realmente o compõem, com
suas participações — uma linha de pesquisa orgânica composta quase inteiramente pelo Google
e outra distribuída entre cinco mecanismos são situações diferentes.
Visões de IA#
Três abas, uma para cada motivo pelo qual um crawler veio, porque as três oferecem suporte a decisões completamente diferentes:
| Aba | O que é | A decisão que apoia |
|---|---|---|
| Respostas | Uma busca ao vivo feita enquanto alguém recebia uma resposta | Sua página foi citada para uma pessoa. Vale um link e um preço atual nela |
| Indexação | Construção do corpus do qual um assistente fará consultas posteriormente | O pré-requisito para algum dia ser citado |
| Treinamento | Coleta em massa para treinamento de modelos | Apenas uma: permitir ou não |
Em cada aba, você pode agrupar por Páginas (quais páginas os assistentes leem) ou por
Crawlers (uma linha por bot, identificada com seu provedor). A classificação é
feita pelo User-Agent com base em uma tabela de 23 bots nomeados; a primeira correspondência vence — portanto,
Applebot-Extended nunca é absorvido por Applebot — e um bot de IA não reconhecido
é tratado como treinamento, a alegação que menos lhe promete.
Intervalos de tempo#
| Intervalo | O que abrange |
|---|---|
| Agora | Uma hora móvel, agrupada por minuto, atualizada em tempo real |
| Hoje | O dia corrido atual em UTC até o momento |
| Ontem | O dia corrido UTC anterior completo |
| Últimas 24 horas | Um dia móvel retrocedendo a partir de agora |
| Últimos 7 dias | Uma semana móvel |
| Últimos 30 dias | Um mês móvel — a janela mais longa disponível |
Hoje e Ontem são dias corridos em UTC, não no seu fuso horário local, e não representam 24 horas móveis: no início do dia UTC, Hoje abrange menos do que Últimas 24 horas. Os dados terminam em trinta dias.
Agora é uma janela própria, e não um dia renomeado — uma visualização em tempo real só é legível com resolução de minutos, e um dia inteiro agrupado por minuto tem 1.440 pontos. Em Agora, os blocos e o gráfico são atualizados a cada 5 segundos, e os cartões a cada 30; mude para qualquer outro intervalo e a atualização será interrompida, portanto um intervalo histórico que você não está acompanhando nunca será atualizado novamente de forma silenciosa.
Online agora — leitores ativos nos últimos 5 minutos — não é um dos sete blocos. É um indicador do momento, e não um total referente à janela escolhida, por isso aparece como um chip próprio ao lado do título do painel; colocá-lo na faixa poderia incentivar a comparação com um período ao qual ele não pertence.
Um relatório para o qual você ainda não tem dados#
Uma aba sem nenhuma de suas próprias linhas é exibida sobre valores de exemplo esmaecidos, com "Ativar aba" sobre eles, e pressioná-la inicia um breve guia sobre esses mesmos valores. Isso é por aba, não por cartão — Entradas contabiliza uma página por visita, enquanto Páginas credita cada página que uma visita acessou, e cada ressalva pertence à aba a que se refere. O botão não controla nada: todos os valores foram coletados durante todo o tempo, e a escolha é lembrada no seu navegador por espaço de trabalho.
Por que esta é a maneira certa#
| Regra | Por que funciona | Fonte |
|---|---|---|
| Meça se a visita foi bem-sucedida, não quantas páginas ela acessou | "se os usuários não conseguirem realizar a tarefa desejada, todo o resto é irrelevante. O sucesso do usuário é o resultado final da usabilidade" — Nielsen & Budiu, 2001, revisado em 2021 | NN/g: Taxa de sucesso |
| Classifique os rastreadores por finalidade, não em uma única categoria de "bots" | Os próprios fornecedores fazem essa distinção: o GPTBot pode "rastrear conteúdo que pode ser usado em treinamento", o OAI-SearchBot existe "para exibir sites nos resultados de pesquisa" e "o ChatGPT-User não é usado para rastrear a web de forma automática" | Bots da OpenAI |
| Um User-Agent é uma declaração, não uma identidade | O Google publica a verificação de rastreadores porque os proprietários estão "preocupados que spammers ou outros causadores de problemas estejam acessando seu site enquanto afirmam ser do Google" | Google Search Central: verificando o Googlebot |
| Os números do Search Console são do Google e provisórios | O Google afirma: "Os dados mais recentes podem ser preliminares, o que significa que ainda estão sendo coletados e podem mudar nas próximas horas", e define impressões como "Quantas vezes seu site apareceu nos resultados da pesquisa" — um número que nenhum rastreador no site consegue ver | Google: relatório de desempenho |
| Um número modelado não deve parecer medido | A receita da aba Keyword é cliques × receita do site por visitante; ela é identificada como (est.) e representada com uma barra tracejada exatamente por esse motivo |
Mecanismo, esta página |
Limites e questões em aberto#
- Todos os números de visitantes são estimativas, e o produto deixa isso claro. Um visitante é um IP com hash: uma rede corporativa se funde em um único leitor, enquanto um passageiro se divide entre vários. Leia-os como uma tendência, nunca como uma contagem de pessoas.
- Percentuais baseados em poucas visitas indicam uma direção, não uma medição. Abaixo de 30 visitas, o painel informa isso abaixo dos números, em vez de apresentar uma taxa com falsa precisão.
- Uma janela muito grande é lida a partir de uma amostra, e isso é reconhecido. A reconstrução da sessão
lê no máximo 50.000 eventos; atingir esse limite define uma
truncatedflag que o cartão descreve por extenso, porque as taxas calculadas com base em uma janela truncada estão erradas. - As variações desaparecem em vez de mentir. Se a leitura da janela anterior falhar, nenhuma variação é exibida. As linhas de Páginas e Títulos atribuem crédito a mais de propósito — elas são crédito assistido; não as some.
- O salto é uma descrição, não um veredito. Uma página, menos de três segundos, nada mais — que também é o que parece um leitor que encontrou a resposta em um único olhar.
- Em questão: "Tempo de sessão" não é atenção. O que é verificável é o mecanismo — segmentos, um limite mínimo de três segundos, um limite de 300 segundos por segmento, calculado como média entre as visitas. O que não é verificável por nenhum dado de análise da web é se uma pessoa estava olhando para a tela, e este painel não dá essa a entender. Consulte tempo de leitura.
- Trinta dias constituem todo o histórico. Nada de comparação anual, nada de sazonalidade, nenhum grupo com mais de quatro semanas.
Como abrir#
Abra qualquer página do seu site de documentação e clique na aba Análises da barra de ferramentas flutuante na parte inferior. A visão geral é carregada com o período que você selecionou da última vez, que é lembrado entre as visitas.
Relacionado#
- Como funciona a medição — identidade do visitante, filtragem de bots e proprietários, retenção, privacidade
- Eventos rastreados — todos os eventos por trás destes números
- Uso de IA e custos — o que o cartão Gastos está contabilizando
- Tempo de leitura — a classificação por tempo de leitura, na íntegra
- Países — as abas Países e Idiomas como um relatório próprio
- Metas e funis — medir um resultado que você declarou em vez de um padrão
- Identidade visual — as duas configurações que ativam a Receita