Директ Коммандер
Обмен данными с сервером

Язык запросов

Язык запросов Direct Commander Query Language позволяет создавать сложные критерии для отбора объектов: накладывать различные условия на значения полей и комбинировать их с помощью логических операторов.

Запрос вводится в строке текстового фильтра внизу любой панели Коммандера. Запрос с использованием логических операторов начинается с символа =.

Составление запроса

Простой запрос состоит из трех частей:

= Поле Оператор Значение

Например, запрос заголовок ~ сухари покажет все объявления, у которых в столбце Заголовок содержится слово «сухари».

Начните вводить запрос с символа =. При этом в строке ввода появляется значок Названия полей и операторы можно выбирать из всплывающих подсказок.

При вводе значения обратите внимание:

  • Регистр символов не учитывается.

  • Если значение состоит из нескольких слов, разделенных пробелами, для корректной обработки запроса возьмите в кавычки все выражение:

    = заголовок = "сухари впрок"
  • Если нужно найти фразу, заключенную в кавычки, для корректной обработки запроса с двойными кавычками используйте символ \:

    = заголовок = "\"сухари впрок\""
  • Если нужно указать несколько значений, используйте квадратные скобки:

    = заголовок = ["спички"; "сухари"]

    или

    = заголовок = [спички сухари]

  • Если поле может содержать фиксированный набор значений (Модерация, Состояние, Приоритет и т. д.), то используйте операторы ~ и !~ с квадратными скобками, даже если значение только одно.

Если запрос составлен неправильно, значок в строке ввода меняется на и появляется сообщение об ошибке.

Запросы из нескольких условий

Для составления комбинированных запросов можно использовать операторы & (логическое И) и | (логическое ИЛИ).

Условия в запросе выполняются строго слева направо, но можно изменить порядок с помощью круглых скобок. Условия, заключенные в скобки, имеют приоритет над стандартной последовательностью.

Пример 1

= Слова ~ спички | Слова ~ сахар

По этому запросу отбираются фразы, в которых есть ключевое слово «спички» или «сахар».

Пример 2

= Слова ~ спички | Слова ~ сахар & Ставка > 1

По этому запросу отбираются фразы, которые отвечают одновременно двум условиям:

  1. Содержат слово «спички» или слово «сахар».
  2. Имеют ставку на поиске больше 1.

Пример 3

= Слова ~ спички | (Слова ~ сахар & Ставка > 1)

По этому запросу отбираются фразы, которые соответствуют хотя бы одному из двух условий:

  1. Содержат слово «спички».
  2. Содержат слово «сахар» и имеют ставку на поиске больше 1.

Операторы языка запросов

В зависимости от поля в DCQL применяются следующие типы операторов.

ОператорЗначениеПримерРезультат
~Содержит= геотаргетинг ~ австрОтбираются группы объявлений, у которых в столбце Геотаргетинг указано «Австралия» или «Австрия»
= "Имя изображения" ~ [black white]Отбираются объявления, у которых в столбце Имя изображения указано имя, содержащее подстроку «black» или «white»
= Модерация ~ [Принято; Черновик]Отбираются объявления, у которых в столбце Модерация указано значение «Принято» или «Черновик»
!~Не содержит= геотаргетинг !~ австрОтбираются группы объявлений, кроме тех, у которых указан геотаргетинг «Австралия» или «Австрия»
= заголовок !~ [спички сухари]Отбираются объявления, у которых значение в столбце Заголовок не содержит подстрок «спички» и «сухари»
= Модерация !~ [Ожидает]Отбираются объявления, у которых в столбце Модерация указано любое значение, кроме «Ожидает».
=Равно/совпадает= геотаргетинг = АвстралияОтбираются только те группы, у которых указан геотаргетинг «Австралия»
= Номер = [111111 222222]Отбираются объявления с номерами 111111 и 222222.
!=Не равно/не совпадает= геотаргетинг != АвстралияОтбираются группы, кроме тех, у которых указан геотаргетинг «Австралия»
= Номер != [111111 222222]Отбираются объявления с номерами, отличными от 111111 и 222222.
>Больше= ctr > 0.5Отбираются фразы с CTR больше 0,5
<Меньше= ctr < 0.5Отбираются фразы с CTR меньше 0,5
>=Больше либо равно= Ставка >= 1Отбираются фразы, у которых ставка на поиске больше либо равна 1
<=Меньше либо равно= Ставка <= 1Отбираются фразы, у которых ставка на поиске меньше либо равна 1
&Логическое «И» в сложных запросах= номер ~ 123 & состояние = "идут показы"Отбираются объявления, которые в номере содержат цифры 123 И находятся в состоянии «Идут показы»
|Логическое «ИЛИ» в сложных запросах= название ~ спички | название ~ сахарОтбираются объявления, в названии которых содержится слово «спички» ИЛИ слово «сахар»
Внимание! 

Операторы >, >=, < и <= можно использовать только для столбцов с числовыми значениями.