最终用户的信息。
| JSON 表示法 |
|---|
{
"userId": string,
"userAgent": string,
"timeZone": string,
"preciseLocation": {
object ( |
| 字段 | |
|---|---|
userId |
强烈建议用于已登录用户。已登录用户的唯一标识符,例如用户名。请勿为匿名用户设置。 此 ID 应始终使用哈希值。 请勿为不同用户设置相同的固定 ID。这会将这些用户的事件历史记录混在一起,从而导致模型质量下降。 此字段必须是采用 UTF-8 编码的字符串,长度上限为 128 个字符。否则,系统会返回 表示 Search API 的不透明 ID。Search API 不会以任何方式解读该值。如果事件正在上传,则此字段用于将事件与会话中的用户相关联。 |
userAgent |
用户代理,将包含在 HTTP 标头中。 此字段必须是采用 UTF-8 编码的字符串,长度上限为 1,000 个字符。否则,系统会返回 如果在 |
timeZone |
可选。IANA 时区,例如 Europe/Budapest。 |
preciseLocation |
可选。仅限输入。用户的精确位置。它在自定义排名中用于计算用户与相关文档之间的距离。 |
PreciseLocation
精确位置信息,具有多种表示选项。目前仅支持纬度和经度点。
| JSON 表示法 |
|---|
{ // Union field |
| 字段 | |
|---|---|
联合字段
|
|
point |
可选。以纬度/经度点表示的位置。 |
address |
可选。以自然语言地址表示的位置。稍后将进行地理编码,并转换为点或多边形。 |