تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك إرسال أحداث استثنائية لقياس عدد الأعطال ونوعها أو
الأخطاء التي تحدث على صفحة الويب. توضّح هذه الصفحة كيفية استخدام gtag.js لإرسال
باستثناء بيانات "إحصاءات Google"
التنفيذ
عند حدوث خطأ، أرسِل حدث استثناء إلى "إحصاءات Google":
حيث <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;
}
سيُرسِل الرمز التالي حدث استثناء إلى "إحصاءات 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
});
}
تاريخ التعديل الأخير: 2024-09-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-13 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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 }"]]