מידע של משתמש קצה.
| ייצוג ב-JSON |
|---|
{
"userId": string,
"userAgent": string,
"timeZone": string,
"preciseLocation": {
object ( |
| שדות | |
|---|---|
userId |
מומלץ מאוד למשתמשים שמחוברים לחשבון. מזהה ייחודי של משתמש מחובר, כמו שם משתמש. לא להגדיר למשתמשים אנונימיים. תמיד להשתמש בערך מגובב למזהה הזה. אל תגדירו את השדה לאותו מזהה קבוע עבור משתמשים שונים. הפעולה הזו מערבבת את היסטוריית האירועים של המשתמשים האלה, וכתוצאה מכך איכות המודל יורדת. השדה חייב להיות מחרוזת בקידוד UTF-8, עם מגבלת אורך של 128 תווים. אחרת, מוחזרת שגיאת מייצג מזהה אטום ל-Search API. ה-API של החיפוש לא מפרש את הערך בשום צורה. השדה הזה משמש לשיוך אירועים למשתמש בסשנים שונים, אם האירועים מועלים. |
userAgent |
סוכן משתמש כפי שהוא מופיע בכותרת ה-HTTP. השדה חייב להיות מחרוזת מקודדת בתבנית UTF-8, עם מגבלת אורך של 1,000 תווים. אחרת, מוחזרת שגיאת אין להגדיר את הפרמטר הזה כשמשתמשים בדיווח אירועים בצד הלקוח עם GTM או תג JavaScript ב- |
timeZone |
זה שינוי אופציונלי. אזור זמן של IANA, למשל Europe/Budapest. |
preciseLocation |
זה שינוי אופציונלי. קלט בלבד. המיקום המדויק של המשתמש. הוא משמש בסיווג מותאם אישית לחישוב המרחק בין המשתמש לבין המסמכים הרלוונטיים. |
PreciseLocation
פרטי מיקום מדויקים עם כמה אפשרויות ייצוג.
| ייצוג ב-JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד הערך |
|
point |
זה שינוי אופציונלי. המיקום מיוצג על ידי נקודה של קו רוחב וקו אורך. |
address |
מיקום שמיוצג על ידי כתובת בשפה טבעית. המערכת תבצע קידוד גיאוגרפי של הנתונים ותמיר אותם לנקודה או לפוליגון. |