Lighthouse et Lighthouse CI sur des pages chargées de publicité : configuration, budgets et mesure de l'impact des tiers
L'essentiel
- Lighthouse est l'outil d'audit en laboratoire open source de Google (Apache-2.0) ; la version 13.6.0 est la version courante sur npm et exige Node 22 ou supérieur.
- Lighthouse CI (@lhci/cli 0.16.1) exécute Lighthouse plusieurs fois par URL, trois par défaut, et peut faire échouer une compilation lorsque des assertions sur les scores, les métriques ou les budgets de ressources ne sont pas respectées.
- Dans Lighthouse 13, le score de performance pondère le Total Blocking Time à 30 %, le Largest Contentful Paint à 25 %, le Cumulative Layout Shift à 25 %, le First Contentful Paint à 10 % et le Speed Index à 10 %.
- Le paramètre blockedUrlPatterns permet de tester la même page avec les requêtes publicitaires bloquées, ce qui isole la part du résultat de laboratoire due au code publicitaire.
- Lighthouse est un test en laboratoire sur un seul appareil simulé ; les données terrain de CrUX ou de votre propre mesure auprès des utilisateurs réels déterminent comment les visiteurs vivent réellement les annonces.

Lighthouse est l’outil d’audit en laboratoire open source de Google, et Lighthouse CI l’exécute automatiquement à chaque compilation avec des budgets de réussite ou d’échec. Sur des pages financées par la publicité, la configuration utile teste chaque page deux fois, une fois normalement et une fois avec les requêtes publicitaires bloquées : vous voyez ainsi quelle part d’un Largest Contentful Paint lent ou d’un Total Blocking Time élevé vient des annonces, et quelle part vient de votre propre code.
Ce que Lighthouse peut et ne peut pas dire sur les annonces
Lighthouse charge une page, dans une instance de Chrome, avec un bridage simulé, et rapporte des métriques de laboratoire. Sur une page publicitaire, cela signifie :
- Il ne voit que le résultat d’une enchère. L’exécution suivante peut recevoir une création plus lourde ou plus légère.
- Il ne voit aucun état de consentement sauf si vous en scénarisez un, et aucune interaction d’utilisateur : l’Interaction to Next Paint ne fait donc pas partie du score.
- Il excelle en attribution. Il liste quels tiers ont transféré combien d’octets et consommé combien de temps sur le fil principal.
Les données terrain répondent à la question « les visiteurs réels en souffrent-ils ? » (voir CrUX pour les éditeurs et les Core Web Vitals auprès des utilisateurs réels). Lighthouse répond à « qu’est-ce qui a changé, et à qui est ce code ? ».
Comment le score de performance est construit dans Lighthouse 13
D’après la configuration par défaut du dépôt Lighthouse :
| Métrique | Poids |
|---|---|
| Total Blocking Time (TBT) | 30 |
| Largest Contentful Paint (LCP) | 25 |
| Cumulative Layout Shift (CLS) | 25 |
| First Contentful Paint (FCP) | 10 |
| Speed Index (SI) | 10 |
| Interaction to Next Paint (INP) | 0 |
Les scripts publicitaires pénalisent surtout le TBT (travail sur le fil principal) et le CLS (emplacements qui grandissent après le chargement). À eux deux, ils représentent 55 % du score.
Installer et lancer Lighthouse en ligne de commande
Le README de Lighthouse indique que l’interface en ligne de commande exige Node 22 (LTS) ou supérieur. La version 13.6.0 était la version courante sur npm lors de la rédaction de ce guide.
npm install -g lighthouse
lighthouse https://www.example.com/article/ \
--only-categories=performance \
--output=json --output-path=./with-ads.json
Mesurer l’impact des annonces : avec et sans
L’option de ligne de commande --blocked-url-patterns bloque les requêtes réseau correspondant à un motif. Lancez la même URL une seconde fois en bloquant les domaines publicitaires de Google :
lighthouse https://www.example.com/article/ \
--only-categories=performance \
--blocked-url-patterns="*googlesyndication.com*" \
--blocked-url-patterns="*doubleclick.net*" \
--output=json --output-path=./no-ads.json
Comparez ensuite les deux rapports :
// compare.mjs (node compare.mjs with-ads.json no-ads.json)
import { readFileSync } from 'node:fs';
const [a, b] = process.argv.slice(2).map((f) => JSON.parse(readFileSync(f, 'utf8')));
const ids = ['largest-contentful-paint', 'total-blocking-time', 'cumulative-layout-shift'];
for (const id of ids) {
console.log(id.padEnd(26), a.audits[id].numericValue.toFixed(2), '->', b.audits[id].numericValue.toFixed(2));
}
console.log('score'.padEnd(26), a.categories.performance.score, '->', b.categories.performance.score);
Ces options et ces identifiants d’audit ont été testés avec Lighthouse 13.6.0 sur une page de test locale. Les requêtes bloquées restent comptées dans les totaux de requêtes du rapport : comparez donc les durées et le temps sur le fil principal plutôt que les totaux de requêtes.
Interprétation :
- Forte baisse du TBT sans annonces : le JavaScript publicitaire domine le temps du fil principal. Moins de blocs au-dessus de la ligne de flottaison ou un chargement différé des emplacements plus bas peuvent aider (voir le chargement différé d’AdSense).
- CLS proche de zéro sans annonces : vos emplacements ne réservent pas d’espace. Corrigez cela en priorité ; c’est entièrement sous votre contrôle (réserver de l’espace pour les annonces).
- LCP presque inchangé : votre problème de LCP vient de vous (image principale, polices, serveur). N’accusez pas les annonces.
Gardez ces comparaisons occasionnelles. Chaque exécution « avec annonces » est un vrai chargement de page qui demande des annonces. Ne cliquez jamais dans un test, et lisez tester ses annonces en toute sécurité avant d’automatiser quoi que ce soit sur des pages monétisées.
Où voir le coût des tiers dans le rapport
Deux parties du rapport de Lighthouse 13 comptent pour les annonces :
- Third parties insight (
third-parties-insight) : un tableau par entité tierce avec la taille transférée et le temps sur le fil principal, avec les URL individuelles en dessous. - Resource summary (
resource-summary, masqué dans le rapport HTML mais présent dans le JSON) : nombre de requêtes et taille transférée par type, avec une lignethird-party.
Les anciens guides évoquent un audit nommé « third-party-summary » ; dans Lighthouse 13, cherchez plutôt le third-parties insight.
Configurer Lighthouse CI
Lighthouse CI collecte plusieurs exécutions, vérifie des budgets et téléverse des rapports. Le guide de démarrage l’installe avec npm install -g @lhci/cli@0.16.x ; @lhci/cli 0.16.1 dépend de Lighthouse 13.6.0.
- Ajoutez un fichier
lighthouserc.jsonà la racine du dépôt. - Lancez
lhci autorunen local pour le vérifier. - Ajoutez la même commande à votre flux d’intégration continue, après l’étape de compilation.
Cette configuration audite un site statique compilé avec les requêtes publicitaires bloquées, de sorte que l’intégration continue ne génère jamais d’impressions publicitaires, et vérifie des budgets sur ce que vous maîtrisez :
{
"ci": {
"collect": {
"staticDistDir": "./dist",
"numberOfRuns": 3,
"settings": {
"onlyCategories": ["performance"],
"blockedUrlPatterns": ["*googlesyndication.com*", "*doubleclick.net*"]
}
},
"assert": {
"assertions": {
"cumulative-layout-shift": ["error", { "maxNumericValue": 0.1 }],
"largest-contentful-paint": ["warn", { "maxNumericValue": 2500 }],
"total-blocking-time": ["warn", { "maxNumericValue": 300 }],
"resource-summary:third-party:count": ["warn", { "maxNumericValue": 30 }],
"resource-summary:third-party:size": ["warn", { "maxNumericValue": 500000 }]
}
},
"upload": { "target": "filesystem", "outputDir": "./lhci-reports" }
}
}
Ce fichier exact a été exécuté avec @lhci/cli 0.16.1 sur une page de test locale : trois exécutions, assertions vérifiées, rapports écrits sur le disque. Les valeurs de budget sont des points de départ, pas des recommandations de Google ; ajustez-les à votre médiane actuelle et durcissez-les avec le temps.
Options principales, d’après la référence de configuration :
| Option | Rôle |
|---|---|
numberOfRuns |
exécutions par URL (3 par défaut) ; une exécution médiane représentative est retenue |
maxNumericValue |
borne supérieure de la valeur numérique d’un audit ; octets pour les tailles de resource-summary dans les assertions LHCI |
minScore |
borne inférieure du score d’un audit ou d’une catégorie |
preset |
lighthouse:recommended, lighthouse:all ou lighthouse:no-pwa |
upload.target |
lhci (votre propre serveur), temporary-public-storage ou filesystem |
Notez que les fichiers budget.json utilisent des kilo-octets alors que les assertions LHCI utilisent des octets, comme le précise la documentation de configuration.
Confidentialité des rapports téléversés
temporary-public-storage place les rapports sur une URL publique pendant quelques jours. Le guide de démarrage le signale expressément. Pour un site en cours de développement, filesystem ou un serveur Lighthouse CI auto-hébergé garde les rapports privés.
Quelles pages et quel appareil tester
Par défaut, staticDistDir fait trouver à Lighthouse CI les fichiers HTML présents sur le disque. Sur un site de contenu, cela peut représenter des centaines de pages, dont la plupart utilisent le même modèle. La référence de configuration décrit un tableau url pour ce cas : lorsqu’il est défini avec staticDistDir, la détection automatique est désactivée et le port de chaque URL est remplacé par celui du serveur local lancé par LHCI, ce qui permet d’écrire des chemins comme ceci :
"collect": {
"staticDistDir": "./dist",
"url": [
"http://localhost/index.html",
"http://localhost/guides/some-article/index.html",
"http://localhost/category/recipes/index.html"
]
}
Choisissez une URL par modèle de page qui porte des annonces : l’accueil, un long article avec des blocs dans le contenu, une page de catégorie ou de liste. L’intégration continue reste ainsi rapide et les régressions faciles à attribuer.
Pour l’appareil, l’interface en ligne de commande de Lighthouse évalue les pages en mode mobile sauf indication contraire. Son aide liste --preset avec les choix perf, experimental et desktop, et recommande --preset=desktop plutôt que --form-factor=desktop pour les exécutions sur ordinateur. Les mises en page publicitaires diffèrent souvent entre mobile et ordinateur (annonces ancrées, colonnes latérales, tailles de blocs différentes) : si vous testez les deux, gardez des rapports séparés et ne les mélangez jamais dans une même comparaison.
Une routine pratique pour les sites financés par la publicité
- En intégration continue, à chaque compilation : annonces bloquées, assertions sur le CLS, votre propre JavaScript et le poids des images.
- Chaque mois ou après un changement de mise en page publicitaire : une comparaison manuelle avec et sans annonces sur trois modèles représentatifs (accueil, article, catégorie), cinq exécutions chacun.
- En continu : les données terrain. Les améliorations en laboratoire ne comptent que si CrUX ou vos données d’utilisateurs réels bougent aussi.
Erreurs courantes
- Optimiser le score plutôt que la page. Un 100 avec les annonces bloquées ne dit rien de ce que reçoivent les lecteurs.
- Lancer Lighthouse CI sur la production avec des annonces actives à chaque push. Cela génère des requêtes publicitaires automatisées sans aucun bénéfice.
- Comparer une exécution sur ordinateur à une exécution sur mobile. Gardez le même preset dans toutes les comparaisons.
- Faire échouer durement les métriques de tiers. Les créations publicitaires changent chaque jour ; utilisez des avertissements.
- Ignorer le décalage de mise en page parce que « c’est la pub ». L’espace occupé par un emplacement publicitaire relève de la responsabilité de votre balisage.
Outils open source cités
| Outil | Licence |
|---|---|
| Lighthouse | Apache-2.0 |
| Lighthouse CI | Apache-2.0 |
Questions fréquentes
Lancer Lighthouse sur mes pages en ligne génère-t-il des impressions AdSense ?
Une exécution de Lighthouse charge la page dans Chrome : sauf si vous bloquez les requêtes publicitaires, le code des annonces s'exécute et demande des annonces comme pour n'importe quel chargement. Limitez les tests sur des pages publicitaires en ligne à quelques exécutions occasionnelles, ne cliquez jamais sur rien, et préférez bloquer les domaines publicitaires ou tester une copie de préproduction sans code publicitaire actif pour l'intégration continue. Les chargements automatisés sont une source classique de trafic non valide : ne planifiez pas d'exécutions automatisées lourdes sur des pages monétisées.
Pourquoi mon score Lighthouse change-t-il à chaque exécution ?
Les enchères publicitaires renvoient à chaque chargement des créations, des tailles et des scripts différents, et les conditions réseau et processeur varient. Lighthouse CI exécute trois tests par URL par défaut et retient une exécution médiane représentative ; l'agrégation par défaut des assertions est optimiste. Passez numberOfRuns à cinq pour les pages publicitaires bruitées et comparez des médianes plutôt que des exécutions isolées.
Pourquoi Lighthouse donne-t-il un poids nul à l'INP ?
Dans la configuration par défaut de Lighthouse 13, l'Interaction to Next Paint figure dans la catégorie performance avec un poids de 0, car une exécution de navigation n'inclut pas d'interactions réelles d'utilisateurs. Le Total Blocking Time, pondéré à 30 %, est le signal de laboratoire le plus lié à la réactivité. Mesurez l'INP auprès d'utilisateurs réels avec la bibliothèque web-vitals ou CrUX.
Faut-il faire échouer la compilation lorsque les scripts tiers grossissent ?
Un avertissement vaut généralement mieux qu'un échec, car les scripts publicitaires changent sans qu'aucun commit ne soit fait de votre côté. Utilisez des assertions de niveau warn sur resource-summary:third-party:count et size pour repérer la dérive, et des assertions de niveau error sur ce que vous maîtrisez, comme le décalage de mise en page des emplacements publicitaires réservés ou le poids de vos propres scripts.
Sources
- Lighthouse README · GoogleChrome on GitHub
- Lighthouse default config (core/config/default-config.js) · GoogleChrome on GitHub
- Lighthouse CI: Getting Started · GoogleChrome on GitHub
- Lighthouse CI: Configuration · GoogleChrome on GitHub
Guides liés
- Mesurer les Core Web Vitals réels des pages publicitaires avec la bibliothèque libre web-vitals
Mesurez LCP, INP et CLS chez de vrais visiteurs avec la bibliothèque libre web-vitals de Google, repérez le bloc pub fautif et stockez vos données.
- 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.
- AdSense et Core Web Vitals : mesurer l'impact réel des annonces sur LCP, INP et CLS
Comment AdSense influe sur LCP, INP et CLS, pourquoi données terrain et RUM divergent avec des iframes publicitaires, et quoi corriger d'abord.
- 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.