UserInfo

エンドユーザーの情報。

JSON 表現
{
  "userId": string,
  "userAgent": string,
  "timeZone": string,
  "preciseLocation": {
    object (PreciseLocation)
  }
}
フィールド
userId

string

ログインしているユーザーに強く推奨されます。ログイン中のユーザーの固有識別子(ユーザー名など)。匿名ユーザーには設定しないでください。

この ID には常にハッシュ値を使用します。

異なるユーザーに対して、フィールドに同じ固定 ID を設定しないでください。これにより、これらのユーザーのイベント履歴が混在し、モデルの品質が低下します。

このフィールドは、長さの上限が 128 文字の UTF-8 でエンコードされた文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

Search API の不透明な ID を表します。Search API はこの値を解釈しません。このフィールドは、イベントがアップロードされる場合に、セッション間でイベントをユーザーに関連付けるために使用されます。

userAgent

string

HTTP ヘッダーに含まれるユーザー エージェント。

このフィールドは、長さの上限が 1,000 文字の UTF-8 でエンコードされた文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。

GTM または UserEventService.CollectUserEvent の 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

省略可。自然言語のアドレスで表される場所。後でジオコーディングされ、ポイントまたはポリゴンのいずれかに変換されます。