פתרון בעיות בקוד המעקב

ga.js היא ספרייה מדור קודם. אם אתם מתחילים בהטמעה חדשה, מומלץ להשתמש בגרסה האחרונה של הספרייה הזו, analytics.js. להטמעות קיימות, למדו איך לעבור מ-ga.js ל-analytics.js.

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

פתרון בעיות במעקב ב-Analytics יתמקד בשתי בעיות עיקריות:

1. תחביר של שגיאות/הקלדה בקוד המעקב (למשל, רווח לבן, התאמה אישית עם איות שגוי, שמות שגויים של פרמטרים)
2. נתונים שחסרים בדוחות

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

שגיאות נפוצות בקוד המעקב

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

• בשמות השיטות נעשה שימוש באותיות רישיות, בצורה שגויה.
  חשוב לזכור שהשיטות הן תלויות אותיות רישיות. אם משתמשים בשם שיטה ללא אותיות רישיות וקטנות, קריאות ל-method לא יפעלו. לדוגמה:

    _gaq.push(['_trackpageview']);   // wrong
    _gaq.push(['_trackPageView']);   // wrong
    _gaq.push(['_trackPageview']);   // correct

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

    _gaq.push(['_setDomain', 'example.com']);       // wrong
    _gaq.push(['_setDomainName', 'example.com']);   // correct

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

    _gaq.push(['_setAllowLinker', 'false']);    // wrong
    _gaq.push(['_setAllowLinker', false]);      // correct

• המחרוזות מכילות רווחים לבנים בתחילת הטקסט או בסופו.
  דוגמאות:

    _gaq.push(['_setAccount', ' UA-65432-1']);    // wrong
    _gaq.push(['_setAccount', 'UA-65432-1']);     // correct

חזרה למעלה

בעיות נפוצות בנתוני הדוחות

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

שינוי קוד המעקב או ההגדרה לא זוהתה

כשמתקינים קוד מעקב בפעם הראשונה בדף, או כשמוסיפים פונקציונליות נוספת של קוד מעקב (למשל, למסחר אלקטרוני), אפשר לאמת בקלות שהבקשה לדף מוגדרת בצורה נכונה על ידי חיפוש הרכיבים הבאים:

• הדף מבקש את קוד ה-JavaScript של ga.js
• הדף מבקש את __utm.gif
• המשתנים utmac ו-utmcc נשלחים בבקשה __utm.gif
• כל הפרמטרים הרלוונטיים למעקב זמינים עבור נתונים נוספים שאתם מצפים שיישלחו (ניתן לעיין ברשימת הפרמטרים של בקשת GIF בהמשך).

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

חזרה למעלה

הדף או האירוע לא מופיעים בדוחות

אם דף שמכיל את קוד המעקב אינו מופיע בדוחות 'תוכן', בדוק את הפרטים הבאים:

• רוצה למצוא את הדף הנכון?
מערכת Google Analytics משתמשת בערך של הפרמטר utmp בתור הדף המבוקש, כך שאם כתובת ה-URL של הדף היא /test/myPage.html, עליכם לוודא שאתם מחפשים את הערך myPage.html בדוחות 'תוכן'. צריך לבדוק את הערך של הפרמטר utmp כדי לראות איזו בקשה לדף נשלחת.
• רוצה למצוא את האירוע הנכון?
מערכת Google Analytics משתמשת בערך של הפרמטר utme כדי לעקוב אחרי אירועים בפורמט 5(object*action*label)(value):
• 5 הוא קבוע
• יש צורך באובייקט ופעולה
• התווית והערך הם אפשרויות
מידע נוסף זמין במאמר בנושא אירועי מעקב.
• האם אתם עוקבים אחרי יותר מ-50,000 כתובות URL ייחודיות או דפים וירטואליים ביום?
מערכת Google Analytics אוספת את כל הנתונים שנשלחים מאתר, ומדווחת על 50,000 הדפים המובילים (במיון לפי צפיות בדף) ביום. כל יתר הדפים נצברים בקטע נפרד שמסומן בתווית (אחר) בדוחות התוכן. כדי להציג מידע מפורט לגבי צפיות בדפים עם תנועה נמוכה יותר, ניתן להגדיר תצוגה מפורטת (פרופיל) חדשה עם מסנן כדי להסיר את כל הצפיות בדפים עם נפח תנועה גבוה יותר, וכך לאפשר למעשה את הדפים הנותרים ב-50,000 כתובות ה-URL המובילות.
• ודא שאתה ניגש לחשבון ולתצוגה המפורטת (פרופיל) הנכונים בממשק המשתמש של הדיווח.
מערכת Google Analytics יוצרת הבחנה בין חשבונות שונים לפי מזהי דומיינים, בצורת UA-123456-1. מזהה הדומיין מופיע בקוד המעקב. זהו האופן שבו נתונים מדף מסוים משויכים לחשבון נתון. מוודאים שלחשבון ושל התצוגה המפורטת (פרופיל) שאתם מעיינים בהם (הגדרות Analytics -> עריכה -> בדיקת סטטוס) יש את אותו מזהה דומיין שנשלח בפרמטר utmac של בקשת ה-GIF.

