Chrome UX Report (CrUX)

Что такое CrUX

CrUX (Chrome UX Report) — это официальный датасет Google, который собирает реальные данные о производительности веб-страниц от посетителей, использующих браузер Chrome. В отличие от синтетических тестов (Lighthouse), CrUX показывает, как страница работает в полевых условиях (field data). Эти данные анонимны и агрегированы по 28-дневному периоду.

Какие метрики собирает CrUX

CrUX включает в себя основные метрики производительности, необходимые для оценки качества страницы с точки зрения пользователя:

• LCP (Largest Contentful Paint) — время отрисовки самого крупного элемента контента (норма ≤ 2.5 с).
• INP (Interaction to Next Paint) — задержка на взаимодействия (норма ≤ 200 мс). Пришла на смену FID.
• CLS (Cumulative Layout Shift) — нестабильность макета (норма ≤ 0.1).
• FCP (First Contentful Paint) — время первой отрисовки любого контента (хорошо ≤ 1.8 с).
• TTFB (Time to First Byte) — время ответа сервера (хорошо ≤ 800 мс).

В CrUX метрики представлены в виде распределения:
- «хорошо» (good) — процент пользователей, у которых метрика соответствует норме
- «требует улучшения» (needs improvement)
- «плохо» (poor)

Например: LCP: good: 85%, needs: 10%, poor: 5%

Где используется CrUX

• PageSpeed Insights — вкладка «Полевые данные» (Field Data) берётся из CrUX. Если страница не попадает в датасет, вы увидите только лабораторные данные.
• Google Search Console → отчёт «Основные веб-показатели» (Core Web Vitals) — данные тоже из CrUX, сгруппированы по URL или группам страниц.
• CrUX API — программный доступ к данным для разработчиков (можно запросить метрики для любого сайта с достаточным трафиком).
• BigQuery — публичный датасет CrUX доступен для сложного анализа (требует навыков SQL).

Требования для попадания в CrUX

Чтобы сайт или конкретная страница появились в отчётах CrUX, необходимо соблюдение нескольких условий:

• Достаточное количество пользователей Chrome — требуется минимальный трафик от реальных посетителей (точный порог неизвестен, но обычно несколько сотен уникальных просмотров за 28 дней).
• Публичный сайт — не закрытый авторизацией, не localhost, не staging.
• HTTPS — большинство современных сайтов уже используют, но без HTTPS данные могут не собираться.
• Открытая статистика — пользователи не должны блокировать отправку данных (опция в Chrome по умолчанию включена).

CrUX API

CrUX API позволяет программно получать метрики для любого URL или origin. Это полезно для мониторинга Core Web Vitals в автоматическом режиме.

// Пример запроса к CrUX API (JavaScript)
const response = await fetch('https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=YOUR_API_KEY', {
  method: 'POST',
  body: JSON.stringify({
    origin: 'https://example.com',
    formFactors: ['PHONE', 'DESKTOP']
  })
});
const data = await response.json();
console.log(data.record.metrics);