receita

Receita: monitorar INP no campo

Meça a responsividade com usuários reais, com atribuição por elemento, e envie as amostras ao seu GA4 ou ao seu servidor.

resposta curtaInteraction to Next Paint (INP) mede quanto tempo a página leva para mostrar a resposta visual a cliques, toques e teclas. O limite considerado bom é 200 ms no percentil 75 dos acessos reais. Para monitorar em campo, use a biblioteca web-vitals (build de atribuição) e envie cada medição por sendBeacon para o GA4 ou para um endpoint seu, agrupando por página e elemento.
Neste texto

Que problema esta receita resolve?

O laboratório (Lighthouse) não clica em nada; por isso não mede INP. O relatório de Core Web Vitals do Search Console e o CrUX mostram o número agregado, mas não dizem qual botão ou qual script causa a lentidão. Medir no campo, com atribuição, responde: em que página, em qual elemento e em qual fase (espera, processamento ou pintura) o tempo se perde.

A lógica vem de um plugin de monitor de performance on-page (INP) que Camillo Dantas desenvolveu; não é vendido. A receita entrega a técnica e o código.

O que é INP, segundo a fonte oficial

O web.dev descreve o INP como sucessor do First Input Delay. Os limites, aplicados ao percentil 75 das cargas de página registradas em campo e segmentados por celular e desktop: bom até 200 ms, a melhorar entre 200 e 500 ms, ruim acima de 500 ms. A página do web.dev foi publicada em 6 de maio de 2022 e atualizada em 2 de setembro de 2025.

A biblioteca web-vitals (do time do Chrome) expõe, no build de atribuição, os campos interactionTarget (seletor do elemento), inputDelay (do toque até o navegador poder rodar os ouvintes de evento), processingDuration (tempo dos ouvintes) e presentationDelay (do fim dos ouvintes até o próximo quadro visível). Esses três tempos dizem onde agir: delay de entrada alto aponta thread ocupada; processamento alto aponta o seu código; atraso de apresentação alto aponta renderização pesada.

Quando usar e quando não usar

Use quando o relatório de campo acusa INP acima de 200 ms, ou antes disso, para ter linha de base em páginas com muito JavaScript.

Não use:

  • se o site tem tráfego muito baixo: poucas amostras não formam percentil confiável;
  • sem aviso de privacidade compatível com a coleta. As amostras desta receita não carregam dados pessoais, mas o endereço da página e o seletor entram no registro; trate-os conforme a política do site;
  • como substituto do CrUX. Ele é a referência pública; a coleta própria serve para diagnosticar.

Pré-requisitos

  • Arquivo web-vitals.attribution.js baixado do pacote npm web-vitals e hospedado no seu tema. A documentação recomenda hospedar os arquivos por segurança, confiabilidade e desempenho.
  • GA4 já instalado (opção A) ou capacidade de criar um endpoint REST (opção B).
  • Nível: avançado.

Passo a passo

  1. 01Hospede o arquivo da biblioteca no tema.
  2. 02Carregue um módulo inline que registra o onINP com amostragem.
  3. 03Envie com sendBeacon para o destino escolhido.
  4. 04Agrupe os dados por página e seletor.
  5. 05Corrija o gargalo e confirme a queda ao longo das semanas.

O módulo de coleta

<?php
/**
 * Plugin Name: Monitor de INP (receita)
 */

add_action( 'wp_footer', function () {
	$lib = get_stylesheet_directory_uri() . '/js/web-vitals.attribution.js';
	?>
<script type="module">
import { onINP } from "<?php echo esc_url( $lib ); ?>";

// Amostra 20% das visitas para limitar o volume.
if (Math.random() < 0.2) {
  onINP(function (m) {
    var a = m.attribution || {};
    var corpo = JSON.stringify({
      valor: Math.round(m.value),
      nota: m.rating,
      id: m.id,
      pagina: location.pathname,
      alvo: a.interactionTarget || "",
      espera: Math.round(a.inputDelay || 0),
      processamento: Math.round(a.processingDuration || 0),
      apresentacao: Math.round(a.presentationDelay || 0)
    });
    navigator.sendBeacon("<?php echo esc_url( rest_url( 'inp/v1/coletar' ) ); ?>", new Blob([corpo], { type: "application/json" }));
  });
}
</script>
	<?php
}, 30 );

Observações: a documentação da biblioteca avisa que onINP pode chamar o retorno mais de uma vez, então o servidor deve agrupar pelo id. Os campos de atribuição podem vir indefinidos em interações curtas, por isso o código usa valor padrão. O envio por sendBeacon funciona mesmo quando a página está sendo fechada.

