Filter by computed data

You can use data received from or computed by Toloka to select users:

  • Technical details of devices.

  • The user's rating (calculated from the total amount earned in Toloka).

Define the filter object in the pool parameters.

Sample filter in JSON

This example selects users with the Windows OS and Yandex browser.

"filter" : {
    "and" : [ {
      "operator" : "EQ",
      "category" : "computed",
      "key" : "os_family",
      "value" : "WINDOWS"
    }, {
      "operator" : "EQ",
      "category" : "computed",
      "key" : "user_agent_family",
      "value" : "YANDEX_BROWSER"
    } ]
  }

"key" and "value" keys

Value of "key"

Value of "value"

Value of "value" if data couldn't be extracted

Data type in "value"

Value of "operator"

region_by_phone

The user's region detected from the mobile phone number (the region ID in the search database).

null

Number

  • IN — The region is equal to the one specified or is a part of it.
  • NOT_IN — The region is not equal to the one specified and is not a part of it.
region_by_ip

The user's region detected from the IP address (the region ID in the search database).

null

Number

device_category

Type of device:

  • PERSONAL_COMPUTER

  • SMARTPHONE

  • TABLET

The complete list is available on the UADetector library page.

UNKNOWN

String

  • EQ — Equal to.
  • NE — Not equal to.
client_type

Type of client application:

  • BROWSER — Web browser.

  • TOLOKA_APP - Toloka mobile app.

UNKNOWN String
os_family

The OS family, for example:

  • WINDOWS

  • ANDROID

  • IOS

  • OS_X

  • MAC_OS

  • LINUX

  • BSD

  • BLACKBERRY

The complete list is available on the UADetector library page.

UNKNOWN

String

os_version

Full operating system version: <Major version>.<Minor version>. For example, 14.4.

null

Floating-point number

  • EQ — Equal to.
  • NE — Not equal to.
  • GT — Greater than.
  • LT — Less than.
  • GTE — Greater than or equal to.
  • LTE — Less than or equal to.
os_version_major

The OS major version. For example, 14.

null

Integer

os_version_minor

The OS minor version. For example, 4.

null

Integer

os_version_bugfix

The OS build number (bugfix version). For example, 1.

null

Integer

user_agent_type

Browser type:

  • BROWSER — Desktop browser.

  • MOBILE_BROWSER — Mobile browser.

  • OTHER — Other.

The complete list is available on the UADetector library page.

UNKNOWN

String

  • EQ — Equal to.
  • NE — Not equal to.
user_agent_family

The browser family, for example:

  • IE

  • IE_MOBILE

  • YANDEX_BROWSER

  • FIREFOX

  • MOBILE_FIREFOX

  • CHROME

  • CHROME_MOBILE

  • CHROMIUM

  • SAFARI

  • MOBILE_SAFARI

The complete list is available on the UADetector library page.

UNKNOWN

String

user_agent_version

Full browser version: <Major version>.<Minor version>.

null

Floating-point number
  • EQ — Equal to.
  • NE — Not equal to.
  • GT — Greater than.
  • LT — Less than.
  • GTE — Greater than or equal to.
  • LTE — Less than or equal to.
user_agent_version_major

Major version of the browser.

null

Integer

user_agent_version_minor

Minor version of the browser.

null

Integer

user_agent_version_bugfix

The browser's build number (bugfix version).

null

Integer

rating

The user's rating. Calculated from earnings in all projects available to the users.

Floating-point number