Mesurer les Core Web Vitals réels des pages publicitaires avec la bibliothèque libre web-vitals
L'essentiel
- web-vitals est la bibliothèque JavaScript libre (Apache-2.0) de Google pour mesurer les Core Web Vitals sur de vrais utilisateurs, de la même manière que Chrome les transmet à CrUX, PageSpeed Insights et Search Console.
- La version 6, publiée en juillet 2026, a ajouté le suivi des navigations douces (soft navigations) pour les navigateurs qui les prennent en charge ; la 6.2.3 était la dernière version sur npm en novembre 2026.
- onLCP et onINP fonctionnent dans Chromium, Firefox et Safari, tandis que onCLS n'est pris en charge que par les navigateurs Chromium, selon la documentation de la bibliothèque.
- La version avec attribution ajoute des champs de diagnostic comme largestShiftTarget pour le CLS et interactionTarget pour l'INP, qui montrent si un conteneur publicitaire est en cause.
- La bibliothèque ne voit pas l'intérieur des iframes : les pages dont les annonces sont dans des iframes peuvent donc afficher des valeurs différentes de CrUX, qui inclut le contenu des iframes.

La bibliothèque web-vitals est le paquet JavaScript libre de Google pour mesurer le Largest Contentful Paint (LCP), l’Interaction to Next Paint (INP) et le Cumulative Layout Shift (CLS) chez de vrais visiteurs. Ajoutez-la à vos pages, envoyez chaque métrique vers un point de collecte que vous contrôlez, et vous obtenez des données de terrain pour chaque navigateur et chaque page, et pas seulement pour les origines assez populaires que couvre CrUX. Sa version avec attribution indique quel élément, souvent un bloc publicitaire, a provoqué un décalage ou une interaction lente.
Pourquoi mesurer ses propres données de terrain alors que CrUX existe ?
CrUX est gratuit mais limité : seulement des pages suffisamment populaires et publiquement détectables, seulement des utilisateurs Chrome éligibles, des fenêtres de 28 jours. Votre propre suivi des utilisateurs réels (RUM, real-user monitoring) apporte :
- Chaque gabarit de page, y compris les articles à faible trafic dont la disposition publicitaire diffère.
- Les visiteurs Firefox et Safari pour le LCP et l’INP.
- L’attribution : le sélecteur CSS de l’élément à l’origine de la métrique.
- Un retour immédiat : vous voyez l’effet d’un changement de disposition publicitaire dès le lendemain, et non après 28 jours.
Ce que la bibliothèque mesure, et où
D’après le README, la bibliothèque pèse environ 3 Ko (brotli) et correspond à la manière dont Chrome transmet les métriques à CrUX, PageSpeed Insights et Search Console. Elle mesure les trois Core Web Vitals (CLS, INP, LCP) ainsi que le First Contentful Paint (FCP) et le Time to First Byte (TTFB).
Prise en charge des navigateurs indiquée dans le README :
| Fonction | Navigateurs |
|---|---|
onCLS() |
Chromium |
onINP() |
Chromium, Firefox, Safari |
onLCP() |
Chromium, Firefox, Safari |
onFCP(), onTTFB() |
Chromium, Firefox, Safari |
| Navigations douces | Chromium 151+ |
Les seuils de la bibliothèque sont exportés sous forme de constantes : LCPThresholds vaut [2500, 4000], INPThresholds vaut [200, 500] et CLSThresholds vaut [0.1, 0.25] (bon jusqu’à la première valeur, mauvais à partir de la seconde). Chaque objet de métrique porte aussi une évaluation toute prête, rating, valant good, needs-improvement ou poor.
La version 6 en bref
Le journal des modifications date la v6.0.0 du 21 juillet 2026, avec l’ajout de la prise en charge des navigations douces. Le guide de migration énumère les changements incompatibles : les types sont exportés comme types explicites (utilisez import type), requestIdleCallback est plafonné à une seconde, et dans la version avec attribution, onINP() n’inclut plus les entrées d’événements traités sauf si vous définissez includeProcessedEventEntries: true. La dernière version publiée sur npm en novembre 2026 était la 6.2.3 (5 octobre 2026).
Étape 1 : installer et charger
Avec un outil de compilation :
npm install web-vitals
import { onCLS, onINP, onLCP } from 'web-vitals/attribution';
Sans outil de compilation, hébergez vous-même le fichier compilé du paquet (dist/web-vitals.attribution.iife.js). Le README montre des exemples avec CDN mais précise que unpkg, jsDelivr et cdnjs ne sont pas affiliés à Google et que l’auto-hébergement est préférable pour la sécurité, la fiabilité et les performances. Les exemples CDN du README pointent encore vers web-vitals@5 ; si vous les copiez, épinglez la version majeure que vous avez réellement testée.
Étape 2 : envoyer chaque métrique vers votre point de collecte
Cet extrait utilise la version avec attribution pour que chaque balise porte l’élément à l’origine de la métrique :
import { onCLS, onINP, onLCP } from 'web-vitals/attribution';
function send(metric) {
const a = metric.attribution || {};
const target =
metric.name === 'CLS' ? a.largestShiftTarget :
metric.name === 'INP' ? a.interactionTarget :
metric.name === 'LCP' ? a.target : undefined;
const body = JSON.stringify({
name: metric.name,
value: metric.value,
rating: metric.rating,
id: metric.id,
nav: metric.navigationType,
page: new URL(metric.navigationURL || location.href).pathname,
target,
});
navigator.sendBeacon('/rum', body);
}
onCLS(send);
onINP(send);
onLCP(send);
Remarques tirées du README :
navigator.sendBeacon()est utilisé parce qu’il peut envoyer des données pendant le déchargement de la page.navigationURLdonne l’URL à laquelle la métrique se rapporte, ce qui compte avec les navigations douces ; elle est facultative sur l’objet de métrique, d’où le repli surlocation.href.- Utilisez
idpour regrouper les valeurs d’une même page vue ; après une restauration depuis le cache aller-retour (bfcache), la bibliothèque crée une nouvelle métrique avec un nouvelid. - N’appelez pas
onCLS()et les autres fonctions de façon répétée sur la même page : chaque appel crée des observateurs pour toute la durée de vie de la page.
Étape 3 : stocker et résumer les données
N’importe quel point de collecte qui accepte un POST convient : les événements personnalisés de votre outil d’analyse, une fonction sans serveur ou quelques lignes de Node. Ce récepteur minimal ajoute chaque balise à un fichier :
// rum-server.mjs: append each beacon as one JSON line
import { createServer } from 'node:http';
import { appendFile } from 'node:fs/promises';
createServer(async (req, res) => {
if (req.method === 'POST' && req.url === '/rum') {
let body = '';
for await (const chunk of req) body += chunk;
if (body.length < 5000) {
await appendFile('rum.ndjson', JSON.stringify({ t: Date.now(), ...JSON.parse(body) }) + '\n');
}
res.writeHead(204).end();
} else {
res.writeHead(404).end();
}
}).listen(8787);
Et le 75e centile par métrique :
// summarize.mjs: p75 per metric from rum.ndjson
import { readFileSync } from 'node:fs';
const rows = readFileSync('rum.ndjson', 'utf8').trim().split('\n').map(JSON.parse);
const by = {};
for (const r of rows) (by[r.name] ??= []).push(r.value);
for (const [name, v] of Object.entries(by)) {
v.sort((a, b) => a - b);
const p75 = v[Math.ceil(v.length * 0.75) - 1];
console.log(name, 'n=' + v.length, 'p75=' + p75);
}
Les deux scripts ont été exécutés en local avec une balise de test. En production, placez le récepteur derrière votre serveur web, validez plus strictement les entrées et faites tourner le fichier. Si vous utilisez déjà Matomo, Plausible ou Umami, l’envoi des métriques comme événements personnalisés évite un stockage séparé (voir outils d’analyse open source à côté d’AdSense).
Maîtriser le volume
Sur un site très fréquenté, il n’est pas nécessaire d’envoyer une balise à chaque page vue. Décidez une fois par chargement de page s’il faut remonter les mesures, afin que toutes les métriques d’une même vue soient conservées ou écartées ensemble :
const SAMPLE_RATE = 0.1; // report about 10% of page views
const sampled = Math.random() < SAMPLE_RATE;
if (sampled) {
onCLS(send);
onINP(send);
onLCP(send);
}
Enregistrez le taux d’échantillonnage avec les données si vous le modifiez plus tard, pour que les volumes restent comparables. Les centiles n’ont pas besoin de correction pour l’échantillonnage, mais les totaux, si. Pour les gabarits à faible trafic, augmentez le taux ou remontez tout : un p75 calculé sur quelques dizaines de valeurs par mois n’est pas assez stable pour juger d’un changement de disposition publicitaire.
Comment savoir si les annonces causent mon CLS ?
Regroupez les balises CLS par target et examinez les mauvaises :
- Filtrez les lignes où
namevautCLSetratingvautpoor. - Comptez les valeurs de
target. Des sélecteurs contenantadsbygoogle, la classe de votre conteneur publicitaire, ou l’élément situé juste sous un bloc publicitaire désignent un espace publicitaire non réservé. - Comparez par gabarit de page. Si seules les pages d’articles avec des blocs dans le contenu sont touchées, la correction se trouve dans ce gabarit.
Le largestShiftTarget est l’élément qui a le plus bougé, pas toujours l’annonce elle-même. Un paragraphe repoussé vers le bas par une annonce qui s’est agrandie au-dessus de lui est le cas typique. La correction consiste à réserver la hauteur du bloc en CSS, comme décrit dans éviter le CLS dû aux annonces.
Pour l’INP, un sélecteur qui désigne votre menu ou un bouton signifie que le fil principal était occupé quand le visiteur a interagi. Si cela coïncide avec l’exécution du script publicitaire, la comparaison Lighthouse avec et sans annonces aide à le confirmer en laboratoire.
Limites à garder en tête
- Aucune visibilité dans les iframes. Le README indique que les API sous-jacentes ne voient pas le contenu des
<iframe>, même de même origine, alors que CrUX l’inclut. Les décalages à l’intérieur d’une iframe publicitaire vous sont invisibles. - Le CLS n’existe que dans Chromium. Les visiteurs Safari et Firefox fournissent le LCP et l’INP mais pas le CLS.
- Biais d’échantillonnage. Des balises peuvent se perdre quand des onglets sont tués. N’attendez pas une correspondance de 1 pour 1 avec les pages vues.
- Navigations douces. Les applications monopages demandent la v6 et une version de Chromium qui prend en charge la fonction pour obtenir des métriques par route.
Erreurs fréquentes
- Charger la bibliothèque depuis un CDN public sans version épinglée, puis passer sans le savoir à une version majeure aux changements incompatibles.
- Faire des moyennes. Les Core Web Vitals s’évaluent au 75e centile ; les moyennes masquent la queue de distribution où les annonces font des dégâts.
- Envoyer des URL complètes avec des chaînes de requête pouvant contenir des données personnelles. N’envoyez que le chemin.
- Prendre la cible d’attribution pour une preuve de culpabilité. Elle montre où le symptôme est apparu ; confirmez la cause avant de retirer un bloc publicitaire.
Outils open source cités
| Outil | Licence |
|---|---|
| web-vitals | Apache-2.0 |
Questions fréquentes
La bibliothèque web-vitals ralentit-elle ma page ?
Le README la décrit comme une toute petite bibliothèque d'environ 3 Ko compressés en brotli, la version avec attribution pesant environ 1,5 Ko de plus. Elle s'appuie sur des entrées PerformanceObserver mises en tampon, et n'a donc pas besoin de se charger tôt ; la documentation recommande de la différer jusqu'au chargement du reste du code qui touche l'utilisateur. Appelez chaque fonction onXXX une seule fois par chargement de page pour éviter des observateurs supplémentaires.
Pourquoi mes chiffres web-vitals diffèrent-ils de CrUX ?
CrUX ne couvre que les utilisateurs Chrome éligibles et agrège 28 jours au 75e centile, tandis que vos données couvrent tous les navigateurs mesurés. La bibliothèque ne voit pas non plus l'intérieur des iframes, alors que les annonces s'affichent le plus souvent dans des iframes et que CrUX inclut leur contenu. Comparez les valeurs p75 des seuls visiteurs Chrome avant de conclure qu'une source est erronée.
Peut-on envoyer les données web-vitals à Google Analytics 4 ?
Oui. Le README comprend un exemple gtag qui envoie chaque métrique comme un événement avec metric_id, delta et un debug_target tiré de la version avec attribution. Il précise que Google Analytics n'affiche pas les distributions des métriques dans ses rapports intégrés : il faut les construire avec la Data API ou l'export BigQuery. Héberger soi-même les données est une alternative si vous préférez ne pas passer par là.
Faut-il un consentement pour collecter les Core Web Vitals ?
Cela dépend de ce que vous collectez, de l'endroit où se trouvent vos visiteurs et de la manière dont vous les identifiez. Des mesures de performance envoyées sans cookies ni identifiants diffèrent d'un suivi, mais les règles varient selon les juridictions et ce guide ne constitue pas un avis juridique. Gardez des charges utiles minimales (métrique, valeur, chemin de page, évaluation, sélecteur de la cible) et vérifiez votre dispositif de consentement avec votre CMP et un conseil juridique.
Sources
- web-vitals README · GoogleChrome on GitHub
- web-vitals CHANGELOG · GoogleChrome on GitHub
- Upgrading to v6 · GoogleChrome on GitHub
- web-vitals latest version (npm registry) · npm
Guides liés
- Chrome UX Report (CrUX) pour les éditeurs : les Core Web Vitals terrain de tout site populaire
Obtenez gratuitement les Core Web Vitals terrain de votre site et de vos concurrents avec CrUX : API, SQL BigQuery, métriques publicitaires, absence de données.
- Lighthouse et Lighthouse CI sur des pages chargées de publicité : configuration, budgets et mesure de l'impact des tiers
Lancez Lighthouse et Lighthouse CI sur des pages AdSense : configuration testée, budgets pour les scripts tiers, comparaison avec et sans annonces.
- Comment éviter le décalage de mise en page (CLS) dû aux annonces AdSense en réservant l'espace des emplacements
Empêcher AdSense de décaler la mise en page : réserver l'espace avec min-height ou des tailles CSS fixes, gérer les emplacements vides et les annonces auto.
- Matomo, Plausible et Umami à côté d'AdSense : ce qu'ils mesurent, consentement et licences
Comparez Matomo, Plausible Community Edition et Umami pour un site AdSense : licences, cookies, hébergement, consentement et croisement avec les revenus.