UserInfo

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

ייצוג JSON 
{
  "userId": string,
  "userAgent": string,
  "timeZone": string,
  "preciseLocation": {
    object (PreciseLocation)
  }
}
שדות
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.
preciseLocation

object (PreciseLocation)

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

PreciseLocation

פרטי מיקום מדויקים עם כמה אפשרויות ייצוג.

ייצוג JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "point": {
    object (LatLng)
  },
  "address": string
  // End of mutually exclusive fields.
}
שדות
בהמשך מפורטת רשימה של שדות שאי אפשר להשתמש בהם בו-זמנית. רק אחד מהשדות הבאים יוגדר בתשובה:
point

object (LatLng)

אופציונלי. מיקום שמיוצג על ידי נקודת קו רוחב/קו אורך.
address

string

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