アナリティクス
Next.jsはパフォーマンスメトリクスの測定とレポート作成に組み込みのサポートを提供します。useReportWebVitals
フックを使用して自分でレポーティングを管理するか、あるいは、Vercelがマネージドサービスを提供し、メトリクスを自動的に収集および視覚化します。
独自に構築する
app/_components/web-vitals.js
'use client'
import { useReportWebVitals } from 'next/web-vitals'
export function WebVitals() {
useReportWebVitals((metric) => {
console.log(metric)
})
}
app/layout.js
import { WebVitals } from './_components/web-vitals'
export default function Layout({ children }) {
return (
<html>
<body>
<WebVitals />
{children}
</body>
</html>
)
}
useReportWebVitals
フックは"use client"
ディレクティブを必要とするため、最もパフォーマンスの高いアプローチは、ルートレイアウトがインポートする別のコンポーネントを作成することです。これにより、クライアントの境界がWebVitals
コンポーネントに限定されます。
詳細については、APIリファレンスを参照してください。
Web Vitals
Web Vitalsは、Webページのユーザーエクスペリエンスをキャプチャすることを目的とした有用なメトリクスのセットです。以下のWeb vitalsがすべて含まれています:
- First Byte までの時間(TTFB)
- 最初のコンテンツフルペイント(FCP)
- 最大コンテンツフルペイント(LCP)
- 最初の入力遅延(FID)
- 累積レイアウトシフト(CLS)
- 次のペイントまでのインタラクション(INP)
name
プロパティを使用して、これらのメトリクスのすべての結果を処理できます。
app/_components/web-vitals.tsx
TypeScript
'use client'
import { useReportWebVitals } from 'next/web-vitals'
export function WebVitals() {
useReportWebVitals((metric) => {
switch (metric.name) {
case 'FCP': {
// FCPの結果を処理
}
case 'LCP': {
// LCPの結果を処理
}
// ...
}
})
}
外部システムに結果を送信
サイト上の実際のユーザーパフォーマンスを測定および追跡するために、任意のエンドポイントに結果を送信できます。例:
useReportWebVitals((metric) => {
const body = JSON.stringify(metric)
const url = 'https://example.com/analytics'
// 利用可能な場合は`navigator.sendBeacon()`を使用し、フォールバックとして`fetch()`を使用します。
if (navigator.sendBeacon) {
navigator.sendBeacon(url, body)
} else {
fetch(url, { body, method: 'POST', keepalive: true })
}
})
補足: Google Analyticsを使用する場合、
id
値を使用すると、メトリクス分布を手動で作成できます(パーセンタイルを計算するなど)。useReportWebVitals((metric) => { // この例のようにGoogle Analyticsを初期化した場合は`window.gtag`を使用します: // https://github.com/vercel/next.js/blob/canary/examples/with-google-analytics window.gtag('event', metric.name, { value: Math.round( metric.name === 'CLS' ? metric.value * 1000 : metric.value ), // 値は整数である必要があります event_label: metric.id, // 現在のページロードに固有のID non_interaction: true, // バウンス率に影響しません。 }) })
Google Analyticsに結果を送信についての詳細をお読みください。