שליחת מזהי משתמשים

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

מידע נוסף על התכונה User-ID מפורט במאמר מדידת הפעילות בפלטפורמות שונות. מידע על הגדרת מזהה משתמש באפליקציה זמין במאמר הגדרת מזהה משתמש.

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


‫

לפני שמתחילים

לפני ששולחים מזהי משתמשים, צריך לוודא שביצעתם את הפעולות הבאות:

שליחת מזהי משתמשים

הערך ששולחים למאפיין user_id תלוי במצב המשתמש:

  • המשתמש אף פעם לא נכנס לחשבון: לא שולחים את הפרמטר user_id.
  • המשתמש מחובר: שליחת מזהה המשתמש.
  • המשתמש נכנס לחשבון ואז יצא ממנו: שולחים null.

כדי לשלוח מזהה משתמש ל-Analytics, מוסיפים את הפרמטר user_id לפקודה config בכל דף באתר:

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. מחליפים את TAG_ID במזהה התג.
  2. מחליפים את ההערות בבדיקות שלכם כדי לראות אם המשתמש מחובר לחשבון, ואם הוא היה מחובר אבל התנתק.
  3. אם משתמש מחובר לחשבון, מחליפים את USER_ID במזהה המשתמש שלו.
  4. כשמשתמש מתנתק, צריך להגדיר את user_id כ-null. אל תשלחו מחרוזת ריקה (""), מחרוזת עם רווח (" ") או את המילים "null" או "NULL" בתוך מרכאות.

הגדרת User-ID אחרי האתחול

במקרים רבים, הערך של user_id לא ידוע כשמפעילים את Google Tag בפעם הראשונה. לדוגמה, יכול להיות שמשתמש יבקר באתר שלכם ורק אחר כך יתחבר.

כדי להגדיר או לעדכן את user_id אחרי טעינת הדף הראשונית, משתמשים בפקודה gtag('set'). הפקודה הזו מגדירה את user_id לכל האירועים הבאים בדף, והיא הגישה המומלצת במקום gtag('config') בתרחיש הזה.

הגדרת מזהה המשתמש בכניסה

כשמשתמש מתחבר לחשבון, צריך להפעיל את gtag('set') כדי לשייך את המזהה שלו לאירועים עתידיים:

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

ניקוי ה-User-ID אחרי יציאה מהחשבון

כשמשתמש מתנתק, צריך לנקות את user_id על ידי הגדרת הערך שלו כ-null:

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

השימוש ב-gtag('set') מבטיח שה-user_id ינוהל בצורה נכונה לאורך סשן המשתמש, וישקף את מצב הכניסה הנוכחי של המשתמש גם אם הוא משתנה אחרי שהדף נטען.

הקודם
הוספת פרמטרים
הבא
מדידת חריגים