| Module | Services | Data types | Constants |
|---|---|---|---|
| ua | DeviceType MobileClass NameAndVersion UserAgent UserAgentType |
BROWSER | 1 |
A web browser, especially on a desktop, notebook or workstation |
EMAIL_CLIENT | 100 |
An email client, email reader |
FEED_READER | 101 |
A news aggregator, also termed a feed aggregator, feed reader, news reader, RSS reader or simply aggregator |
LIBRARY | 102 |
A library is a collection of resources used to develop software. |
MEDIAPLAYER | 103 |
Media player, also called multimedia player, is a term typically used to describe computer software for playing back multimedia files. |
MOBILE_BROWSER | 2 |
A mobile browser, also called a microbrowser, minibrowser, or wireless internet browser (WIB), is a web browser designed for use on a mobile device. |
OFFLINE_BROWSER | 104 |
Offline browser which may download completely or partially a website to a hard drive |
OTHER | 3 |
A software that doesn't match the other types |
ROBOT | 4 |
Bots, such as Web crawlers |
UNKNOWN | 5 |
An unknown user agent type |
USERAGENT_ANONYMIZER | 105 |
A software to hide the real user agent information |
VALIDATOR | 106 |
A software or service that validates parts of a website or webservice, such as CSS, HTML, JSON, XML |
WAP_BROWSER | 107 |
A WAP browser is a web browser for mobile devices such as mobile phones that uses the Wireless Application Protocol (WAP). WAP is a technical standard for accessing information over a mobile wireless network. |
GUARDIAN_NATIVE_APP | 6 |
One of the guardian native apps |
GAME_CONSOLE | 1 |
A game console is an interactive computer that produces a video display signal which can be used with a display device (a television, monitor, etc.) to display a video game. The term "game console" is used to distinguish a machine designed for people to buy and use primarily for playing video games on a TV in contrast to arcade machines, handheld game consoles, or home computers. |
PDA | 3 |
A personal digital assistant (PDA), also known as a palmtop computer, or personal data assistant, is a mobile device that functions as a personal information manager. PDAs are largely considered obsolete with the widespread adoption of smartphones. |
PERSONAL_COMPUTER | 4 |
A personal computer (PC) is a general-purpose computer, whose size, capabilities, and original sale price makes it useful for individuals, and which is intended to be operated directly by an end-user with no intervening computer operator. |
SMART_TV | 5 |
A smart TV, sometimes referred to as connected TV or hybrid TV |
SMARTPHONE | 6 |
A smartphone is a mobile phone built on a mobile operating system, with more advanced computing capability and connectivity than a feature phone |
TABLET | 7 |
A tablet computer, or simply tablet, is a mobile computer with display, circuitry and battery in a single unit. Tablets are often equipped with sensors, including cameras, microphone, accelerometer and touchscreen, with finger or stylus gestures replacing computer mouse and keyboard. |
UNKNOWN | 8 |
An unknown device category |
WEARABLE_COMPUTER | 9 |
Wearable computers, also known as body-borne computers are miniature electronic devices that are worn by the bearer under, with or on top of clothing. |
OTHER | 10 |
A device that doesn't match the other categories |
GUARDIAN_ANDROID_NATIVE_APP | 11 |
The Guardian android native app |
GUARDIAN_IOS_NATIVE_APP | 12 |
The Guardian iOS native app |
GUARDIAN_WINDOWS_APP | 13 |
The Guardian iOS native app |
PHONE | 1 | |
TABLET | 2 |
| Key | Field | Type | Description | Requiredness | Default value |
|---|---|---|---|---|---|
| 1 | name | string | required | ||
| 2 | version | string | optional | ||
| 3 | beta | bool | optional |
| Key | Field | Type | Description | Requiredness | Default value |
|---|---|---|---|---|---|
| 1 | userAgentString | string | For Web submissions: The raw HTTP
An example User-Agent string value (for Chrome):
Note that as of April 2020 (Ophan PR #3719), Ophan only populates this field for Web submissions - submissions from Guardian Native-Apps are sent by HTTP library (eg 'OkHttp'), rather than web browser, and so would only serve to identify the HTTP library, which wouldn't be interesting to us. | optional | |
| 2 | type | UserAgentType | Classification of the user agent (eg 'BROWSER', 'ROBOT', etc) by the Ophan stack. Currently processing of the User-Agent string is done first by Yauaa ('Yet Another UserAgent Analyzer' -
https://try.yauaa.basjes.nl/) and then Ophan Slab's | optional | |
| 3 | os | NameAndVersion | The operating system this request was made from | optional | |
| 4 | family | NameAndVersion | The family name and version of the user agent e.g. Firefox 13.0 or iOS Core 3.1.1 | optional | |
| 5 | device | DeviceType | Device class of this user agent | optional | |
| 6 | model | nativeapp.Device | Full device model and manufacturer Only populated for native apps, where this data is available. | optional | |
| 7 | rendererInfo | renderer.RendererInfo | When classifying the experience that a user had when visiting our site, we make a distinction between the Renderer in use, which may vary significantly on the same device, such as a native app vs a web browser, and the physical device that was used to view the content. | optional | |
| 8 | isMobile | bool | this represents a device of at least two form-factors, a 'mobile' or a 'tablet', and it is based on data extracted from the user-agent, which therefore makes it a reasonable guess, but as this is quite a fuzzy distinction, this shouldn't be considered as being 100% accurate. | optional | |
| 9 | mobileClass | MobileClass | optional |
Details about the user agent (browser or native application) that made this request