BigQuery 的 CrUX

瞭解 CrUX 資料在 BigQuery 中的結構方式。

簡介

Chrome 使用者體驗報告 (CrUX) 背後的原始資料可在 BigQuery (託管於 Google Cloud 的資料庫) 上取得。

BigQuery 的 CrUX 可讓使用者直接查詢過去 2017 年的完整資料集，例如分析趨勢、比較網路技術和基準網域。

系統每個月都會發布資料，並加上幾個摘要表格，方便你查詢資料。

BigQuery 資料是 CrUX 資訊主頁的基礎，讓您不需編寫 SQL 查詢，就能以圖表呈現這項資料。

存取資料集

您必須具備 Google Cloud 帳戶和 SQL 的基本知識，才能使用 BigQuery。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
  • first_input
    • delay
  • layout_instability
    • cumulative_layout_shift
  • interaction_to_next_paint
  • 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 $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 $9072 美元 $0.0626 美元 $0.0298 美元 1500

這表示在 202204 年的資料集中，https://example.com 有 90.56% 的使用者體驗符合良好 LCP 的條件，且 LCP 值的第 75 個百分位數為 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>
各成效門檻的流量比例
p75_<metric>
成效指標的第 75 個百分位數值 (毫秒)
notification_permission_[accept|deny|ignore|dismiss]
通知權限行為的比例
[desktop|phone|tablet]Density
依板型規格區分的流量比例
[_4G|_3G|_2G|slow2G|offline]Density
流量比例 (依有效連線類型區分)
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 資料表含有 CrUX 資料集的所有來源清單；系統會每月更新資料集中最新的來源清單，而且只有一個資料欄：origin。

實驗性資料集

實驗資料集中的資料表是預設 YYYYMM 資料表的確切副本，但會使用分區和分群等較新且更進階的 BigQuery 功能，讓您以更快、更簡單、更便宜的方式編寫查詢。

country

experimental.country 資料集包含 country_CC 資料集的匯總資料，其中含有資料集日期的額外 yyyymm 欄。結構定義與原始資料表相同，但加入了日期和 country_code 資料欄，因此不必彙整每月資料表，即可執行一段時間內的查詢情形比較。

global

experimental.global 資料集包含 all 資料集的匯總資料，其中含有資料集日期的額外 yyyymm 欄。結構定義與加入日期的原始資料表相同，方便在不彙整每月資料表的情況下比較一段時間內的查詢。