跳至內容
API 參考next.config.js 選項網頁重要指標歸因 (webVitalsAttribution)

網頁重要指標歸因 (webVitalsAttribution)

在除錯與 Web Vitals 相關的問題時,如果我們能找出問題的根源通常會很有幫助。例如,在處理累積版面配置偏移 (CLS) 時,我們可能想知道在發生最大單次版面配置偏移時,第一個移動的元素是什麼。或者,在處理最大內容繪製 (LCP) 時,我們可能想要識別頁面中對應於 LCP 的元素。如果 LCP 元素是一個圖片,知道圖片資源的 URL 可以幫助我們找到需要最佳化的資產。

找出對 Web Vitals 分數貢獻最大的因素,也就是 歸因,能讓我們獲得更深入的資訊,例如 PerformanceEventTimingPerformanceNavigationTimingPerformanceResourceTiming 的項目。

在 Next.js 中,歸因預設為停用,但可以透過在 next.config.js 中指定以下內容,針對每個指標啟用。

next.config.js
experimental: {
  webVitalsAttribution: ['CLS', 'LCP']
}

有效的歸因值是所有在 NextWebVitalsMetric 類型中指定的 web-vitals 指標。