Фильтр по вычислимым данным

Вы можете отобрать исполнителей по данным, которые получены или вычислены Яндекс Заданиями. Например, по техническим характеристикам устройств или по типу клиентского приложения.

Определите объект filter в параметрах пула.

Пример фильтра в JSON

В примере отобраны исполнители с операционной системой Windows и Яндекс Браузером.

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

Параметры key, value

Параметр key

Описание value

region_by_phone

integer

Регион исполнителя, определяется по номеру мобильного телефона (идентификатор региона в поисковой базе).

Значение operator:

  • IN — регион равен указанному или является его частью;
  • NOT_IN — регион не равен указанному и не является его частью.

Значение value, если не удалось извлечь данные — null.

region_by_ip

integer

Регион исполнителя, определяется по IP-адресу (идентификатор региона в поисковой базе).

Значение operator:

  • IN — регион равен указанному или является его частью;
  • NOT_IN — регион не равен указанному и не является его частью.

Значение value, если не удалось извлечь данные — null.

device_category

string

Тип устройства:

  • PERSONAL_COMPUTER — персональный компьютер или устройство семейства Apple Mac;
  • SMARTPHONE — мобильный телефон с одной из доступных операционных систем;
  • TABLET — планшет.

Полный список доступен на странице библиотеки UADetector.

Значение operator:

  • EQ — равно;
  • NE — не равно.

Значение value, если не удалось извлечь данные — UNKNOWN.

client_type

string

Тип клиентского приложения:

  • BROWSER — браузер;
  • TOLOKA_APP — мобильное приложение Яндекс Заданий.

Значение operator:

  • EQ — равно;
  • NE — не равно.

Значение value, если не удалось извлечь данные — UNKNOWN.

os_family

string

Семейство операционной системы, например:

  • WINDOWS — операционная система Microsoft Windows, разработанная компанией Microsoft для персональных компьютеров;
  • ANDROID — мобильная операционная система Android, основанная на модифицированном ядре Linux, разработанная для мобильных устройств с сенсорным экраном;
  • IOS — мобильная операционная система iOS, разработанная компанией Apple Inc. исключительно для собственных мобильных устройств;
  • OS_X — операционная система macOS, разрабатывающаяся компанией Apple Inc. с 2001 для компьютеров Mac;
  • LINUX — семейство Unix-подобных операционных систем с открытым исходным кодом, основанное на ядре Linux.

Полный список доступен на странице библиотеки UADetector.

Значение operator:

  • EQ — равно;
  • NE — не равно.

Значение value, если не удалось извлечь данные — UNKNOWN.

user_agent_type

string

Тип браузера:

  • BROWSER — десктопный браузер;
  • MOBILE_BROWSER — мобильный браузер;
  • OTHER — идентификационная строка клиентского приложения, которая не определилась как десктопный или мобильный браузер. Если исполнитель использует мобильное приложение, то user agent будет определен как OTHER.

Полный список доступен на странице библиотеки UADetector.

Значение operator:

  • EQ — равно;
  • NE — не равно.

Значение value, если не удалось извлечь данные — UNKNOWN.

user_agent_family

string

Семейство браузера, например:

  • IE — десктопная версия Microsoft Internet Explorer;
  • IE_MOBILE — мобильная версия Microsoft Internet Explorer;
  • YANDEX_BROWSER — Яндекс Браузер (десктопная или мобильная версия);
  • FIREFOX — десктопная версия Mozilla Firefox;
  • MOBILE_FIREFOX — мобильная версия Mozilla Firefox;
  • CHROME — десктопная версия Google Chrome;
  • CHROME_MOBILE — мобильная версия Google Chrome;
  • CHROMIUM — десктопная версия Chromium;
  • SAFARI — десктопная версия Apple Safari;
  • MOBILE_SAFARI — мобильная версия Apple Safari.

Полный список доступен на странице библиотеки UADetector.

Значение operator:

  • EQ — равно;
  • NE — не равно.

Значение value, если не удалось извлечь данные — UNKNOWN.

user_agent_version

float

Полная версия браузера: <Мажорная версия>.<Минорная версия>.

Значение operator:

  • EQ — равно;
  • NE — не равно;
  • GT — больше, чем;
  • LT — меньше, чем;
  • GTE — больше или равно;
  • LTE — меньше или равно.

Значение value, если не удалось извлечь данные — null.