קובצי cookie וזיהוי משתמשים באמצעות gtag.js

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 עד לקבלת הסכמה מהמשתמש. מידע נוסף זמין במאמר שינוי אופן הפעולה של תגים בהתאם להסכמה