קוד מעקב: האובייקט הגלובלי _gat

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

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

שיטות אובייקט _gat

• _getTracker(account) הוצא משימוש
• _createTracker(opt_account, opt_name)
• _getTrackerByName(opt_name)
• _anonymizeIp()
• _forceSSL(bool)

פרטי השיטה

_gettracker()

_getTracker(account)

השיטה הזו הוצאה משימוש. במקומם יש להשתמש ב-_gat._createTracker(opt_account, opt_name).

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

_gat._getTracker('UA-65432-1');

פרמטרים

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

החזרות

Tracker אובייקט המעקב שנוצר.

---

_createtracker()

_createTracker(opt_account, opt_name)

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

_gat._createTracker('UA-65432-1');

_gat._createTracker('UA-65432-2', 't2');

פרמטרים

String opt_account המזהה המלא של נכס האינטרנט (למשל UA-XXXXX-X) של אובייקט המעקב.
String opt_name שם אופציונלי לשמירת מכשיר המעקב. משתמשים בשם הזה כדי לאחזר את מכשיר המעקב דרך _getTrackerByName

החזרות

Tracker אובייקט המעקב שנוצר.

---

_gettrackerByName()

_getTrackerByName(opt_name)

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

_gat._getTrackerByName();

_gat._getTrackerByName('t2');

פרמטרים

String opt_name השם האופציונלי של מכשיר המעקב שיש לאחזר. ברירת המחדל היא המחרוזת הריקה ('').

החזרות

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

---

_anonymizeIp()

_anonymizeIp()

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

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

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

var _gaq = _gaq || [];
_gaq.push (['_setAccount', 'UA-XXXXXXX-YY']);
_gaq.push (['_gat._anonymizeIp']);
_gaq.push (['_trackPageview']);

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

<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try{
var pageTracker = _gat._getTracker("UA-xxxxxx-x");
_gat._anonymizeIp();
pageTracker._trackPageview();
} catch(err) {}</script>

---

_forceSSL()

_forceSSL(bool)

המדיניות הזו מגדירה את Google Analytics לשליחת כל ההתאמות באמצעות SSL, גם מדפים לא מאובטחים (HTTP).

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

_gaq.push(['_setAccount', 'UA-12345-1']);
_gaq.push(['_gat._forceSSL']);       // Send all hits using SSL, even from insecure (HTTP) pages.
_gaq.push(['_trackPageview']);

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

var pageTracker = _gat._getTracker("UA-12345-1");
// Send all hits using SSL even from insecure (HTTP) pages.
_gat._forceSSL();
pageTracker._trackPageview();