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

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

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

הפרמטר user_id הוא פרמטר הגדרה, ולא מאפיין משתמש מותאם אישית או פרמטר רגיל של אירוע. במקום זאת, user_id הוא פרמטר מערכת שמור שמשמש במיוחד לזיהוי משתמשים מאומתים במכשירים ובסשנים שונים. אל תגדירו אותו כמאפיין משתמש מותאם אישית (לדוגמה, באובייקט user_properties של gtag.js או בקטע User Properties בתגים של Google Tag Manager), ואל תרשמו אותו כמאפיין מותאם אישית בממשק המשתמש של Analytics. באופן דומה, אל תעבירו אותו כפרמטר ברמת האירוע באירועים נפרדים. במקום זאת, מגדירים את user_id רק כפרמטר הגדרה באמצעות השיטות הבאות.


‫

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

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

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

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

איך משתמשים ב-User-ID ב-Google Analytics

אחרי ששולחים ערכי user_id אל Google Analytics, המערכת משתמשת בהם כדי:

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

שיקולים חשובים

  • אל תיצרו מאפיינים מותאמים אישית עבור User-ID: אין לרשום את user_id כמאפיין מותאם אישית ברמת המשתמש. זו שיטה מומלצת חשובה. הפעולה הזו יוצרת מאפיין מיותר בעל עוצמה גבוהה, שיכול להשפיע באופן משמעותי על ביצועי הדוחות, לגרום לקיבוץ נתונים בשורה (other) ולצרוך את המכסה של המאפיינים המותאמים אישית. התכונה המובנית User-ID מטפלת בהצמדת המשתמש. מידע נוסף על שיטות מומלצות לשימוש בתכונה User-ID

  • מגדירים את user_id כהגדרה אישית, ולא כמאפיין משתמש או כפרמטר של אירוע: מכיוון ש-user_id הוא פרמטר מערכת שמור, צריך להחיל אותו רק כהגדרה אישית או כפרמטר של הגדרה (באמצעות הפקודות gtag() config או set, או ההגדרות האישיות של Google Tag ב-Google Tag Manager). אל תגדירו אותו כמאפיין משתמש מותאם אישית, אל תעבירו אותו בתוך אובייקט ההגדרות user_properties ואל תשלחו אותו כפרמטר ברמת האירוע באירועים ספציפיים.

  • חשיפת מזהים ישירות בדוחות רגילים לעומת ניתוחים: ערכים גולמיים user_id לא זמינים כמאפיין רגיל בדוחות רגילים או ברוב הניתוחים (כמו ניתוח חופשי) כדי לשמור על הפרטיות ולנהל את העוצמה. עם זאת, אפשר לראות את הנתונים הגולמיים של user_id בתבנית ניתוח משתמשים נפרדים בעמודה מזהה משתמש בפועל עבור משתמשים מחוברים.

  • גישה למזהי משתמשים גולמיים: אם אתם צריכים לבצע ניתוח באמצעות הערכים הגולמיים של user_id, מומלץ להשתמש בBigQuery Export של Google Analytics 4. השדה user_id זמין בנתונים המיוצאים.

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

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