UserInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)
Information of end users.
Attributes | |
---|---|
Name | Description |
visitor_id |
str
Required. A unique identifier for tracking visitors with a length limit of 128 bytes. For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty. |
user_id |
str
Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users. |
ip_address |
str
Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should *not* be set when using the javascript pixel or if direct_user_request is set. Used to extract location
information for personalization.
|
user_agent |
str
Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB. This should *not* be set when using the JavaScript pixel or if directUserRequest is set.
|
direct_user_request |
bool
Optional. Indicates if the request is made directly from the end user in which case the user_agent and ip_address fields can be populated from the HTTP request. This should *not* be set when using the javascript pixel. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events). |