Chrome UX Report (CrUX) pour les éditeurs : les Core Web Vitals terrain de tout site populaire
L'essentiel
- Le Chrome UX Report (CrUX) est le jeu de données public de Google sur l'expérience réelle des utilisateurs de Chrome ayant donné leur accord, publié sous licence Creative Commons Attribution 4.0.
- Une page ou une origine n'apparaît dans CrUX que si elle est publiquement détectable et suffisamment populaire ; Google ne divulgue pas le seuil de popularité.
- L'API CrUX renvoie un agrégat glissant sur 28 jours, mis à jour chaque jour vers 04:00 UTC, avec un quota gratuit de 150 requêtes par minute et par projet Google Cloud.
- Le jeu de données BigQuery chrome-ux-report est publié chaque mois, le deuxième mardi du mois suivant, avec des tables de synthèse prêtes à l'emploi comme materialized.device_summary.
- Depuis septembre 2026, CrUX documente des métriques publicitaires expérimentales (nombre d'annonces, densité, CPU et kilo-octets), fournies uniquement pour les sites dont le fichier ads.txt déclare au moins un vendeur autorisé.

Le Chrome UX Report (CrUX) est le jeu de données public et gratuit de Google sur l’expérience réelle des utilisateurs de Chrome sur les sites populaires : Largest Contentful Paint, Interaction to Next Paint, Cumulative Layout Shift et d’autres métriques, au 75e centile. Vous pouvez l’interroger pour votre propre origine ou pour celle d’un concurrent, via une API REST ou BigQuery. Pour un site financé par la publicité, c’est le moyen le plus économique de savoir si les annonces pénalisent les utilisateurs réels.
Qui figure dans CrUX, et qui n’y figure pas ?
La méthodologie CrUX pose deux conditions pour qu’une page ou une origine soit incluse :
- Publiquement détectable. Ce sont les mêmes règles d’indexabilité que pour les moteurs de recherche : un statut différent de 200, un en-tête
X-Robots-Tag: noindexou une balise meta robotsnoindexdisqualifient une page. - Suffisamment populaire. Google ne publie pas le seuil.
Les données proviennent uniquement des utilisateurs de Chrome qui ont activé les statistiques d’utilisation, la synchronisation de l’historique du navigateur et n’ont pas défini de phrase secrète de synchronisation, sur Chrome pour ordinateur (Windows, macOS, ChromeOS, Linux) et Chrome pour Android (y compris les Custom Tabs et les WebAPK). Chrome sur iOS, les applications Android WebView et les autres navigateurs Chromium, comme Microsoft Edge, ne contribuent pas.
Cela compte pour un éditeur : si une grande partie de votre audience vous lit dans le navigateur intégré d’une application sociale (souvent une WebView) ou sur iPhone, CrUX n’en décrit qu’une partie. Votre propre mesure auprès des utilisateurs réels comble l’écart ; voir mesurer les Core Web Vitals avec web-vitals.
La méthodologie précise que les jeux de données CrUX sont sous licence Creative Commons Attribution 4.0 International : vous pouvez donc publier des graphiques construits à partir de ces données, à condition de citer la source.
Comment interroger l’API CrUX ?
L’API CrUX n’expose qu’un point d’accès, records:queryRecord, et exige une clé d’API Google Cloud activée pour la « Chrome UX Report API ».
- Créez une clé (la documentation CrUX renvoie vers
goo.gle/crux-api-key) et restreignez-la à la Chrome UX Report API. - Envoyez une requête POST avec
originouurl, unformFactorfacultatif (DESKTOP,PHONEouTABLET) et une listemetricsfacultative. - Lisez
record.metrics.<metric>.percentiles.p75ainsi que les densités des histogrammes.
curl -s -X POST \
"https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=$CRUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin": "https://www.example.com",
"formFactor": "PHONE",
"metrics": ["largest_contentful_paint",
"interaction_to_next_paint",
"cumulative_layout_shift"]
}'
La réponse a la forme suivante (les valeurs sont illustratives, elles ne proviennent pas d’un appel réel) :
{
"record": {
"key": { "formFactor": "PHONE", "origin": "https://www.example.com" },
"metrics": {
"largest_contentful_paint": { "percentiles": { "p75": 2810 } },
"cumulative_layout_shift": { "percentiles": { "p75": "0.12" } }
},
"collectionPeriod": {
"firstDate": { "year": 2026, "month": 10, "day": 18 },
"lastDate": { "year": 2026, "month": 11, "day": 14 }
}
}
}
Informations d’exploitation tirées de la documentation :
| Élément | Valeur |
|---|---|
| Fenêtre d’agrégation | 28 jours glissants |
| Actualisation | quotidienne, vers 04:00 UTC, au mieux, sans SLA |
| Décalage | environ deux jours par rapport à la date du jour |
| Quota | 150 requêtes par minute et par projet Google Cloud, gratuit, non achetable |
| Absence de données | HTTP 404, message « chrome ux report data not found » |
Suivre les tendances avec l’API History
L’API CrUX History (records:queryHistoryRecord) renvoie des périodes de collecte hebdomadaires : 25 par défaut, jusqu’à 40 avec collectionPeriodCount. Elle est mise à jour chaque lundi vers 04:00 UTC et utilise la même clé. C’est le moyen le plus rapide de vérifier si une modification de mise en page (par exemple l’ajout d’un bloc dans l’article) a fait bouger le CLS au cours des semaines suivantes.
Que sont les nouvelles métriques publicitaires de CrUX ?
L’API liste désormais quatre métriques expérimentales : experimental_ad_count, experimental_ad_density, experimental_ad_cpu (millisecondes) et experimental_ad_kilobytes (Ko). Chacune est fournie au p75 uniquement, et seulement pour les pages incluses dans les métriques publicitaires. Elles sont marquées « n/a » pour BigQuery.
La méthodologie des métriques publicitaires de Chrome, publiée le 15 septembre 2026, en explique les règles :
- Seuls les sites qui déclarent au moins un vendeur autorisé dans
ads.txtsont inclus. Les origines sans ads.txt, ou avec un simple enregistrement de substitution, sont exclues. - Une annonce est comptée si au moins un de ses pixels se trouve dans la zone d’affichage ; les annonces qui se chevauchent comptent chacune.
- La zone d’affichage est échantillonnée une fois par seconde, et la collecte est suspendue lorsque l’onglet est en arrière-plan.
- Les annonces masquées avec
display: nonesont exclues du nombre et de la densité, mais leur coût en CPU et en réseau reste compté. - Les outils de développement de Chrome (DevTools) disposent d’un panneau Ads qui affiche ces métriques en local pour toute page inspectée.
Pour un éditeur AdSense, c’est la première vue publique, fondée sur des données terrain, de la charge publicitaire. Deux usages concrets : comparer votre densité publicitaire à celle des sites de votre thématique avant d’ajouter des blocs, et vérifier que le temps CPU des annonces n’a pas bondi après l’activation d’un nouveau format. Un fichier ads.txt correct est le ticket d’entrée ; voir la syntaxe d’ads.txt.
curl -s -X POST \
"https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=$CRUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"origin": "https://www.example.com", "formFactor": "PHONE",
"metrics": ["experimental_ad_count", "experimental_ad_density"]}'
Si ces champs sont absents de la réponse, CrUX ne dispose d’aucune donnée publicitaire pour cette origine.
Comment utiliser CrUX dans BigQuery ?
La documentation BigQuery de CrUX décrit le projet chrome-ux-report, publié le deuxième mardi du mois suivant :
| Jeu de données / table | Contenu |
|---|---|
all.YYYYMM |
histogrammes mensuels bruts pour chaque origine |
country_CC.YYYYMM |
la même chose, par pays |
materialized.metrics_summary |
une ligne par origine et par mois, avec les valeurs p75 et les proportions bon / à améliorer / mauvais |
materialized.device_summary |
la même chose, ventilée par appareil |
materialized.country_summary |
ventilée par pays et par appareil |
Les tables de synthèse sont petites, ce qui vous maintient dans le palier gratuit de BigQuery. Cette requête est adaptée des exemples officiels du dépôt GoogleChrome/CrUX (sql/mastering-crux/03-device-cwv.sql) :
-- Monthly Core Web Vitals by device for one origin
SELECT
yyyymm,
device,
p75_lcp,
fast_lcp / (fast_lcp + avg_lcp + slow_lcp) AS pct_good_lcp,
p75_inp,
fast_inp / (fast_inp + avg_inp + slow_inp) AS pct_good_inp,
p75_cls,
small_cls / (small_cls + medium_cls + large_cls) AS pct_good_cls
FROM `chrome-ux-report.materialized.device_summary`
WHERE date >= '2025-11-01'
AND origin = 'https://www.example.com'
AND device IN ('desktop', 'phone')
ORDER BY yyyymm DESC, device;
Le commentaire du dépôt indique que metrics_summary est partitionnée par date au format YYYY-MM-01 : c’est donc le filtre sur la date qui limite le volume analysé.
Se comparer aux concurrents
Remplacez l’origine unique par une liste : origin IN ('https://a.example', 'https://b.example'). Placez côte à côte des sites dont l’audience est similaire (même répartition par pays, même part de mobile). Comparer un blog de recettes à un site d’actualité n’apprend pas grand-chose, car le LCP dépend fortement du type de page.
Comment un éditeur doit-il lire ces chiffres ?
- Utilisez le 75e centile. Les seuils utilisés dans la bibliothèque web-vitals sont 2 500 ms / 4 000 ms pour le LCP, 200 ms / 500 ms pour l’INP et 0,1 / 0,25 pour le CLS (limites bon / mauvais).
- Séparez par appareil. Les mises en page publicitaires diffèrent entre mobiles et ordinateurs, et un chiffre global pour l’origine peut masquer un mauvais CLS sur mobile.
- Surveillez la fenêtre. Une correction livrée hier mettra jusqu’à 28 jours à apparaître pleinement dans l’API, et un mois ou plus dans BigQuery.
- CrUX inclut les iframes, pas vos scripts. La documentation de web-vitals note que ses API ne peuvent pas voir à l’intérieur des iframes, alors que CrUX le peut. Les annonces s’affichent dans des iframes : CrUX peut donc signaler des décalages de mise en page que votre propre supervision manque.
Une routine mensuelle simple convient à la plupart des sites financés par la publicité :
- Interrogez l’API pour votre origine avec
formFactorréglé surPHONE, puisDESKTOP, et notez le p75 du LCP, de l’INP et du CLS. - Récupérez la série de l’API History pour la même origine et vérifiez si les dernières périodes de collecte ont bougé après une modification de la mise en page publicitaire.
- Interrogez vos trois modèles de page les plus importants sous forme d’URL individuelles, s’ils ont assez de trafic pour être inclus.
- Consignez les valeurs et la date dans un journal simple, à côté des modifications effectuées. Sans ce journal, une dérive lente est impossible à expliquer par la suite.
Pour les corrections, voir les annonces et les Core Web Vitals et réserver de l’espace pour éviter le CLS.
Erreurs courantes
- Interroger
www.example.comalors que l’origine canonique estexample.com, puis conclure que le site n’a pas de données. - Placer la clé d’API dans du code côté client sur une page publique. Appelez l’API depuis un serveur ou un script.
- Interpréter l’absence de métrique publicitaire comme « pas d’annonces ». Cela signifie « pas de données », souvent parce qu’ads.txt ne contient aucun vendeur autorisé.
- Comparer un score Lighthouse en laboratoire aux valeurs p75 de CrUX. Ils mesurent des choses différentes ; voir Lighthouse CI sur les pages chargées de publicité pour le versant laboratoire.
Outils open source cités
| Outil | Licence |
|---|---|
| CrUX (sample queries and tooling) | Apache-2.0 |
Questions fréquentes
Pourquoi l'API CrUX répond-elle « chrome ux report data not found » pour mon site ?
L'API renvoie une erreur 404 avec ce message lorsqu'elle n'a aucune donnée pour l'origine ou l'URL demandée. Les causes courantes : une origine mal saisie (http au lieu de https, www en trop ou manquant), une page non détectable publiquement (noindex ou statut différent de 200), ou un nombre insuffisant d'utilisateurs Chrome éligibles. Essayez l'origine plutôt que l'URL, avec le nom d'hôte canonique exact.
CrUX est-il identique au rapport Core Web Vitals de la Search Console ?
Les deux reposent sur des données terrain de Chrome, et la documentation de la bibliothèque web-vitals indique qu'elle mesure les métriques comme elles sont transmises à CrUX, PageSpeed Insights et la Search Console. Les outils agrègent toutefois différemment (par page, groupe d'URL ou origine, sur des fenêtres distinctes), si bien que les chiffres coïncident rarement. Utilisez CrUX pour obtenir les valeurs p75 brutes ou les données d'un concurrent.
Puis-je voir la densité publicitaire d'un concurrent dans CrUX ?
Seulement si CrUX fournit des métriques publicitaires pour ce site. La méthodologie des métriques publicitaires de Chrome précise que seuls les sites déclarant au moins un vendeur autorisé dans ads.txt sont inclus, et l'API documente les quatre métriques expérimentales sous forme de valeurs p75 pour les pages incluses. Elles ne figurent pas dans les tables BigQuery. Un champ absent signifie « pas de données », pas « zéro annonce ».
Faut-il payer pour utiliser CrUX ?
L'API est gratuite dans la limite de 150 requêtes par minute et par projet Google Cloud, et ce quota ne peut pas être augmenté contre paiement. Les requêtes BigQuery sont facturées selon le volume d'octets traités après le palier gratuit mensuel : privilégiez les petites tables de synthèse matérialisées et filtrez sur la date et l'origine pour rester dans ce palier.
Sources
- CrUX methodology · Chrome for Developers
- CrUX API · Chrome for Developers
- CrUX History API · Chrome for Developers
- CrUX on BigQuery · Chrome for Developers
- Chrome ad metrics methodology · Chrome for Developers
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.
- 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.
- 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.
- HTTP Archive et Web Almanac : données ouvertes sur les scripts publicitaires, ads.txt et le poids des pages
Mesurez l'adoption d'ads.txt, l'usage de l'ad tech et le poids des scripts tiers sur des millions de sites avec HTTP Archive, le Web Almanac et du SQL adaptable.