חזרה למעלה

בעיות במעקב אחר קמפיין

כדי שניתן יהיה לעקוב ב-Google Analytics אחר קמפיין פרסום, קישורי הפרסום אל האתר שלך חייבים לכלול פרמטרים של מעקב. לאחר מכן, קוד GATC משתמש בשילוב של כתובת URL של דף ופרמטרים של הפניה כדי לזהות את הקמפיין שנשלח. לאחר מכן המידע הזה מאוחסן בקובץ ה-cookie של האתר ונשלח בפרמטר utmcc של בקשת ה-GIF. במקרים רבים, הפניות אוטומטיות של כתובות אתרים יסירו את פרמטרי המעקב או את נתוני ההפניה מקישורים אלה, וכתוצאה מכך יתקבלו דוחות שגויים בקמפיין.

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

שיוך יעד (המרה) שגוי

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

1. קליק על הפניה לאתר שלך - פעולה זו מגדירה את קובצי ה-cookie של הקמפיין.
2. לוחצים באתר שלכם כדי להגיע לדף ההמרה או היעד.
3. צריך לבדוק את הנתונים שנשלחו בפרמטר utmcc כדי לוודא שקובץ ה-cookie של הקמפיין נשמר.

לאחר שקוד המעקב לוכד את כל פרטי הקמפיין, הוא מאוחסן בקובץ cookie שנשאר עם המשתמש לאורך מספר סשנים. פרטי הקמפיין נשלחים בבקשת ה-GIF עבור כל דף שמפעיל את פונקציות המעקב. לכן, לכל צפייה בדף משויכים נתוני קמפיין/הפניה. אם אחת מהצפיות בדף מוגדרת כיעד, הקמפיין המשויך של צפייה בדף משויך ליעד. למידע נוסף על איתור וקריאה של הפרמטר utmcc, ניתן לעיין בפרמטרים של הבקשה ל-GIF ובניפוי באגים באמצעות ga_debug.js.

חזרה למעלה

שלבים בסיסיים לניפוי באגים

בכל פעם שקוד המעקב של Google Analytics מופעל, הוא מבקש תמונת GIF של פיקסל יחיד משרתי האיסוף של Google Analytics שנקראים __utm.gif.למחרוזת הבקשה של התמונה מצורפים כל הפרמטרים ש-Google מתעדת בקשר לבקשה מסוימת בדף, כולל:

• מידע על צפיות בדף בכתובת ה-URL
• פרטי הקמפיין
• נתוני מסחר אלקטרוני
• מאפייני דפדפן
• מזהי לקוח

הנתונים שכלולים בבקשת ה-GIF תואמים במדויק לנתונים שנשלחים לשרתים של Google Analytics, שעוברים עיבוד ומגיעים לנתונים בדוחות. לכן, הצגת הנתונים שנשלחו בבקשה __utm.gif מאפשרת לך לקבוע אם קוד המעקב פועל, וחשוב מכך, אם הוא שולח נתונים שגויים לדוחות שלך.

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

