本指南說明如何使用 analytics.js 傳送例外狀況。您可以運用例外狀況追蹤,評估資源中發生的當機或錯誤類型,以及這類錯誤的數量。
導入作業
您可以使用 send
指令,並指定 exception
的 hitType 來傳送例外狀況命中。send
指令的 exception
命中類型的簽名如下:
ga('send', 'exception', [fieldsObject]);
例外狀況欄位
下表歸納了例外狀況欄位:
欄位名稱 | 值類型 | 必要 | 說明 |
---|---|---|---|
exDescription |
text | 否 | 例外狀況的說明。 |
exFatal |
boolean |
否 | true 。 |
範例
下列指令會納入 try/catch
區塊中可能會失敗的部分邏輯。如果發生錯誤,系統會傳送例外狀況命中給 Google Analytics (分析):
try {
// Runs code that may or may not work.
window.possiblyUndefinedFunction();
} catch(err) {
ga('send', 'exception', {
'exDescription': err.message,
'exFatal': false
});
}