CrUX (Chrome UX Report) Nedir?
Kısa tanım
CrUX (Chrome User Experience Report), Google'ın uygun koşulları sağlayan Chrome kullanıcılarından anonim olarak topladığı gerçek kullanıcı performans verisinden oluşan herkese açık veri setidir. Core Web Vitals başta olmak üzere metrikleri sayfa (URL) ve site (origin) düzeyinde, 28 günlük pencereler hâlinde sunar. PageSpeed Insights ve Search Console bu veriyi kullanır; doğrudan erişim için CrUX API, History API ve BigQuery bulunur.
Diğer adları: Chrome User Experience Report, Chrome UX Report, CrUX API, CrUX BigQuery, CrUX History API
Veri hangi kullanıcılardan geliyor?
CrUX, Chrome'un tüm kullanıcılarını kapsamaz. Bir kullanıcının ölçümlerinin veri setine girmesi için kullanım istatistiklerini Google'a göndermeyi açmış olması, tarama geçmişini senkronize etmesi ve senkronizasyon parolası belirlememiş olması gerekir. Desteklenen platformlar Windows, macOS, ChromeOS ve Linux'taki masaüstü Chrome ile Android'deki Chrome'dur. iOS'taki Chrome, Android WebView ve Microsoft Edge gibi diğer Chromium tabanlı tarayıcılar veri setine dahil değildir.
Bunun pratik sonucu önemlidir: Safari ve iPhone kullanıcılarının deneyimi CrUX'te hiç görünmez. Ziyaretçilerinin büyük kısmı iOS'ta olan bir site için CrUX yalnızca tablonun bir parçasını gösterir. Tam resmi görmek için kendi gerçek kullanıcı izleme verinizle tamamlamanız gerekir.
Hangi sayfalar ve siteler veri setine girer?
Bir sayfanın ya da origin'in CrUX'te yer alması için iki şart vardır. Birincisi herkese açık olması: sayfa 200 durum koduyla dönmeli ve noindex ile işaretlenmemiş olmalıdır. İkincisi yeterince popüler olması: Google minimum ziyaretçi eşiğini açıklamaz. Eşiği aşmayan sayfalar için veri olmaması, sayfanın yavaş olduğu anlamına gelmez; yalnızca istatistiksel olarak güvenilir bir örneklem oluşmadığını gösterir.
Birkaç teknik ayrıntı yorumlamayı etkiler. URL'lerdeki sorgu parametreleri ve fragment'lar silinir, böylece aynı sayfanın varyasyonları tek kayıtta toplanır. Origin; protokol ve ana makine adının birleşimidir. https://www.alanadi.com ile https://alanadi.com iki ayrı origin'dir. Tersine mühendisliği önlemek için veriye küçük bir rastgelelik de eklenir.
Veriye erişmenin yolları
| Kanal | Kapsam | Güncelleme |
|---|---|---|
| PageSpeed Insights | URL ve origin, son 28 gün | Günlük |
| Search Console Core Web Vitals raporu | Benzer URL grupları | Düzenli |
| CrUX API | URL ve origin, cihaz türüne göre; 28 günlük kayan pencere | Her gün yaklaşık 04:00 UTC |
| CrUX History API | Haftalık 28 günlük dönemler, yaklaşık 10 aya kadar geriye | Her pazartesi |
| BigQuery | Yalnızca origin; ülke kırılımı var; takvim ayı bazında | Aylık, izleyen ayın ikinci salı günü |
| CrUX Vis | Geçmiş verinin görselleştirilmesi | History API ile birlikte |
BigQuery'deki veri takvim ayını, API ise kayan 28 günlük pencereyi kullandığı için iki kaynaktaki sayılar birebir tutmayabilir.
CrUX API ile örnek sorgu
API, Google Cloud'da “Chrome UX Report API” için oluşturulmuş bir anahtar ister ve proje başına dakikada 150 sorguya kadar ücretsizdir:
curl -s -X POST "https://chromeuxreport.googleapis.com/v1/records:queryRecord?key=API_ANAHTARI" -H "Content-Type: application/json" -d '{"origin": "https://alanadi.com", "formFactor": "PHONE",
"metrics": ["largest_contentful_paint", "interaction_to_next_paint"]}'Yanıtta her metrik için iyi, orta ve zayıf aralıklara düşen ziyaret oranlarını içeren bir histogram, percentiles.p75 değeri ve verinin hangi tarih aralığını kapsadığını gösteren collectionPeriod bulunur. Belirli bir URL için yeterli veri yoksa API 404 döndürür; bu durumda origin sorgusuna geçmek gerekir. Veri yaklaşık iki gün geriden gelir.
Yorumlarken akılda tutulacaklar
- CrUX, Core Web Vitals değerlendirmesinin resmî veri kaynağıdır; Google'ın sayfa deneyimine dair değerlendirmesi laboratuvar puanına değil bu veriye dayanır.
- 28 günlük pencere nedeniyle bir düzeltmenin etkisi tam olarak ancak dört hafta sonra görülür.
- Veri seti yalnızca Chrome'u temsil eder; sitenizin ziyaretçi profiliyle karşılaştırarak okuyun.
- Veri Creative Commons Attribution 4.0 lisansıyla yayımlanır; rakip sitelerin herkese açık origin verisini de sorgulayabilirsiniz.
Uygunluk kurallarının tamamı CrUX metodoloji belgesinde yer alır.