例外のトラッキング

このガイドでは、analytics.js を使用して例外を送信する方法について解説します。例外のトラッキングを使用すると、プロパティで発生した障害やエラーの件数と種類を測定できます。

実装

例外ヒットを送信するには、send コマンドを使用し、hitType として exception を指定します。exception ヒットタイプの場合、send コマンドのシグネチャは次のようになります。

ga('send', 'exception', [fieldsObject]);

例外フィールド

次の表に例外フィールドをまとめます。

フィールド名	値の型	必須	説明
exDescription	テキスト	省略可	例外の説明。
exFatal	boolean	省略可	例外が致命的だった場合 true。

例

次のコマンドでは、失敗する可能性がある一部のロジックを try/catch ブロックでラップしています。エラーが発生した場合は、Google アナリティクスに例外ヒットが送信されます。

try {
  // Runs code that may or may not work.
  window.possiblyUndefinedFunction();
} catch(err) {
  ga('send', 'exception', {
    'exDescription': err.message,
    'exFatal': false
  });
}