UserInfo

מידע על משתמש קצה.

ייצוג ב-JSON
{
  "userId": string,
  "userAgent": string,
  "timeZone": string
}
שדות
userId

string

מומלץ מאוד למשתמשים שמחוברים לחשבון. מזהה ייחודי של משתמש מחובר, כמו שם משתמש. לא להגדיר למשתמשים אנונימיים.

תמיד להשתמש בערך מגובב למזהה הזה.

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

השדה חייב להיות מחרוזת בקידוד UTF-8, עם מגבלת אורך של 128 תווים. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.

מייצג מזהה אטום ל-Search API. ה-API של החיפוש לא מפרש את הערך בשום צורה. השדה הזה משמש לשיוך אירועים למשתמש בסשנים שונים, אם האירועים מועלים.

userAgent

string

סוכן המשתמש כפי שהוא נכלל בכותרת ה-HTTP.

השדה חייב להיות מחרוזת מקודדת בתבנית UTF-8, עם מגבלת אורך של 1,000 תווים. אחרת, מוחזרת שגיאת INVALID_ARGUMENT.

אין להגדיר את הפרמטר הזה כשמשתמשים בדיווח אירועים בצד הלקוח עם GTM או תג JavaScript ב-UserEventService.CollectUserEvent, או אם הפרמטר UserEvent.direct_user_request מוגדר.

timeZone

string

זה שינוי אופציונלי. אזור זמן של IANA, למשל Europe/Budapest.