Next.jsアプリケーションにアナリティクスを追加する方法
Next.jsにはパフォーマンスメトリクスの測定と報告のための組み込みサポートがあります。useReportWebVitals
フックを使用して自分でレポートを管理するか、または代わりにVercelが提供するマネージドサービスを利用して、メトリクスの収集と可視化を自動的に行うことができます。
クライアント計装
より高度なアナリティクスとモニタリングのニーズには、Next.jsはinstrumentation-client.js|ts
ファイルを提供しており、これはアプリケーションのフロントエンドコードが実行される前に実行されます。これはグローバルアナリティクス、エラー追跡、またはパフォーマンス監視ツールの設定に最適です。
使用するには、アプリケーションのルートディレクトリにinstrumentation-client.js
またはinstrumentation-client.ts
ファイルを作成します:
// アプリが起動する前にアナリティクスを初期化する
console.log('Analytics initialized')
// グローバルエラー追跡の設定
window.addEventListener('error', (event) => {
// エラー追跡サービスに送信する
reportError(event.error)
})
独自のアナリティクスを構築する
'use client'
import { useReportWebVitals } from 'next/web-vitals'
export function WebVitals() {
useReportWebVitals((metric) => {
console.log(metric)
})
}
import { WebVitals } from './_components/web-vitals'
export default function Layout({ children }) {
return (
<html>
<body>
<WebVitals />
{children}
</body>
</html>
)
}
useReportWebVitals
フックは"use client"
ディレクティブを必要とするため、最もパフォーマンスの高いアプローチは、ルートレイアウトがインポートする別個のコンポーネントを作成することです。これによりクライアント境界がWebVitals
コンポーネントのみに限定されます。
詳細についてはAPIリファレンスをご覧ください。
Webバイタル
Webバイタルは、Webページのユーザー体験を把握するための有用なメトリクスのセットです。以下のWebバイタルがすべて含まれています:
- 初めのバイトまでの時間(TTFB)
- 最初のコンテンツ描画(FCP)
- 最大コンテンツ描画(LCP)
- 最初の入力遅延(FID)
- 累積レイアウトシフト(CLS)
- インタラクションから次の描画までの時間(INP)
これらのメトリクスの結果はすべてname
プロパティを使用して処理できます。
'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に結果を送信するの詳細をご覧ください。