Opção A: GA4

Se o GA4 já está na página, troque o sendBeacon por um evento: gtag("event", "inp", { valor: ..., alvo: ..., pagina: ... });. Cadastre alvo e pagina como dimensões personalizadas na propriedade. Não coloque identificadores de medição em código público compartilhado; use o que já está instalado no site.

Opção B: endpoint próprio

add_action( 'rest_api_init', function () {
	register_rest_route( 'inp/v1', '/coletar', array(
		'methods'             => 'POST',
		'permission_callback' => '__return_true', // endpoint público de coleta.
		'callback'            => function ( WP_REST_Request $req ) {
			$d = json_decode( $req->get_body(), true );
			if ( ! is_array( $d ) || strlen( $req->get_body() ) > 1024 ) {
				return new WP_REST_Response( null, 400 );
			}
			$linha = array(
				'v'  => min( 60000, max( 0, (int) ( $d['valor'] ?? 0 ) ) ),
				'n'  => in_array( $d['nota'] ?? '', array( 'good', 'needs-improvement', 'poor' ), true ) ? $d['nota'] : 'x',
				'id' => substr( sanitize_text_field( $d['id'] ?? '' ), 0, 64 ),
				'p'  => substr( sanitize_text_field( $d['pagina'] ?? '' ), 0, 200 ),
				'a'  => substr( sanitize_text_field( $d['alvo'] ?? '' ), 0, 200 ),
				'e'  => (int) ( $d['espera'] ?? 0 ),
				'pr' => (int) ( $d['processamento'] ?? 0 ),
				'ap' => (int) ( $d['apresentacao'] ?? 0 ),
			);
			error_log( 'INP ' . wp_json_encode( $linha ) );
			return new WP_REST_Response( null, 204 );
		},
	) );
} );

Cuidados de segurança: o endpoint é público de propósito, então valida tipo, limita tamanho e trunca textos. Sem limitação de taxa, alguém pode encher seu log; ponha uma regra de limite no servidor (veja a receita de proteção contra scraping e bots). Para análise, extraia do log com grep "INP " debug.log e agrupe por p e a. Em volume maior, grave em tabela própria criada por dbDelta().

Como testar

Critério de sucesso: o beacon chega ao destino (status 204 ou evento no GA4), os campos de atribuição são preenchidos em interações reais e o percentil 75 por página é calculável.

  1. Abra o painel Rede do Chrome, filtro "coletar". Clique em botões e feche a aba; deve aparecer uma requisição POST com 204.
  2. Force a amostra para 100% em teste (Math.random() < 1).
  3. Gere uma interação lenta de propósito (um while de 300 ms num clique, só em homologação) e confira se processamento registra o valor.
  4. Calcule o percentil 75 por página: ordene os valores de uma URL e pegue o ponto a três quartos.
  5. Compare com o relatório do Search Console; as grandezas devem ser da mesma ordem.

Erros comuns e como desfazer

ErroEfeitoCorreção
Carregar a biblioteca de CDN sem controlerisco e atrasohospede o arquivo
Contar cada chamada como uma visitaduplicidadeagrupe por id
Amostra pequena demaispercentil instávelaumente a taxa ou o período
Adiar o script de coletaperde as primeiras interaçõesnão use atraso nele
Endpoint sem validaçãolog poluídovalide, limite tamanho e taxa

Para desfazer, remova o mu-plugin e o arquivo da biblioteca; nada é gravado em tabelas do WordPress.

Checklist final

  • Biblioteca hospedada no tema.
  • Amostragem definida.
  • Destino de dados testado.
  • Dados agrupados por página e elemento.
  • Meta de 200 ms no percentil 75.
  • Revisão após cada correção, com janela de semanas.

Para continuar

O que fazer com o diagnóstico está em adiar scripts e lazy load inteligente. O treino completo de leitura de dados de campo está no mini-curso Core Web Vitals no campo e no curso Core Web Vitals. Definição do termo: INP.

Fontes

  1. Interaction to Next Paint (INP), web.dev (2025-09-02)
  2. web-vitals (biblioteca), GoogleChrome no GitHub (2026-10-14)
  3. register_rest_route(), WordPress Developer Resources (2026-10-14)
  4. Navigator.sendBeacon(), MDN Web Docs (2026-10-14)

Não sabe por onde começar?

Compare as opções e escolha a trilha pelo seu objetivo.