سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
موارد استثنا را اندازه گیری کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
می توانید رویدادهای استثنایی را برای اندازه گیری تعداد و نوع خرابی ها یا خطاهایی که در یک صفحه وب رخ می دهد ارسال کنید. در این صفحه نحوه استفاده از gtag.js برای ارسال استثناها به Google Analytics توضیح داده شده است.
پیاده سازی
هنگامی که خطایی رخ می دهد، یک رویداد استثنایی را به Google Analytics ارسال کنید:
gtag('event', 'exception', {<exception_parameters>});
که در آن <exception_parameters>
یک یا چند جفت پارامتر-مقدار است. هر جفت را با کاما از هم جدا کنید. به عنوان مثال، این دستور یک استثنا خطای غیرمرگبار را ارسال می کند.
gtag('event', 'exception', {
'description': 'error_description',
'fatal': false // set to true if the error is fatal
});
پارامترهای استثنا
جدول زیر پارامترهای استثنا را فهرست می کند:
نام پارامتر | نوع داده | مورد نیاز | توضیحات |
---|
description | رشته | خیر | شرح خطا |
fatal | بولی | خیر | اگر خطا کشنده بود true . |
مثال
با توجه به عملکرد زیر:
function divide(x, y) {
if (y === 0) {
throw "Division by zero";
}
return x/y;
}
اگر مقسومکننده y صفر باشد، کد زیر یک رویداد استثنایی را به Google Analytics ارسال میکند:
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
});
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-07 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-07 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eGoogle Analytics can track website errors and crashes using exception events sent via gtag.js.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egtag('event', 'exception', {<exception_parameters>})\u003c/code\u003e is the core function to send exception data, including an optional description and fatality status.\u003c/p\u003e\n"],["\u003cp\u003eAn example demonstrates how to capture and send exceptions occurring within a JavaScript \u003ccode\u003etry...catch\u003c/code\u003e block.\u003c/p\u003e\n"]]],["Exception events, used to track web page crashes and errors, are sent to Google Analytics via the `gtag('event', 'exception', {\u003cexception_parameters\u003e});` command. `\u003cexception_parameters\u003e` include 'description' (error details) and 'fatal' (boolean indicating if the error is fatal). When an error is detected, a `gtag` event can be sent. An example uses a `try...catch` block to intercept division-by-zero errors and trigger the `gtag` event.\n"],null,["# Measure exceptions\n\nYou can send exception events to measure the number and type of crashes or\nerrors that occur on a web page. This page describes how to use gtag.js to send\nexceptions to Google Analytics.\n\nImplementation\n--------------\n\nWhen an error occurs, send an exception event to Google Analytics: \n\n gtag('event', 'exception', {\u003cexception_parameters\u003e});\n\nwhere `\u003cexception_parameters\u003e` is one or more parameter-value pairs. Separate\neach pair by a comma. For example, this command sends a nonfatal error\nexception. \n\n gtag('event', 'exception', {\n 'description': 'error_description',\n 'fatal': false // set to true if the error is fatal\n });\n\nException parameters\n--------------------\n\nThe following table lists the exception parameters:\n\n| Parameter name | Data type | Required | Description |\n|----------------|-----------|----------|--------------------------------|\n| `description` | string | No | A description of the error. |\n| `fatal` | boolean | No | `true` if the error was fatal. |\n\nExample\n-------\n\nGiven the following function: \n\n function divide(x, y) {\n if (y === 0) {\n throw \"Division by zero\";\n }\n return x/y;\n }\n\nthe following code will send an exception event to Google Analytics if the\ndivisor y is zero: \n\n var x = document.getElementById('x').value;\n var y = document.getElementById('y').value;\n\n try {\n var r = divide(x, y);\n } catch(err) {\n gtag('event', 'exception', {\n 'description': err,\n 'fatal': false\n });\n }"]]