עיבוד הנתונים בנכסי Universal Analytics רגילים (UA) הופסק ב-1 ביולי 2023. ב-1 ביולי 2024 ייפסק עיבוד הנתונים בנכסי UA 360, וחלק מהתכונות של UA 360 יוצאו משימוש לפני כן, במסגרת המעבר ל-Google Analytics 4. מוסיפים את Google Analytics 4 להטמעה הקיימת.

דף זה תורגם על ידי Cloud Translation API.

קוד מעקב: תצורה בסיסית

ההפניה הזו מתארת את השיטות שבהן אתה משתמש להתאמה אישית של כל ההיבטים של הדיווח ב-Google Analytics.

ga.js שיטות בסיסיות

_deleteCustomVar(index)
_getName()
_getAccount()
_getVersion()
_getVisitorCustomVar(index)
_initData() הוצא משימוש
_setAccount(accountID)
_setCookiePersistence(milliseconds) הוצא משימוש
_setCustomVar(index, name, value, opt_scope)
_setSampleRate(newRate)
_setSessionTimeout(newTimeout) הוצא משימוש
_setSessionCookieTimeout(cookieTimeoutMillis)
_setSiteSpeedSampleRate(sampleRate)
_setVar(newVal) הוצא משימוש
_setVisitorCookieTimeout(cookieTimeoutMillis)
_trackPageLoadTime() הוצא משימוש
_trackPageview(opt_pageURL)

פרטי השיטה

_deleteCustomVar()

_deleteCustomVar(index)

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

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_deleteCustomVar', 1]);

קטע קוד מסורתי (ga.js)

pageTracker._deleteCustomVar(1);

פרמטרים

Int index האינדקס של המשתנה המותאם אישית למחיקה.

_getName()

_getName()

מחזירה את השם שניתן למכשיר המעקב כשהוא נוצר.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var trackerName = pageTracker._getName();
});

קטע קוד מסורתי (ga.js)

pageTracker._getName();

החזרות

String השם של מכשיר המעקב.

_getAccount()

_getAccount()

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

קטע קוד אסינכרוני (מומלץ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var accountId = pageTracker._getAccount();
});

קטע קוד מסורתי (ga.js)

pageTracker._getAccount();

החזרות

String מזהה חשבון שבאמצעותו נוצר אובייקט המעקב הזה.

_getVersion()

_getVersion()

מחזירה את מספר הגרסה של GATC.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var version = pageTracker._getVersion();
});

קטע קוד מסורתי (ga.js)

pageTracker._getVersion();

החזרות

String מספר הגרסה של GATC.

_getVisitorCustomVar()

_getVisitorCustomVar(index)

מחזירה את הערך של המשתנה המותאם אישית ברמת המבקר שהוקצה עבור האינדקס שצוין.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(function() {
  var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
  var visitorCustomVar1Value = pageTracker._getVisitorCustomVar(1);
});

קטע קוד מסורתי (ga.js)

pageTracker._getVisitorCustomVar(1);

פרמטרים

Int index האינדקס של המשתנה המותאם אישית ברמת המבקר.

החזרות

String הערך של המשתנה המותאם אישית ברמת המבקר. מחזירה ערך לא מוגדר אם לא ניתן לאחזר את המשתנה של האינדקס שצוין.

_initData()

_initData()הוצא משימוש. initData() מופעל עכשיו באופן אוטומטי בקוד המעקב ga.js.

מאתחל או מפעיל מחדש את אובייקט GATC (קוד מעקב של Google Analytics).

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();

_setAccount()

_setAccount(accountId)

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

_gaq.push(['_setAccount', 'UA-XXXXX-X']);

פרמטרים

String accountID המזהה המלא של נכס האינטרנט (למשל UA-65432-1) של אובייקט המעקב.

_setCookiePersistence()

_setCookiePersistence(milliseconds)

השיטה הזו הוצאה משימוש. במקומם יש להשתמש ב-_setVisitorCookieTimeout(cookieTimeoutMillis).

המדיניות הזו מגדירה את תאריך התפוגה של קובץ ה-cookie של האורח ב-Google Analytics באלפיות השנייה. כברירת מחדל, קובץ ה-cookie של המבקר מוגדר לפוג תוך שנתיים. אם אתה מעדיף, תוכל לשנות את תאריך התפוגה של קובץ ה-cookie של המבקר באמצעות שיטה זו. לדוגמה, כדי להגדיר את התפוגה של קובץ ה-cookie של המבקר ל-7 ימים, צריך להשתמש בקוד הבא:

pageTracker._setCookiePersistence(604800000);

פרמטרים

Number milliseconds מועד תפוגה של קובץ cookie של מבקר חדש.

_setCustomVar()

_setCustomVar(index, name, value, opt_scope)

