Client detected

Learn how to track information about devices and browsers.

This event tracks information about the device and software used to access the application, including details of the device, operating system and browser.

Croct's mascot amazed
Automatically tracked

The SDK automatically tracks this event when a user enters the website.

Input properties

This event has no input properties.

Processed properties

These properties are automatically tracked:

client
object

The available information about the client.

device
object

The device used by the client.

name(optional)
string

The name of the device. For example, "iPhone 11 Pro" or "MacBook Pro".

vendor(optional)
string

The vendor or manufacturer of the device. For example, "Apple" or "Samsung".

category
string

The category of the device. The possible values are:

ValueDescription
desktopA desktop computer.
tabletA tablet device.
mobileA mobile phone.
botBots or crawlers.
otherAny other device.
unknownAn unknown device.
operatingSystem
object

The operating system of the device.

name(optional)
string

The name of the operating system. For example, "iOS", "Android", or "Windows".

version(optional)
string

The operating system's version. For example, "10.0.18363", "13.3", or "10".

browser
object

The browser used by the client.

name(optional)
string

The browser's name. For example, "Chrome", "Safari", or "Firefox".

version(optional)
string

The browser's version. For example, "78.0.3904.108", "13", or "71.0".

type
string

The browser type. The possible values are:

ValueDescription
webA standard web browser.
in-appA browser embedded in an application.
crawlerA search engine bot or crawler.
otherAny other browser, like proxies or feed readers.
unknownAn unknown browser type.

Payload examples

Below is a payload example for this event:

12345678910111213141516171819
{  "type": "clientDetected",  "client": {    "device": {      "name": "MacBook Pro",      "vendor": "Apple",      "type": "desktop",      "operatingSystem": {        "name": "iOS",        "version": "10.0.18363"      },    },    "browser": {      "name": "Chrome",      "version": "78.0.3904.108"      "type": "web",    }  }}