BigQuery 中的 CrUX

瞭解 BigQuery 上的 CrUX 資料結構。

簡介

Chrome 體驗報告 (CrUX) 背後的原始資料位於 BigQuery，這是 Google Cloud 上託管的資料庫。

使用者可透過 BigQuery 上的 CrUX 直接查詢 2017 年至今的完整資料集，例如分析趨勢、比較網路技術及評估網域基準。

資料會依每月發布內容分類，並提供多個摘要表格，方便您快速查詢資料。

BigQuery 資料是 CrUX 資訊主頁的基礎，可讓您以視覺化方式呈現資料，不必編寫 SQL 查詢。

存取資料集

使用 BigQuery 需有 Google Cloud 帳戶，並具備 SQL 基礎知識。您可以免費存取並探索 BigQuery 上的 CrUX 資料集，但須遵守 BigQuery 每月更新的免費方案限制。此外，新 Google Cloud 使用者可能符合註冊抵免額資格，可支付超出免費層級的費用。請注意，您必須為 Google Cloud 專案提供信用卡，詳情請參閱「為何需要提供信用卡？」。

如果您是第一次使用 BigQuery，請按照下列步驟設定專案：

  1. 前往 Google Cloud 控制台的「建立專案」頁面。
  2. 為新專案命名，例如「我的 Chrome 使用者體驗報告」，然後按一下「建立」。
  3. 如果系統顯示提示，請提供帳單資訊。
  4. 前往 BigQuery 上的 CrUX 資料集

現在可以開始查詢資料集了。

專案機構

BigQuery 上的 CrUX 資料會在下個月的第二個星期二發布。每個月的資料都會以新資料表的形式發布在 chrome-ux-report.all 下。此外，還有許多具體化資料表，提供每月的摘要統計資料。

詳細的資料表結構定義

各國家/地區的原始資料表和 all 資料集會按年和月提供。

原始資料表

原始資料表具有下列結構定義：

  • origin
  • effective_connection_type
  • form_factor
  • first_paint
  • first_contentful_paint
  • largest_contentful_paint
  • dom_content_loaded
  • onload
  • layout_instability
    • cumulative_layout_shift
  • interaction_to_next_paint
  • round_trip_time
  • navigation_types
    • navigate
    • navigate_cache
    • reload
    • restore
    • back_forward
    • back_forward_cache
    • prerender
  • experimental
    • permission
      • notifications
    • time_to_first_byte
    • popularity

具體化資料表結構定義

系統會提供具體化表格，方便您依據多個重要維度存取摘要資料。系統不會提供直方圖，而是會根據成效評估和第 75 個百分位數值，將成效資料匯總為分數。本範例顯示 metrics_summary 資料表中的一組範例資料列：

yyyymm 起源 fast_lcp avg_lcp slow_lcp p75_lcp
202204 https://example.com 0.9056 0.0635 0.0301 1600
202203 https://example.com 0.9209 0.052 0.0274 1400
202202 https://example.com 0.9169 0.0545 0.0284 1500
202201 https://example.com 0.9072 0.0626 0.0298 1500

這表示在 202204 資料集中，https://example.com 上有 90.56% 的實際使用者體驗符合良好的 LCP 條件，且粗略的第 75 個百分位數 LCP 值為 1,600 毫秒。比前幾個月稍慢。

系統提供四個具體化資料表：

metrics_summary
每月和來源的主要指標
device_summary
按月、來源和裝置類型劃分的關鍵指標
country_summary
依月份、來源、裝置類型和國家/地區劃分的關鍵指標
origin_summary
資料集包含的所有來源清單

metrics_summary

metrics_summary 資料表包含每個來源和每月資料集的摘要統計資料：

yyyymm
資料收集期間的月份
origin
網站來源的網址
rank
粗略熱門度排名 (截至 2021 年 3 月)
[small|medium|large]_cls
依 CLS 門檻劃分的流量比例
[fast|avg|slow]_<metric>
依成效門檻劃分的流量比例
[low|medium|high]_rtt
依 RTT 門檻劃分的流量比例
p75_<metric>
成效指標的第 75 個百分位數值 (毫秒)
notification_permission_[accept|deny|ignore|dismiss]
通知權限行為的分數
[desktop|phone|tablet]Density
依板型規格區分的流量比例
[_4G|_3G|_2G|slow2G|offline]Density
依有效連線類型劃分的流量比例 (自 2025 年 2 月起，根據 rtt 直方圖 計算，不含離線流量)
navigation_type_[navigate|navigate_cache|reload|restore|back_forward|back_forward_cache|prerender]
導覽類型比例

device_summary

device_summary 資料表包含按月、來源、國家/地區和裝置匯總的統計資料。除了 metrics_summary 欄之外，還有：

device
裝置板型規格

country_summary

country_summary 資料表包含按月、來源、國家/地區和裝置匯總的統計資料。除了 metrics_summary 欄之外，還有：

country_code
雙字母國家/地區代碼
device
裝置板型規格

origin_summary

origin_summary 資料表包含 Chrome 使用者體驗報告資料集中的所有來源清單，每月更新資料集中的最新來源清單，且只有一個資料欄：origin。

實驗資料集

實驗性資料集中的資料表是預設 YYYYMM 資料表的精確副本，但會使用更新、更進階的 BigQuery 功能，例如分區和叢集，讓您能以更快速、簡單且經濟實惠的方式編寫查詢。

country

experimental.country 資料集包含 country_CC 資料集的匯總資料，以及資料集日期的額外 yyyymm 欄。結構定義與原始資料表相同，但多了日期和 country_code 欄，因此不必加入月度資料表，即可執行國家/地區層級的比較查詢。

global

experimental.global 資料集包含 all 資料集的匯總資料，以及資料集日期的額外 yyyymm 欄。結構定義與原始資料表相同，但多了日期，因此不必聯結月度資料表，即可執行一段時間內的比較查詢。