משתנה מותאם אישית עם השם, הערך וההיקף שצוינו למשתנה. קיימת מגבלת תווים של 128 בייט עבור השילוב של name ו-value.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setCustomVar', 1, 'Section', 'Life & Style', 3]);

קטע קוד מסורתי (ga.js)

pageTracker._setCustomVar(
    1,                   // Required - This custom var is set to slot #1
    "Section",           // Required - The top-level name for your online content categories
    "Life & Style",  // Required - Sets the value of "Section" to "Life & Style" for this particular article
    3                    // Optional - Sets the scope to page-level
);

החזרות

Boolean השיטה הזו מחזירה את הערך true אם המשתנה המותאם אישית הוגדר בהצלחה, וגם את הערך false אם הוא לא הוגדר (למשל, אם האורך של מחרוזת השם/ערך שלכם חורג מ-128 בייטים, או אם אתם משתמשים ביחידת קיבולת (Slot) שגויה).

פרמטרים

Int index חובה. המשבצת שנעשה בה שימוש למשתנה המותאם אישית. הערכים האפשריים הם 1-5, כולל.

String name חובה. השם של המשתנה המותאם אישית.

String value חובה. הערך של המשתנה המותאם אישית.

Int opt_scope אופציונלי. ההיקף שבו מוגדר המשתנה המותאם אישית. הערכים האפשריים הם 1 ברמת המבקר, 2 ברמת הסשן ו-3 ברמת הדף.

_setSampleRate()

_setSampleRate(newRate)

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

עליך לציין את השיטה הזו רק באותו זמן שבו מתבצעת קריאה ל- _setAccount() , בדרך כלל פעם אחת בכל דף או יישום (בכל מקום שבו אתה מאתחל את קוד המעקב עצמו). חשוב לזכור שהערך של קצב הדגימה שציינתם יישאר בתוקף כל עוד אובייקט המעקב עצמו יישאר בתוקף.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setSampleRate', '2.5']);

קטע קוד מסורתי (ga.js)

pageTracker._setSampleRate("2.5"); //sets sampling rate to 2.5%

פרמטרים

String newRate תדירות דגימה חדשה להגדרה. מציינים מחרוזת מספרית בין 0 ל-100 (בדיוק עם שתי ספרות אחרי הנקודה העשרונית).

_setSessionTimeout()

_setSessionTimeout(newTimeout)

השיטה הזו הוצאה משימוש. במקומם יש להשתמש ב-_setSessionCookieTimeout(cookieTimeoutMillis).

מגדיר את הזמן הקצוב לתפוגה של סשן חדש בשניות. כברירת מחדל, הזמן הקצוב לתפוגה של סשן מוגדר ל-30 דקות (1,800 שניות). הזמן הקצוב לתפוגה של סשן משמש לחישוב ביקורים (מידע נוסף זמין במאמר איך סשן מוגדר ב-Analytics). אם ברצונך לשנות את ההגדרה של 'סשן' לצרכים הספציפיים שלך, אפשר להעביר את מספר השניות כדי להגדיר ערך חדש. הפעולה הזו תשפיע על דוחות הביקורים בכל קטע שבו מחושב מספר הביקורים, ושבו הביקורים משמשים לחישוב ערכים אחרים. לדוגמה, מספר הביקורים בדרך כלל יגדל אם מקצרים את הזמן הקצוב לתפוגה של סשן, ובדרך כלל הוא יקטן אם הזמן הקצוב לתפוגה של סשן יתארך.

פרמטרים

String newTimeout הזמן הקצוב לתפוגה של סשן חדש יוגדר בשניות.

_setSessionCookieTimeout()

_setSessionCookieTimeout(cookieTimeoutMillis)

מגדיר את הזמן הקצוב לתפוגה של קובץ cookie של סשן חדש באלפיות השנייה. כברירת מחדל, הזמן הקצוב לתפוגה של סשן מוגדר ל-30 דקות. הזמן הקצוב לתפוגת פעילויות באתר משמש לחישוב ביקורים, מכיוון שביקור מסתיים לאחר 30 דקות של חוסר פעילות בדפדפן או בעת יציאה מהדפדפן. אם ברצונכם לשנות את ההגדרה של 'סשן' לצרכים הספציפיים שלכם, תוכלו להעביר את מספר אלפיות השנייה כדי להגדיר ערך חדש. הדבר ישפיע על הדוחות 'ביקורים' בכל קטע שבו מחושב מספר הביקורים, ושבו הביקורים משמשים לחישוב ערכים אחרים. לדוגמה, מספר הביקורים יגדל אם תקצר את הזמן הקצוב לתפוגה של סשנים, ויקטן אם הזמן הקצוב לתפוגה של סשן ארוך יותר. אפשר לשנות את הזמן הקצוב לתפוגה ל-0 כדי לציין שצריך למחוק את קובץ ה-cookie הזה כשהדפדפן נסגר.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setSessionCookieTimeout', 1800000]);

קטע קוד מסורתי (ga.js)

