gtag.js משתמש בקובצי cookie כדי לזהות משתמשים ייחודיים בסשנים שונים של גלישה. בדף הזה נסביר איך להתאים אישית את ההגדרות של קובצי ה-cookie.
קביעת הגדרות לשדות של קובצי cookie
בטבלה הבאה מוצגים ערכי ברירת המחדל של השדות של קובצי ה-cookie שמשמשים את gtag.js:
שם השדה | סוג ערך | ערך ברירת המחדל |
---|---|---|
cookie_domain |
string |
auto |
cookie_expires |
integer |
63072000 (שנתיים, בשניות) |
cookie_prefix |
string |
_ga |
cookie_update |
boolean |
true |
cookie_flags |
string |
|
כדי לשנות ערכים כלשהם, מעדכנים את config
של הנכס כך שיצוינו ברשימת הפרמטרים. למשל:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'MyCookie',
'cookie_domain': 'blog.example.com',
'cookie_expires': 28 * 24 * 60 * 60 // 28 days, in seconds
});
הגדרת דומיין של קובצי cookie
ב-gtag.js מופעלת כברירת מחדל הגדרה אוטומטית של דומיין קובצי ה-cookie. כשהאפשרות
מופעלת, gtag.js יגדיר קובצי cookie בדומיין ברמה הגבוהה ביותר שאפשר. לדוגמה, אם כתובת האתר היא blog.example.com
, gtag.js יגדיר קובצי cookie
בדומיין example.com
. אם gtag.js מזהה שאתם מפעילים שרת באופן מקומי (למשל localhost
), הוא מגדיר באופן אוטומטי את cookie_domain
לערך 'none'
. בעקבות זאת, gtag.js יגדיר קובצי cookie באמצעות הדומיין המלא ממיקום המסמך.
כדי להשבית את ההגדרה האוטומטית של דומיין קובצי ה-cookie, מעדכנים את config
של הנכס כך שיציין ערך לפרמטר cookie_domain
:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_domain': 'blog.example.com'
});
קידומת של קובץ cookie
כדי למנוע התנגשויות עם קובצי cookie אחרים, ייתכן שיהיה צורך לשנות את התחילית של קובצי ה-cookie,
שתתווסף מראש לקובצי cookie שהוגדרו על ידי gtag.js. לדוגמה, שם ברירת המחדל של קובץ ה-cookie המזהה שמשמש את Google Analytics הוא _ga
. במקום זאת, הקוד הזה ייקרא לקובץ ה-cookie בשם example_ga
:
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_prefix': 'example'
});
תפוגה של קובץ cookie
בכל טעינת דף, זמן התפוגה של קובץ ה-cookie מתעדכן לזמן הנוכחי בתוספת הערך של השדה cookie_expires
. המשמעות היא שאם
cookie_expires
מוגדר לשבוע אחד, ומשתמש מבקר באמצעות אותו דפדפן
בתוך חמישה ימים, קובץ ה-cookie יהיה זמין לשבוע נוסף, והוא יופיע
כאותו מבקר ב-Google Analytics. אם אותו משתמש ביקר במקום זאת לאחר שפג תוקפו של קובץ ה-cookie המקורי, המערכת תיצור קובץ cookie חדש, והביקור הראשון והשני שלו יופיעו כמבקרים שמגיעים ממבקרים שונים ב-Google Analytics.
אם מגדירים את הערך של cookie_expires
ל-0
(אפס) שניות, קובץ ה-cookie הופך לקובץ cookie שמבוסס על סשן והתוקף שלו פג כשהסשן הנוכחי בדפדפן מסתיים.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_expires': 0
});
עדכון קובצי cookie
כאשר cookie_update
מוגדר לערך true
(ערך ברירת המחדל), gtag.js יעדכן
קובצי cookie בכל טעינת דף. הפעולה הזו תעדכן את תאריך התפוגה של קובצי ה-cookie כך שיוגדר ביחס לביקור האחרון באתר. לדוגמה, אם התוקף של קובץ ה-cookie מוגדר לשבוע אחד, ומשתמש מבקר באתר באמצעות אותו דפדפן פעם בחמישה ימים, תאריך התפוגה של קובץ ה-cookie יתעדכן בכל ביקור כך שלמעשה לא יפוג אף פעם.
כשמגדירים את הערך false
, קובצי ה-cookie לא מתעדכנים בכל טעינת דף. במצב כזה, תאריך התפוגה של קובצי ה-cookie הוא יחסי לביקור הראשון של משתמש כלשהו באתר.
gtag('config', 'GA_MEASUREMENT_ID', {
'cookie_update': false
});
דגלים של קובצי Cookie
מצרף סימונים נוספים לקובץ ה-cookie לאחר הגדרתו. הדגלים צריכים להיות מופרדים באמצעות סמיקולים.
gtag('set', {
'cookie_flags': 'SameSite=None;Secure'
});
הגדרת User ID
User ID הוא מחרוזת של מזהה ייחודי, קבועה וללא פרטים אישיים מזהים, שמייצגת משתמש. הוא מאפשר לנתח קבוצות של סשנים במכשירים שונים. במאמר יתרונות השימוש בתכונה User ID מוסבר למה כדאי להטמיע את User-ID.
כדי להטמיע את התכונה User-ID באמצעות gtag.js, צריך לעדכן את config
של הנכס כדי
להגדיר את User-ID:
gtag('config', 'GA_MEASUREMENT_ID', {
'user_id': 'USER_ID'
});
שינוי אופן הפעולה של תגים בהתאם להסכמה
אפשר להגדיר את gtag.js כך שלא יקרא או יכתוב קובצי cookie עד לקבלת הסכמה מהמשתמש. מידע נוסף זמין במאמר שינוי אופן הפעולה של תגים בהתאם להסכמה