UserInfo

Information of an end user.

JSON representation
{"userId":string,"userAgent":string,"timeZone":string}
Fields
userId

string

Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name. Don't set for anonymous users.

Always use a hashed value for this ID.

Don't set the field to the same fixed ID for different users. This mixes the event history of those users together, which results in degraded model quality.

The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, anINVALID_ARGUMENT error is returned.

userAgent

string

User agent as included in the HTTP header.

The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, anINVALID_ARGUMENT error is returned.

This should not be set when using the client side event reporting with GTM or JavaScript tag inUserEventService.CollectUserEvent or ifUserEvent.direct_user_request is set.

timeZone

string

Optional. IANA time zone, e.g. Europe/Budapest.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-27 UTC.