UserInfo

使用者的資訊。

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

string

強烈建議已登入的使用者採用這項做法。登入使用者的專屬 ID，例如使用者名稱。請勿為匿名使用者設定。

請一律使用這個 ID 的雜湊值。

請勿為不同使用者將這個欄位設為相同的固定 ID。這會將這些使用者的事件記錄混在一起，導致模型品質下降。

這個欄位必須是 UTF-8 編碼的字串，長度上限為 128 個字元。否則，系統會傳回 INVALID_ARGUMENT 錯誤。

代表 Search API 的不透明 ID。搜尋 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

選用。以自然語言地址表示的位置。稍後會經過地理編碼，並轉換為點或多邊形。