例外を測定すると、ウェブページで発生するクラッシュやエラーの件数と種類を測定できます。このページでは、gtag.js を使用して Google アナリティクスに例外を送信する方法を説明します。
実装
エラーが発生したときに、Google アナリティクスに例外イベントを送信します。
gtag('event', 'exception', {<exception_parameters>});
<exception_parameters> は、パラメータと値のペア(複数可)です。各ペアをカンマで区切ります。たとえばこのコマンドでは、例外として致命的でないエラーが送信されます。
gtag('event', 'exception', {
'description': 'error_description',
'fatal': false // set to true if the error is fatal
});
例外パラメータ
次の表は、例外パラメータの一覧です。
パラメータ名 | データ型 | 必須 | 説明 |
---|---|---|---|
description |
string |
× | エラーの説明。 |
fatal |
boolean |
× | エラーが致命的な場合は true 。 |
例
関数が次の場合:
function divide(x, y) {
if (y === 0) {
throw "Division by zero";
}
return x/y;
}
次のコードは、除数 y
がゼロの場合に exception
イベントを Google アナリティクスに送信します。
var x = document.getElementById('x').value;
var y = document.getElementById('y').value;
try {
var r = divide(x, y);
} catch(err) {
gtag('event', 'exception', {
'description': err,
'fatal': false
});
}