Données ouvertes et outils

Lighthouse et Lighthouse CI sur des pages chargées de publicité : configuration, budgets et mesure de l'impact des tiers

Mis à jour le Publié le Par la rédaction7 min4 sources

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.
Un chronomètre analogique
Image: Analog Stop Watch,Jeremyida002,CC BY-SA 4.0,via Wikimedia Commons.

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 ligne third-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.

  1. Ajoutez un fichier lighthouserc.json à la racine du dépôt.
  2. Lancez lhci autorun en local pour le vérifier.
  3. 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é

  1. En intégration continue, à chaque compilation : annonces bloquées, assertions sur le CLS, votre propre JavaScript et le poids des images.
  2. 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.
  3. 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

OutilLicence
LighthouseApache-2.0
Lighthouse CIApache-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

  1. Lighthouse README · GoogleChrome on GitHub
  2. Lighthouse default config (core/config/default-config.js) · GoogleChrome on GitHub
  3. Lighthouse CI: Getting Started · GoogleChrome on GitHub
  4. Lighthouse CI: Configuration · GoogleChrome on GitHub