Class UserInfo (0.4.0)

UserInfo(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Information of end users.

Attributes

NameDescription
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).