1. משתמשים בכלי של צד שלישי לניפוי באגים כדי לבדוק את בקשת ה-GIF ל-Google Analytics על ידי לחיצה על הקישור הרלוונטי באתר.
2. מוודאים שקוד המעקב לא מכיל אף אחת מהשגיאות הנפוצות בקוד המעקב.
3. מוודאים שהפרמטר utmp קיים.
4. מוודאים שהפרמטר utmcc קיים ושהוא לא ריק.
   אם הפרמטר utmcc ריק, לא נשלחים נתונים של קובצי cookie והמערכת מתעלמת מהבקשה.
5. חוזרים על הבדיקה כמה פעמים כדי לוודא שבקשת ה-GIF תישלח בכל פעם.

חזרה למעלה

כלים לניפוי באגים

בקשת ה-GIF כוללת מספר פרמטרים של שם/ערך שמצורפים לכתובת ה-URL שלה. במקום לנסות לבחון את המחרוזת הזו במלואה, אתם יכולים להשתמש בכלי חינמי כדי להציג את הבקשה ל-GIF בפורמט קריא יותר. הטבלה הבאה מפרטת מספר כלים לשימוש עם הדפדפנים הנפוצים ביותר.

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

דפדפן	כלי
הכול	Firebug Lite
Chrome	כלי לניפוי באגים בקוד המעקב של Google Analytics חדש!
Chrome	הכלים למפתחים שמובנים בדפדפן (למשל, Resources)
Firefox	כותרות HTTP בזמן אמת
Firefox	Firebug
Firefox	צ'ארלס
Internet Explorer	כנן
Internet Explorer	צ'ארלס
Safari	חלון הפעילות שמובנה בדפדפן
Safari	צ'ארלס

אחרי שמתקינים את הכלי ומגדירים אותו, אפשר לפתוח את דף האינטרנט שבו רוצים לפתור בעיות ולראות את ניתוח קובצי ה-GIF בכלי. קודם עליך לוודא שהדף הרלוונטי אכן שולח בקשת __utm.gif. כל עוד הבקשה מוצגת, אפשר להיות בטוחים ששרתי Google Analytics אוספים נתונים מהדף הזה. המשך הקטע הזה מספק הוראות בסיסיות לשימוש בכותרת Live HTTP וב-Firebug, כדי לתת מושג קל לגבי השימוש בכלים או בתוספים מובנים בדפדפן האינטרנט.

שימוש בכותרות HTTP בשידור חי

1. מורידים ומתקינים את LiveHTTPHeaders עבור Firefox; הפעילו מחדש את הדפדפן.
2. פותחים את Live HTTP Headers (כלים > LiveHTTPHeaders).
3. לוחצים על הכרטיסייה מחולל.
4. עוברים לאתר (או לדף שבו מותקן קוד המעקב של Google Analytics).
5. אימות שנשלחה בקשה אל urchin.js או אל ga.js
6. צריך לבדוק שנשלחה בקשה אל __utm.gif.

שימוש ב-Firebug

תוסף Firebug מציג תצוגה מובנית יותר של בקשת קוד המעקב (urchin.js או ga.js) וכן של בקשת ה-GIF (__utm.gif).  שלבים אלה מראים כיצד להשתמש ב-Firebug כדי להציג את הפרטים של בקשת ה-GIF.

1. מורידים ומתקינים את Firebug for Firefox, ומפעילים מחדש את הדפדפן.
2. עוברים אל האתר שלכם.
3. ב-Firefox, בחר באפשרות כלים> Firebug > פתח את Firebug > "הפעל את Firebug עבור אתר זה".
4. לוחצים על רשת ואז על תמונות.
5. טען מחדש את הדף וודא שבקשה חדשה עבור __utm.gif מופיעה ברשימה.
6. מאמתים את רכיבי הבקשה בכרטיסייה פרמטרים.

