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.
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.jsbaixado do pacote npmweb-vitalse 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
- 01Hospede o arquivo da biblioteca no tema.
- 02Carregue um módulo inline que registra o onINP com amostragem.
- 03Envie com sendBeacon para o destino escolhido.
- 04Agrupe os dados por página e seletor.
- 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.
- Abra o painel Rede do Chrome, filtro "coletar". Clique em botões e feche a aba; deve aparecer uma requisição POST com 204.
- Force a amostra para 100% em teste (
Math.random() < 1). - Gere uma interação lenta de propósito (um
whilede 300 ms num clique, só em homologação) e confira seprocessamentoregistra o valor. - Calcule o percentil 75 por página: ordene os valores de uma URL e pegue o ponto a três quartos.
- Compare com o relatório do Search Console; as grandezas devem ser da mesma ordem.
Erros comuns e como desfazer
| Erro | Efeito | Correção |
|---|---|---|
| Carregar a biblioteca de CDN sem controle | risco e atraso | hospede o arquivo |
| Contar cada chamada como uma visita | duplicidade | agrupe por id |
| Amostra pequena demais | percentil instável | aumente a taxa ou o período |
| Adiar o script de coleta | perde as primeiras interações | não use atraso nele |
| Endpoint sem validação | log poluído | valide, 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
- Interaction to Next Paint (INP), web.dev (2025-09-02)
- web-vitals (biblioteca), GoogleChrome no GitHub (2026-10-14)
- register_rest_route(), WordPress Developer Resources (2026-10-14)
- 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.