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
{

  // Union field location can be only one of the following:
  "point": {
    object (LatLng)
  },
  "address": string
  // End of list of possible types for union field location.
}
שדות

שדה איחוד location.

הערך location יכול להיות רק אחד מהבאים:

point

object (LatLng)

זה שינוי אופציונלי. המיקום מיוצג על ידי נקודה של קו רוחב וקו אורך.

address

string

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