Filter by computed data

You can use data received from or computed by Toloka to select Tolokers. For example, a device technical characteristics or the type of client app.

Define the assignments_issuing_config.filter object in the pool parameters.

Sample filter in JSON

This example selects Tolokers with the Windows OS and Chrome browser.

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

Key and value parameters

Key parameter	Value description
`region_by_phone`	integer The Toloker's region detected from the mobile phone number (the region ID in the search database). Value of `operator`: `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. Value of `value` if data couldn't be extracted — `null`.
`region_by_ip`	integer The Toloker's region detected from the IP address (the region ID in the search database). Value of `operator`: `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. Value of `value` if data couldn't be extracted — `null`.
`device_category`	string Type of device: `PERSONAL_COMPUTER` — A personal computer. `SMARTPHONE` — A smartphone. `TABLET` — A tablet. The complete list is available on the UADetector library page. Value of `operator`: `EQ` — Equal to. `NE` — Not equal to. Value of `value` if data couldn't be extracted — `UNKNOWN`.
`client_type`	string Type of client application: `BROWSER` — A web browser. `TOLOKA_APP` — Toloka mobile app. Value of `operator`: `EQ` — Equal to. `NE` — Not equal to. Value of `value` if data couldn't be extracted — `UNKNOWN`.
`os_family`	string The OS family, for example: `WINDOWS`: Microsoft Windows operating system developed and marketed by Microsoft for personal computers. `ANDROID`: Android mobile operating system based on a modified version of the Linux kernel, designed primarily for touchscreen mobile devices. `IOS`: iOS mobile operating system developed by Apple Inc. exclusively for its mobile devices. `OS_X`: macOS operating system developed by Apple Inc. since 2001 for Mac computers. `LINUX`: A family of open-source Unix-like operating systems based on the Linux kernel. The complete list is available on the UADetector library page. Value of `operator`: `EQ` — Equal to. `NE` — Not equal to. Value of `value` if data couldn't be extracted — `UNKNOWN`.
`user_agent_type`	string Browser type: `BROWSER` — Desktop browser. `MOBILE_BROWSER` — Mobile browser. `OTHER` — Other. The complete list is available on the UADetector library page. Value of `operator`: `EQ` — Equal to. `NE` — Not equal to. Value of `value` if data couldn't be extracted — `UNKNOWN`.
`user_agent_family`	string The browser family, for example: `CHROME` `CHROME_MOBILE` `CHROMIUM` `FIREFOX` `IE` `IE_MOBILE` `MOBILE_FIREFOX` `MOBILE_SAFARI` `SAFARI` `YANDEX_BROWSER` The complete list is available on the UADetector library page. Value of `operator`: `EQ` — Equal to. `NE` — Not equal to. Value of `value` if data couldn't be extracted — `UNKNOWN`.
`user_agent_version`	float Full browser version: `<Major version>.<Minor version>.` Value of `operator`: `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. Value of `value` if data couldn't be extracted — `null`.

Filter by computed data

Sample filter in JSON

Key and value parameters

See also