חזרה למעלה

ניפוי באגים באמצעות ga_debug.js

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

הסקריפט מספק פרטים על כל בקשת GIF, וירשום אזהרות והודעות שגיאה כאשר הוא יזהה בעיות בקוד המעקב. הפעולה הזו מתבצעת על ידי הדפסת הודעות על האובייקט window.console. אחרי כן תוכלו להשתמש באחד מהכלים הבאים כדי להציג את השגיאות האלה:

• Firebug (עבור Firefox)
• כלים מובנים ב-Chrome ו/או ב-Safari
• Firebug Lite (לדפדפנים אחרים)

כדי להשתמש בסקריפט ga_debug.js, אפשר לשנות את ההפניה לקוד המעקב של דף אינטרנט שיש לך גישה אליו ושאתה יכול לערוך אותו. כדי לעשות זאת, צריך להחליף את כל ההפניות אל /ga.js ב-/u/ga_debug.js בקוד המעקב של הדף הזה. אם משתמשים בסקריפט לניפוי באגים באתר נרחב, מומלץ להשתמש בו רק בסביבת הבדיקה. לחלופין, במקרה של ניפוי באגים באתר קטן, מומלץ לבדוק באופן הזה רק דפים נבחרים ולא את האתר כולו.

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

אם משתמשים ב-Universal Analytics (analytics.js) כדי לעקוב אחר האתרים, אפשר להפעיל את analytics_debug.js, גרסת ניפוי הבאגים של analytics.js, כדי לפתור בעיות בקוד המעקב. מידע נוסף על analytics_debug.js זמין במאמר ניפוי באגים.

שימוש בכלי לניפוי באגים בקוד המעקב של Google Analytics

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

כדי להשתמש בתוסף הזה, צריך להפעיל אותו בלחיצה על הסמל שלו משמאל לסרגל הכתובות. אחר כך פותחים את לוח JavaScript של Chrome כדי לראות את ההודעות במסוף.

• ב-Windows וב-Linux, לוחצים על [סמל הדף] -> מפתח -> מסוף JavaScript, או מקישים על Control-Shift-J.
• ב-Mac, לוחצים על View -> Developer -> JavaScript console או מקישים על Command-Option-J.

חזרה למעלה

הפרמטרים של הבקשה ל-GIF

הבקשה ל-GIF די ארוכה. הנה דוגמה רק לחלק מבקשת GIF:

http://www.google-analytics.com/__utm.gif?utmwv=4&utmn=769876874&utmhn=example.com&utmcs=ISO-8859-1&utmsr=1280x1024&utmsc=32-bit&utmul=en-us&utmje=1&utmfl=9.0%20%20r115&utmcn=1&utmdt=GATC012%20setting%20variables&utmhid=2059107202&utmr=0&utmp=/auto/GATC012.html?utm_source=www.gatc012.org&utm_campaign=campaign+gatc012&utm_term=keywords+gatc012&utm_content=content+gatc012&utm_medium=medium+gatc012&utmac=UA-30138-1&utmcc=__utma%3D97315849.1774621898.1207701397.1207701397.1207701397.1%3B...   

בטבלה הזו מפורטים הפרמטרים הרבים שמועברים באמצעות בקשת ה-GIF. לא כל הפרמטרים מועברים בכל הרצה של קוד המעקב, מפני שחלק מהם חלים רק על תנאים מסוימים, כמו הפניות לקמפיין או עגלות קניות. בזמן השימוש בהפניה הזו, חשוב לזכור שאתם מחפשים את המשתנים הנפוצים ביותר לגבי הדף/הבקשה שאתם בודקים.

