UserInfo

最终用户的信息。

JSON 表示法
{
  "userId": string,
  "userAgent": string,
  "timeZone": string,
  "preciseLocation": {
    object (PreciseLocation)
  }
}
字段
userId

string

强烈建议用于已登录用户。已登录用户的唯一标识符,例如用户名。请勿为匿名用户设置。

此 ID 应始终使用哈希值。

请勿为不同用户设置相同的固定 ID。这会将这些用户的事件历史记录混在一起,从而导致模型质量下降。

此字段必须是采用 UTF-8 编码的字符串,长度上限为 128 个字符。否则,系统会返回 INVALID_ARGUMENT 错误。

表示 Search API 的不透明 ID。Search API 不会以任何方式解读该值。如果事件正在上传,则此字段用于将事件与会话中的用户相关联。

userAgent

string

用户代理,将包含在 HTTP 标头中。

此字段必须是采用 UTF-8 编码的字符串,长度上限为 1,000 个字符。否则,系统会返回 INVALID_ARGUMENT 错误。

如果在 UserEventService.CollectUserEvent 中使用 GTM 或 JavaScript 代码进行客户端事件报告,或者设置了 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

可选。以自然语言地址表示的位置。稍后将进行地理编码,并转换为点或多边形。