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

Язык запросов 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 И находятся в состоянии «Идут показы»
| Логическое «ИЛИ» в сложных запросах = название ~ спички | название ~ сахар Отбираются объявления, в названии которых содержится слово «спички» ИЛИ слово «сахар»
Внимание.

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