يمكن أن يؤدي تقليل وقت تحميل الصفحة إلى تحسين تجربة المستخدم العامة في الموقع الإلكتروني. توضّح هذه الصفحة كيفية إرسال معلومات توقيت المستخدم إلى "إحصاءات Google".
التنفيذ
استخدِم الأمر event لإرسال حدث timing_complete:
gtag('event', 'timing_complete', {<timing_parameters>});
حيث تكون <timing_parameters> عبارة عن زوج واحد أو أكثر من المعلَمات/القيمة. افصل بين كل زوج بفاصلة. على سبيل المثال، يرسل هذا الأمر حدث توقيت المستخدم إلى "إحصاءات Google" يشير إلى أن تحميل جميع تبعيات JavaScript الخارجية استغرقت 3549 مللي ثانية في صفحة الويب الحالية.
gtag('event', 'timing_complete', {
'name' : 'load',
'value' : 3549,
'event_category' : 'JS Dependencies'
});
مَعلَمات توقيتات المستخدم
يلخص هذا الجدول معلمات توقيتات المستخدم:
| اسم المعلَمة | نوع البيانات | مطلوبة | الوصف |
|---|---|---|---|
name |
string |
Yes |
سلسلة لتحديد المتغيّر الذي يتم تسجيله (مثل 'load').
|
value |
integer |
Yes |
عدد المللي ثانية في الوقت المنقضي لإرسال التقارير إلى "إحصاءات Google"
(مثل 20).
|
event_category |
string |
لا |
سلسلة لتصنيف جميع متغيّرات توقيت المستخدم في مجموعات منطقية
(مثل 'JS Dependencies').
|
event_label |
string |
لا |
سلسلة يمكن استخدامها لتوفير مرونة في عرض توقيتات المستخدمين
في التقارير (مثل 'Google CDN').
|
قياس الوقت
يتطلّب الحدث timing_complete معلَمة value تحدّد الوقت المنقضي بالملي ثانية. تحتاج إلى كتابة تعليمة برمجية تسجِّل هذه القيمة.
تتمثل أسهل طريقة لإجراء ذلك في إنشاء طابع زمني في بداية الفترة الزمنية وإنشاء طابع زمني آخر في نهاية تلك الفترة. بعد ذلك، احسب الوقت المنقضي بين الطوابع الزمنية.
تتوافق معظم المتصفحات الحديثة مع واجهة برمجة التطبيقات Navigation Timing API، والتي تتضمّن طرقًا على عنصر window.performance لقياس أداء صفحات الويب من خلال بيانات وقت عالية الدقة.
يستخدم المثال التالي طريقة performance.now() التي تعرض مقدار الوقت المنقضي منذ بدء تحميل الصفحة لأول مرة:
// Feature detects Navigation Timing API support.
if (window.performance) {
// Gets the number of milliseconds since page load
// (and rounds the result since the value must be an integer).
var timeSincePageLoad = Math.round(performance.now());
// Sends the timing event to Google Analytics.
gtag('event', 'timing_complete', {
'name': 'load',
'value': timeSincePageLoad,
'event_category': 'JS Dependencies'
});
}
اعتبارات أخذ العينات
ستأخذ "إحصاءات Google" عينات من أحداث التوقيت لضمان التوزيع المنصف لموارد النظام لهذه الميزة.
يتم تحديد معدّل أخذ عينات من أحداث التوقيت من خلال إجمالي عدد مشاهدات الصفحة على الويب التي تم تلقّيها خلال اليوم السابق للموقع. ويوضّح الجدول التالي كيفية تحديد معدّل أخذ عينات التوقيت:
| إجمالي عدد مشاهدات الصفحة على الويب (اليوم السابق) | الحد الأقصى لعدد أحداث التوقيت التي ستتم معالجتها |
|---|---|
| 0 - 1000 | 100 |
| من 1,000 إلى 100,000 | 10% من إجمالي عدد مشاهدات الصفحة على الويب |
| من 100,000 إلى 1,000,000 | 10,000 |
| أكثر من 1,000,000 مستخدم | 1% من إجمالي عدد مشاهدات الصفحة على الويب |