קוד מעקב: דומיינים וספריות

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

שיטות דומיין/ספרייה של GATC

פרטי השיטה

_cookiePathCopy()

_cookiePathCopy(newPath)

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

כשהפונקציה הזו מופעלת, היא מעתיקה את כל קובצי ה-cookie באופן מיידי לנתיב החדש של קובצי ה-cookie. לכן, אם לא תבוצע קריאה לשיטה _trackPageview(), יסופקו הערכים של כל קובצי ה-cookie הקיימים של Analytics. לכן מומלץ לקרוא לשיטה הזו אחרי _trackPageview(), וגם לקרוא שיטות הגדרה אחרות שעשויות להשפיע על ערכים של קובצי cookie או של ערכי קמפיינים שרוצים להעביר הלאה, כמו _setCampaignCookieTimeout() או _setReferrerOverride().

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

פרמטרים

String   newPath דרך חדשה לאחסון קובצי cookie של GATC בהיררכיה.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

השיטה הזו פועלת בשילוב עם השיטות _setDomainName() ו-_setAllowLinker() כדי להפעיל מעקב אחר משתמשים בכמה דומיינים, במיוחד למסגרות iFrame ולקישורים שנפתחים בחלון חדש. השיטה הזו מחזירה מחרוזת של כל הנתונים של קובץ ה-cookie של GATC מהקישור שמתחיל את התהליך על ידי צירוף שלהם לפרמטר של כתובת האתר. לאחר מכן ניתן להעביר את המידע הזה לאתר אחר או ל-iFrame אחר.

קטע קוד אסינכרוני (מומלץ) 
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

פרמטרים

String   targetUrl כתובת ה-URL של אתר היעד שאליו יישלחו הערכים של קובצי ה-cookie.

Boolean   useHash להגדיר את הערך כ-True כדי להעביר משתנים של קוד מעקב על ידי שימוש במפריד של תגי עוגן # במקום בברירת המחדל ? מפריד מחרוזת שאילתה.

החזרות

String כתובת ה-URL של המקשר.

‎_link()‎

_link(targetUrl, useHash)

השיטה הזו פועלת בשילוב עם השיטות _setDomainName() ו-_setAllowLinker() כדי לאפשר מעקב אחר משתמשים בכמה דומיינים. השיטה _link() מעבירה את קובצי ה-cookie של GATC מהאתר הזה לאתר אחר באמצעות פרמטרים של כתובת URL (HTTP GET). היא גם משנה את document.location ומפנה את המשתמש לכתובת ה-URL החדשה.

קטע קוד אסינכרוני (מומלץ) 
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

פרמטרים

String   targetUrl כתובת ה-URL של אתר היעד שאליו יישלחו הערכים של קובצי ה-cookie.

Boolean   useHash להגדיר את הערך כ-True כדי להעביר משתנים של קוד מעקב על ידי שימוש במפריד של תגי עוגן # במקום בברירת המחדל ? מפריד מחרוזת שאילתה.

_linkByPost()

_linkByPost(formObject, useHash)

השיטה הזו פועלת בשילוב עם השיטות _setDomainName() ו-_setAllowLinker() כדי לאפשר מעקב אחר משתמשים בכמה דומיינים. השיטה _linkByPost() מעבירה את קובצי ה-cookie של GATC מהטופס המפנה לאתר אחר במחרוזת שמצורפת לערך הפעולה של הטופס (HTTP POST). בדרך כלל משתמשים בשיטה הזו למעקב אחר התנהגות המשתמשים מאתר אחד לאתר של עגלת קניות של צד שלישי, אבל אפשר להשתמש בה גם כדי לשלוח נתונים של קובצי cookie לדומיינים אחרים בחלונות קופצים או ב-iFrames.

קטע קוד אסינכרוני (מומלץ) 
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

כמו כן, כדי שהקישור יפעל, צריך להגדיר את _setAllowLinker() לערך true בדף האינטרנט של היעד.

פרמטרים

HTMLFormElement   formObject אובייקט טופס שמקיף את בקשת ה-POST.

Boolean   useHash להגדיר את הערך כ-True כדי להעביר משתנים של קוד מעקב על ידי שימוש במפריד של תגי עוגן # במקום בברירת המחדל ? מפריד מחרוזת שאילתה.

_setAllowHash()

_setAllowHash(bool)

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

פרמטרים

Boolean   true או false ערך ברירת המחדל הוא true. אם הערך שמוגדר לפרמטר הוא true, אז גיבוב הדומיין מופעל. אחרת, גיבוב (hashing) הדומיין מושבת.

_setAllowLinker()

_setAllowLinker(bool)

מגדיר את סימון הפונקציונליות של המקשר כחלק מההפעלה של מעקב אחר משתמשים בדומיינים שונים. כברירת מחדל, השיטה הזו מוגדרת לערך false והקישור מושבת. כדאי לעיין גם בשיטות _link(), _linkByPost() ו-_setDomainName() כדי להפעיל מעקב בכמה דומיינים. יש להשתמש בשיטה _setAllowLinker באתר היעד, כך שאתר היעד ישתמש בנתונים של קובצי ה-cookie בפרמטר של כתובת האתר, במקום בלוגיקת הסשנים הרגילה.

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_setAllowLinker', true]);

פרמטרים

Boolean  true או false ערך ברירת המחדל הוא false. אם הערך שמוגדר לפרמטר הזה הוא true, אז המקשר מופעל. אחרת, קישור הדומיינים מושבת.

_setCookiePath()

_setCookiePath(newCookiePath)

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

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

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_setCookiePath', '/myBlogDirectory']);

פרמטרים

String   newCookiePath הוגדר נתיב חדש של קובצי cookie.

_setDomainName()

_setDomainName(newDomainName)

מגדיר את שם הדומיין עבור קובצי ה-cookie של GATC. לשיטה הזו יש שלושה מצבים: ("auto" | "none" | [domain]). כברירת מחדל, השיטה מוגדרת ל-auto, שמנסה לזהות את שם הדומיין על סמך הנכס document.domain ב-DOM.

ציון דומיין

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

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_setDomainName', 'example.com']);

בידוד של דומיינים ברמה העליונה

אם מגדירים את השיטה הזו ל-none, לכל תת-דומיין אין גישה לקובצי ה-cookie בדומיין מסוים.

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_setDomainName', 'none']);

פרמטרים

String   newDomainName צריך להגדיר שם דומיין חדש שמוגדר כברירת מחדל.

_storeGac(bool)

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

קטע קוד אסינכרוני (מומלץ) 
_gaq.push(['_storeGac', false]);