The event object model

The browser object

The browser object is located within the context object and contains information about the user's browser or device they are using to access your site.

Important

You must include the browser object when sending events using the Events REST API.

The following table lists the attributes supported by the browser object:

Name	Type	Description	Value
user_agent	String	Optional. The browser user agent. Must follow industry convention to ensure `device` and `app_typ`e can be detected automatically. Important If you do not include `user_agent`, you must include `device` and `app_type`.	n/a
device	String	Optional. Device used to access the experience. Important Computed automatically by default if you include `user_agent`.	`pc` `tablet` `mobile`
app_type	String	Optional. Type of app used to access the experience. Important Computed automatically by default if you include `user_agent`.	`browser` `webview` `native`

Name

Type

Description

Value

user_agent

String

Optional.

The browser user agent. Must follow industry convention to ensure device and app_type can be detected automatically.

Important

If you do not include user_agent, you must include device and app_type.

n/a

device

String

Optional.

Device used to access the experience.

Important

Computed automatically by default if you include user_agent.

pc
tablet
mobile

app_type

String

Optional.

Type of app used to access the experience.

Important

Computed automatically by default if you include user_agent.

browser
webview
native

If you have suggestions for improving this article, let us know!