מדידת התזמונים של המשתמשים באמצעות gtag.js

קיצור זמן הטעינה של דף עשוי לשפר את החוויה הכוללת של המשתמש באתר. בדף הזה מוסבר איך לשלוח מידע על תזמוני משתמש אל Google Analytics.

הטמעה

כדי לשלוח אירוע timing_complete, משתמשים בפקודה event:

gtag('event', 'timing_complete', {<timing_parameters>});

כאשר <timing_parameters> הוא צמד אחד או יותר של פרמטר-ערך. צריך להפריד בין זוגות באמצעות פסיק. לדוגמה, הפקודה הזו שולחת אירוע של תזמון משתמש אל Google Analytics ומציינת שנדרשות 3,549 אלפיות השנייה עד שדף האינטרנט הנוכחי נטען את כל יחסי התלות החיצוניים של JavaScript.

gtag('event', 'timing_complete', {
  'name' : 'load',
  'value' : 3549,
  'event_category' : 'JS Dependencies'
});

פרמטרים של תזמוני משתמש

הטבלה הבאה מסכמת את הפרמטרים של תזמוני משתמש:

שם הפרמטר	סוג הנתונים	נדרש	התיאור
name	string	כן	מחרוזת לזיהוי המשתנה שמתועד (למשל 'load').
value	integer	כן	מספר אלפיות השנייה של זמן שחלף עד לדיווח ל-Google Analytics (למשל 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 Analytics תדגום אירועים של תזמון כדי להבטיח חלוקה שווה של משאבי המערכת לתכונה הזו.

הקצב שבו נדגמים אירועי תזמון נקבע על סמך המספר הכולל של צפיות בדפים שהתקבלו ביום הקודם בנכס. בטבלה הבאה מוסבר איך נקבע תדירות הדגימה של התזמון:

המספר הכולל של צפיות בדף (היום הקודם)	המספר המקסימלי של אירועים בתזמון שיעובדו
0 - 1,000	100
1,000 - 100,000	10% ממספר הצפיות הכולל בדף
100,000 - 1,000,000	10,000
יותר מ-1,000,000	1% ממספר הצפיות הכולל בדף