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

網頁重要指標歸因 (webVitalsAttribution)

在除錯與網頁重要指標相關的問題時,如果我們可以查明問題的來源,通常會有所幫助。例如,在累積版面配置移位 (CLS) 的情況下,我們可能想知道在發生單一最大版面配置移位時,第一個移位的元素。或者,在最大內容繪製 (LCP) 的情況下,我們可能想要識別對應於頁面 LCP 的元素。如果 LCP 元素是圖片,知道圖片資源的 URL 可以幫助我們找到需要最佳化的資產。

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

Next.js 預設會停用歸因功能,但可以透過在 next.config.js 中指定以下設定,**針對個別指標**啟用。

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

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