pageTracker._setSessionCookieTimeout(1800000); //number of milliseconds in 30 minutes

פרמטרים

Number cookieTimeoutMillis הזמן הקצוב לתפוגה של סשן חדש באלפיות השנייה או 0 כדי למחוק את קובץ ה-Cookie כשהדפדפן נסגר.

_setSiteSpeedSampleRate()

_setSiteSpeedSampleRate(sampleRate)

מגדירה גודל חדש של קבוצת מדגם עבור איסוף נתונים מסוג 'מהירות אתר'. כברירת מחדל, דגימה קבועה של 1% מהמבקרים באתר יוצרת את מאגר הנתונים שממנו נגזרים המדדים של מהירות האתר. אם יש לך מספר קטן יחסית של מבקרים יומיים באתר, כמו 100,000 או פחות, כדאי להתאים את הדגימה לקצב גבוה יותר. הפעולה הזו תספק רמת פירוט גבוהה יותר לגבי זמן טעינת הדף ומדדים אחרים של מהירות האתר. (פרטים נוספים על הדוחות 'מהירות אתר' מופיעים במאמר מהירות אתר במרכז העזרה).

כדי שהיא תהיה יעילה, צריך לקרוא לשיטה _setSiteSpeedSampleRate() לפני _trackPageview().

מערכת Analytics מגבילה את ההיטים לאיסוף 'מהירות אתר' עבור נכס יחיד הגבוה מבין 1% המשתמשים או 10,000 היטים ליום, כדי להבטיח חלוקה שווה של משאבי המערכת לתכונה הזו.

הערה: מומלץ מאוד לאתרים שמקבלים יותר ממיליון היטים ביום להשאיר את מבחר הדגימות שלהם מוגדר לקצב ברירת המחדל של 1%. שינוי גודל המדגם למספר גדול יותר לא יגדיל את גודל המדגם.

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setSiteSpeedSampleRate', 5]);
_gaq.push(['_trackPageview']);

קטע קוד מסורתי (ga.js)

pageTracker._setSiteSpeedSampleRate(5);
pageTracker._trackPageview();

פרמטרים

Number sampleRate ערך בין 0 ל-100 כדי להגדיר את אחוז המבקרים באתר שיימדדו לצורך בדיקת מהירות האתר. לדוגמה, הערך 5 מגדיר את דגימת האיסוף 'מהירות אתר' ל-5%.

_setVisitorCookieTimeout()

_setVisitorCookieTimeout(cookieTimeoutMillis)

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

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setVisitorCookieTimeout', 63072000000]);

קטע קוד מסורתי (ga.js)

pageTracker._setVisitorCookieTimeout(63072000000); //number of milliseconds in 2 years

פרמטרים

Number cookieTimeoutMillis זמן התפוגה של קובץ ה-cookie החדש של מבקר חדש באלפיות השנייה או 0 כדי למחוק את קובץ ה-cookie כשהדפדפן נסגר.

_setVar()

_setVar(newVal)

השיטה הזו הוצאה משימוש. יש להשתמש בעמודה _setCustomVar() במקום זאת.

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

פרמטרים

String newVal יש להגדיר ערך חדש על-ידי משתמש.

_trackPageLoadTime()

_trackPageLoadTime()

שיטה זו הוצאה משימוש מפני שהדיווח על מהירות האתר מופעל באופן אוטומטי עבור כל המשתמשים. יש להשתמש ב-_setSiteSpeedSampleRate() כדי לשנות את קצב הדגימה לדיווח על מהירות האתר.

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

אימות השינויים שלך

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

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

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview']);
_gaq.push(['_trackPageLoadTime']);

קטע קוד מסורתי (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview();
pageTracker._trackPageLoadTime();

_trackPageview()

_trackPageview(opt_pagePath)

הלוגיקה העיקרית של GATC (Google Analytic tracker Code). אם פונקציות linker מופעלות, יתבצע ניסיון לחלץ ערכים של קובצי Cookie מכתובת ה-URL. אחרת, הוא מנסה לחלץ ערכים של קובצי cookie מ-document.cookie. הוא גם מעדכן או יוצר קובצי cookie לפי הצורך, ואז כותב אותם חזרה לאובייקט המסמך. אוסף את כל המדדים המתאימים לשליחה ל-UCFE (Urchin Collector Front-end).

קטע קוד אסינכרוני (מומלץ)

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_trackPageview', '/home/landingPage']);

קטע קוד מסורתי (ga.js)

var pageTracker = _gat._getTracker("UA-12345-1");
pageTracker._trackPageview("/home/landingPage");

פרמטרים

String opt_pagePath פרמטר אופציונלי שמציין את הנתיב של הדף שבו רוצים לעקוב אחרי מדדים. כשמשתמשים באפשרות הזו, צריך להשתמש בקו נטוי (/) כדי לציין את נתיב הדף.