משתנה	תיאור	ערך לדוגמה
utmac	מחרוזת חשבון. מופיע בכל הבקשות.	utmac=UA-2202604-2
utmcc	ערכים של קובצי cookie. פרמטר הבקשה הזה שולח את כל קובצי ה-Cookie שנדרשים מהדף.	utmcc=__utma%3D117243.1695285.22%3B%2B __utmz%3D117945243.1202416366.21.10. utmcsr%3Db%7C utmccn%3D(referral)%3D cmd%3D(referral)%3D cmd
utmcn	מתחיל סשן חדש בקמפיין. utmcn או utmcr קיימים בכל בקשה נתונה. משנה את נתוני המעקב של הקמפיין, אבל לא מתחיל סשן חדש	utmcn=1
utmcr	מציין ביקור חוזר בקמפיין. המדד הזה מוגדר במקרים שבהם מתרחשים קליקים נוספים על אותו קישור. utmcn או utmcr קיימים בכל בקשה נתונה.	utmcr=1
utmcs	קידוד השפה של הדפדפן. חלק מהדפדפנים לא מגדירים את הערך הזה, ובמקרה כזה הערך הוא "-"	utmcs=ISO-8859-1
utmdt	כותרת הדף, שהיא מחרוזת בקידוד כתובת URL.	utmdt=analytics%20page%20test
מנטר התנועה של Urchin	פרמטר ניתן להרחבה	הערך מקודד. משמש לאירועים ולמשתנים מותאמים אישית.
utmfl	גרסת Flash	utmfl=9.0%20r48&
utmhn	שם המארח, שהוא מחרוזת בקידוד כתובת URL.	utmhn=x343.gmodules.com
utmhid	מספר אקראי המשמש לקישור בקשות GIF של Analytics ל-Google AdSense.	utmhid=2059107202
utmipc	קוד המוצר. זהו קוד המק"ט של מוצר נתון.	utmipc=989898ajssi
utmipn	שם המוצר, שהוא מחרוזת בקידוד של כתובת URL.	utmipn=tee%20shirt
utmipr	מחיר ליחידה. מוגדר ברמת הפריט. הערך מוגדר למספרים בפורמט מטבע של ארה"ב בלבד.	utmipr=17100.32
utmiqt	כמות.	utmiqt=4
utmiva	וריאציות של פריט. לדוגמה: גדול, בינוני, קטן, ורוד, לבן, שחור, ירוק. המחרוזת מקודדת בכתובת URL.	utmiva=red;
utmje	שדה זה מציין אם הדפדפן תומך ב-Java. 1 הוא נכון.	utmje=1
מנטר התנועה של Urchin	מזהה ייחודי שנוצר לכל בקשת GIF כדי למנוע שמירה של תמונת ה-GIF במטמון.	utmn=1142651215
utmp	בקשת דף מהדף הנוכחי.	utmp=/testDirectory/myPage.html
מנטר התנועה של Urchin	הפניה, כתובת URL מלאה.	utmr=http://www.example.com/aboutUs/index.php?var=selected
utmsc	העומק של צבע המסך	utmsc=24-bit
מנטר התנועה של Urchin	רזולוציית המסך	utmsr=2400x1920
utmt	סוג הבקשה: אירוע, עסקה, פריט או משתנה מותאם אישית. אם הערך הזה לא מופיע בבקשת ה-GIF, הבקשה מוקלדת כ-page.	utmt=event
utmtci	עיר החיוב	utmtci=San%20Diego
utmtco	ארץ חיוב	utmtco=United%20Kingdom
מנטר התנועה של Urchin	מזהה הזמנה, מחרוזת בקידוד כתובת URL.	utmedit=a2343898
utmtrg	אזור חיוב, מחרוזת בקידוד כתובת URL.	utmtrg=New%20Brunswick
utmtsp	עלות משלוח. ערכים כמו ליחידה ולמחיר.	utmtsp=23.95כ
utmtst	השתייכות. בדרך כלל משתמשים באפליקציות בחנות פיזית במסחר אלקטרוני.	utmtst=google%20mtv%20store
utmtto	סה"כ. ערכים כמו ליחידה ולמחיר.	utmtto=334.56
utmttx	מס. ערכים כמו ליחידה ולמחיר.	utmttx=29.16
utmul	שפת הדפדפן.	utmul=pt-br
utmwv	גרסת קוד המעקב	utmwv=1

 

חזרה למעלה