Ausnahmen messen

Sie können Ausnahmeereignisse senden, um die Anzahl und Art der Abstürze oder Fehler auf einer Webseite zu messen. Auf dieser Seite wird beschrieben, wie Sie mit gtag.js Ausnahmen an Google Analytics senden.

Implementierung

Wenn ein Fehler auftritt, senden Sie ein Ausnahmeereignis an Google Analytics:

gtag('event', 'exception', {<exception_parameters>});

Dabei ist <exception_parameters> ein oder mehrere Parameter/Wert-Paare. Trennen Sie die einzelnen Paare durch Kommas. Dieser Befehl sendet beispielsweise eine Ausnahme für einen nicht schwerwiegenden Fehler.

gtag('event', 'exception', {
  'description': 'error_description',
  'fatal': false   // set to true if the error is fatal
});

Ausnahmeparameter

In der folgenden Tabelle sind die Ausnahmeparameter aufgeführt:

Parametername	Datentyp	Erforderlich	Beschreibung
description	String	Nein	Eine Beschreibung des Fehlers.
fatal	boolean	Nein	true, wenn der Fehler schwerwiegend war.

Beispiel

Unter Berücksichtigung der folgenden Funktion:

function divide(x, y) {
  if (y === 0) {
    throw "Division by zero";
  }
  return x/y;
}

Der folgende Code sendet ein Ausnahmeereignis an Google Analytics, wenn der Divisor y null ist:

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
  });
}