בחומר העזר הזה מתוארות השיטות שבהן משתמשים כדי להתאים אישית את אופן הפעולה של הדוחות של Google Analytics בדומיינים שונים, במארחים שונים או בספריות משנה של אתר.
שיטות דומיין/ספרייה של GATC
_cookiePathCopy(newPath)
_getLinkerUrl(targetUrl, useHash)
_link(targetUrl, useHash)
_linkByPost(formObject, useHash)
_setAllowHash(bool)
הוצא משימוש_setAllowLinker(bool)
_setCookiePath(newCookiePath)
_setDomainName(newDomainName)
_storeGac(bool)
פרטי השיטה
_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]);