ניפוי באגים

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

גרסת ניפוי הבאגים של ספריית analytics.js

ב-Google Analytics יש גרסת ניפוי באגים של ספריית analytics.js, שרושמת ביומן הודעות מפורטות ללוח JavaScript בזמן שהוא פועל. ההודעות האלה כוללות פקודות שבוצעו בהצלחה וגם אזהרות והודעות שגיאה שיכולות ליידע אתכם מתי התג הוגדר בצורה שגויה. הוא גם מספק פירוט של כל היט שנשלח אל Google Analytics, כך שתוכלו לראות בדיוק אילו נתונים מתועדים.

כדי להפעיל את גרסת ניפוי הבאגים של analytics.js, אפשר לשנות את כתובת ה-URL בתג JavaScript מ-https://www.google-analytics.com/analytics.js ל-https://www.google-analytics.com/analytics_debug.js:

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

הערה: יש להשתמש בגרסת ניפוי הבאגים של analytics.js רק במהלך הפיתוח והבדיקה, כי היא קצת יותר גדולה מ-analytics.js והיא תאט את הטעינה של הדף.

בדיקת ההטמעה ללא שליחת היטים

גרסת ניפוי הבאגים של analytics.js תשלח נתונים ל-Google Analytics בדיוק כמו הגרסה ללא ניפוי באגים. כך אפשר להיכנס לאתר שבו פועל קוד analytics.js ולבדוק את ההטמעה בלי להפריע לאופן שבו הנתונים מתועדים.

אם לא רוצים לשלוח נתונים ל-Google Analytics במקרים מסוימים (למשל, סביבות פיתוח או בדיקה), אפשר להשבית את המשימה sendHitTask ושום דבר לא יישלח.

כשמבצעים הפעלה ב-localhost, הקוד הבא ימנע שליחה של היטים אל Google Analytics:

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

ga('create', 'UA-XXXXX-Y', 'auto');

if (location.hostname == 'localhost') {
  ga('set', 'sendHitTask', null);
}

ga('send', 'pageview');

ניפוי באגים באמצעות מעקב

הפעלת ניפוי באגים של מעקב תוביל לפלט של מידע מפורט יותר במסוף.

כדי להפעיל ניפוי באגים במעקב, צריך לטעון את גרסת ניפוי הבאגים של analytics.js כפי שמתואר למעלה ולהוסיף את השורה הבאה של JavaScript לפני כל קריאות לתור הפקודות של ga().

window.ga_debug = {trace: true};

זהו התג המלא שבו מופעל ניפוי באגים של מעקב:

(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics_debug.js','ga');

window.ga_debug = {trace: true};
ga('create', 'UA-XXXXX-Y', 'auto');
ga('send', 'pageview');

התוסף ל-Chrome 'כלי לניפוי באגים של Google Analytics'

מערכת Google Analytics מספקת גם תוסף ל-Chrome שיכול להפעיל את גרסת ניפוי הבאגים של analytics.js בלי שתצטרכו לשנות את התג. כך תוכלו לנפות באגים באתרים שלכם ולראות איך אתרים אחרים הטמיעו את Google Analytics עם analytics.js.

Google Tag Assistant

Google Tag Assistant הוא תוסף ל-Chrome שעוזר לאמת את התג באתר ולפתור בעיות נפוצות. זהו כלי אידיאלי לניפוי באגים ולבדיקה של ההטמעות של analytics.js באופן מקומי ובדיקה שהכול תקין לפני פריסת הקוד בסביבת הייצור.

Tag Assistant מאפשר לכם לתעד זרימה טיפוסית של משתמש. הכלי אוסף את כל ההיטים שאתם שולחים, בודק אם יש בהם בעיות ומספק לכם דוח מלא לגבי האינטראקציות. אם המערכת תזהה בעיות או שיפורים אפשריים, נודיע לכם על כך.

למידע נוסף, היכנסו למרכז העזרה וקראו את המאמרים מידע על Tag Assistant ומידע על Tag Assistant Recordings. אפשר גם לצפות בסרטון ההדגמה הזה שמראה איך Tag Assistant משמש לזיהוי שגיאות ובדיקת החוקיות של הטמעות מתקדמות כמו מדידה בכמה דומיינים.