ブラウザイベントに関するセマンティック規約

ステータス: Development

この文書では、イベントを発行するブラウザ（Web）計装のためのセマンティック規約を定義します。

WebVital Event

Status:

イベント名は browser.web_vital でなければなりません（MUST）。

このイベントは、Googleが導入したウェブサイトのパフォーマンスメトリクスについて記述します。詳細はweb vitalsを参照してください。

Attributes:

Key	Requirement Level	Value Type	Description	Example Values
`browser.web_vital.delta`	`Required`	double	現在の値と直前に報告された値との差分。deltaを参照。	`0.2`
`browser.web_vital.id`	`Required`	string	この特定のメトリクスインスタンスを表す一意のID。	`v3-1677874579383-6381583661209`
`browser.web_vital.name`	`Required`	string	web vitalの名前。	`cls`
`browser.web_vital.value`	`Required`	double	web vitalの値。	`1.0`
`browser.web_vital.navigation_type`	`Recommended`	string	Navigation Timing APIで報告されるナビゲーションの種別に、web-vitalsライブラリが報告する追加の値を加えたもの。	`navigate`
`browser.web_vital.rating`	`Recommended`	string	そのメトリクスに定義された「good」「needs improvement」「poor」の閾値に対する、web vitalの値の評価。	`good`

browser.web_vital.name には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

Value	Description	Stability
`cls`	Cumulative Layout Shift。clsを参照。
`fcp`	First Contentful Paint。fcpを参照。
`inp`	Interaction to Next Paint。inpを参照。
`lcp`	Largest Contentful Paint。lcpを参照。
`ttfb`	Time to First Byte。ttfbを参照。

browser.web_vital.navigation_type には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

Value	Description	Stability
`back-forward`	ブラウザの履歴移動（戻る/進むボタンなど）によるナビゲーション。
`back-forward-cache`	back/forwardキャッシュ（bfcache）からページを復元するナビゲーション。
`navigate`	リンクのクリック、URLの入力、フォームの送信、またはスクリプト操作によって開始されたナビゲーション。
`prerender`	プリレンダリングされたページへのナビゲーション。
`reload`	リロード操作または `Location.reload()` 呼び出しによるナビゲーション。
`restore`	ブラウザによって以前破棄されたページを復元するナビゲーション。

browser.web_vital.rating には、次のよく知られた値の一覧があります。いずれかが該当する場合、対応する値を使用しなければならず（MUST）、そうでない場合はカスタムの値を使用できます（MAY）。

Value	Description	Stability
`good`	メトリクスの値が「good」の閾値内にあります。
`needs-improvement`	メトリクスの値が「needs improvement」の閾値内にあります。
`poor`	メトリクスの値が「poor」の閾値内にあります。