O Histórico do CrUX Usa Janelas Móveis, Não Retratos Semanais
O CrUX History é atualizado semanalmente, mas cada ponto resume 28 dias. Entenda as janelas sobrepostas, os valores p75 e os períodos ausentes antes de diagnosticar uma regressão.
Um gráfico do CrUX History não é uma sequência de medições semanais independentes. Cada ponto resume uma janela móvel de 28 dias; tratar pontos adjacentes como semanas distintas pode fazer uma variação normal parecer uma regressão — ou esconder quando uma mudança realmente chegou aos usuários.
O que cada ponto representa
A Chrome UX Report (CrUX) History API retorna séries temporais de métricas de experiência de usuários reais. Ela é atualizada às segundas-feiras, com dados até o sábado anterior. Cada ponto cobre um período de coleta de 28 dias, e há um período por semana. Portanto, dois pontos adjacentes compartilham 21 dias de observações. Um mês de pontos no gráfico não representa amostras sem sobreposição.
Essa sobreposição afeta a forma como uma versão aparece. Se você publica uma mudança na terça-feira, o próximo ponto ainda inclui três semanas anteriores à publicação e apenas alguns dias posteriores. As experiências anteriores à publicação deixam a janela gradualmente, em vez de desaparecerem na atualização semanal seguinte. Uma curva que melhora devagar pode refletir essa janela, não uma implantação gradual ou uma correção atrasada.
Use as datas de collectionPeriods da API para identificar os intervalos por trás dos valores. Uma data isolada é ambígua: pode parecer uma medição daquele dia, embora o valor resuma quatro semanas. Mantenha as datas de início e fim visíveis nos gráficos internos e nas anotações de incidentes.
Trate p75 como um resumo da distribuição
O CrUX apresenta distribuições, incluindo o 75º percentil (p75): o valor abaixo do qual estão 75% das experiências registradas naquele período. Ele não é a experiência média, o pior caso nem uma pontuação atribuída a uma pessoa específica. A History API também observa que os valores percentis são derivados dos dados subjacentes e podem não corresponder a um valor vivenciado por qualquer usuário.
Não calcule a média dos valores p75 semanais para estimar um p75 mensal. Percentis não podem ser combinados dessa forma: o percentil da população combinada depende das observações subjacentes, não apenas do p75 de cada janela. Da mesma forma, não faça a média do p75 de desktop com o de celular e chame isso de p75 geral do site. Compare dimensões equivalentes ou use a distribuição fornecida pelo sistema de relatórios.
Uma pequena mudança no p75 é um sinal para investigar, não uma prova de regressão estatisticamente significativa. O CrUX não expõe deliberadamente contagens exatas de tráfego, e os pontos se sobrepõem. Observe vários indicadores da distribuição, a magnitude e a persistência da mudança e se ela coincide com uma alteração de código ou infraestrutura. Não invente um intervalo de confiança a partir de um gráfico sem as contagens necessárias para calculá-lo.
Separe a mudança de desempenho da composição do público
Um registro no nível da origem agrega experiências elegíveis de páginas daquela origem; um registro no nível da URL cobre uma página específica. Eles respondem a perguntas diferentes. O p75 de um site pode mudar porque a proporção de tráfego passou a favorecer uma página mais lenta, mesmo que as métricas por página não tenham piorado.
O mesmo vale para dimensões de dispositivo e localização. Uma parcela maior de tráfego de celulares ou uma mudança nos países que contribuem com experiências elegíveis pode alterar a distribuição geral. Ao diagnosticar uma versão, compare a mesma URL ou origem, métrica, tipo de dispositivo e período de coleta. Depois, examine outros segmentos para saber se a mudança agregada é uma regressão ampla ou uma alteração em quem ou no que está representado.
A cobertura também muda no nível do conjunto de dados: a publicação mensal do CrUX de agosto de 2026 listou 18.294.881 origens, 1,3% a mais que no mês anterior. Isso não demonstra que um site específico melhorou; mostra que um agregado entre origens não é um painel fixo.
Dados ausentes não significam aprovação
O CrUX tem critérios de elegibilidade para usuários e páginas. As páginas precisam ser publicamente descobríveis e suficientemente populares; o Google não publica um número mínimo exato de visitantes. O conjunto de dados também pode omitir uma página ou origem quando não há dados elegíveis suficientes para um período específico. Na History API, um período sem dados elegíveis é representado por valores percentis nulos e densidades de histograma NaN.
Portanto, “nenhum resultado no CrUX” não significa “rápido”, “lento” ou “inalterado”. Significa que o conjunto de dados não consegue fornecer um resultado para aquele identificador e período. O CrUX também representa experiências elegíveis do Chrome, não todos os visitantes do seu site. Se você usar monitoramento de usuários reais próprio junto com ele, documente separadamente a população e a janela de agregação; os dois conjuntos são complementares, não intercambiáveis.
Uma rotina mais segura para ler tendências
Em cada comparação, registre o identificador (origem ou URL), a métrica, o tipo de dispositivo e as datas exatas de início e fim. Compare um período com períodos anteriores que usem as mesmas dimensões e lembre-se de que períodos adjacentes compartilham a maior parte das observações. Trate uma oscilação breve como motivo para inspecionar a distribuição e o cronograma de implantação, não como um veredito.
Use dados de campo para responder o que visitantes elegíveis experimentaram e um teste de laboratório controlado para investigar o motivo. Um resultado de laboratório é um teste reproduzível sob condições escolhidas; não substitui a distribuição de campo. Essa distinção importa quando um gráfico é usado na revisão de uma versão: um descreve a população observada, o outro ajuda a isolar uma causa.
Agregados móveis são úteis justamente porque suavizam experiências de campo ruidosas. Leia as datas, distribuições e limites de elegibilidade como parte da métrica — não como notas de rodapé — e o gráfico se torna evidência sobre usuários, não um placar semanal.
Comments
Loading comments…