Фильтр — условие нацеливания для смарт-баннеров (SmartAdTarget)
Фильтр определяет набор товарных предложений из фида, для которых динамически генерируются смарт-баннеры. Подробнее о фильтрах см. в разделе Настройка фильтров помощи Директа.
Сервис
Ограничения
Фильтр может быть добавлен только в группу объявлений с типом SMART_AD_GROUP.
Не более 50 фильтров в группе.
Тип отбора товарных предложений
Предусмотрено два типа отбора:
ITEMS_ALL — «Выбрать все».
Смарт-баннеры будут генерироваться для всех товарных предложений из фида.
ITEMS_SUBSET — «Группа страниц».
Фильтр содержит до 10 правил отбора. Смарт-баннеры будут генерироваться только для тех товарных предложений, которые удовлетворяют одновременно всем правилам отбора.
Правило отбора
Правило отбора состоит из трех параметров:
- Operand — поле фида;
- Operator — оператор сравнения;
- Arguments — массив значений, с которыми сравнивается значение поля в фиде.
Описание полей для каждого типа фида представлено в разделе Настройка фильтров помощи Директа.
Совместимость полей фида и операторов зависит от фида:
- 0
- 1
- 0
- 1
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
- левый
- правый
- да
- нет
- в наличии
- на заказ
- левый
- правый
- да
- нет
- в наличии
- на заказ
Поле фида | Операторы | Ограничения на значения |
---|---|---|
categoryId | GREATER_THAN, LESS_THAN | Одно число |
EQUALS_ANY | До 20 000 чисел | |
RANGE | До 10 диапазонов, см. пример. | |
id | GREATER_THAN, LESS_THAN | Одно число |
EQUALS_ANY | До 50 чисел | |
RANGE | До 10 диапазонов, см. пример. | |
market_category typePrefix vendor | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
description model name | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
url | EQUALS,CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
oldprice price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. | |
EXISTS | Передайте значение 1 | |
adult manufacturer_warranty pickup store | EQUALS_ANY | Допустимые значения: |
EXISTS | Передайте значение 1 | |
age | EQUALS_ANY | Допустимые значения: целое число от 0 до 12, 16 или 18. |
EXISTS | Передайте значение 1 |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
categoryId | GREATER_THAN, LESS_THAN | Одно число |
EQUALS_ANY | До 20 000 чисел | |
RANGE | До 10 диапазонов, см. пример. | |
id | GREATER_THAN, LESS_THAN | Одно число |
EQUALS_ANY | До 50 чисел | |
RANGE | До 10 диапазонов, см. пример. | |
market_category typePrefix vendor | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
description model name | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
url | EQUALS,CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
oldprice price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. | |
EXISTS | Передайте значение 1 | |
adult manufacturer_warranty pickup store | EQUALS_ANY | Допустимые значения: |
EXISTS | Передайте значение 1 | |
age | EQUALS_ANY | Допустимые значения: целое число от 0 до 12, 16 или 18. |
EXISTS | Передайте значение 1 |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
Рrice | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. | |
Description max_score name location url | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
class | EQUALS_ANY | Допустимые значения: |
EXISTS | Передайте значение 1 | |
OfferID score | GREATER_THAN, LESS_THAN | Одно целое число |
EQUALS_ANY | До 50 целых чисел | |
RANGE | До 10 диапазонов, целые числа, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
Рrice | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. | |
Description max_score name location url | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
class | EQUALS_ANY | Допустимые значения: |
EXISTS | Передайте значение 1 | |
OfferID score | GREATER_THAN, LESS_THAN | Одно целое число |
EQUALS_ANY | До 50 целых чисел | |
RANGE | До 10 диапазонов, целые числа, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
body_type color folder_id mark_id | CONTAINS_ANY, NOT_CONTAINS_ALL, | До 50 строк, не более 175 символов в строке |
wheel | CONTAINS_ANY | Рекомендуемые значения: |
metallic | EQUALS_ANY | Рекомендуемые значения: |
availability | EQUALS_ANY | Рекомендуемые значения: |
year | EQUALS_ANY | До 10 чисел |
url | CONTAINS_ANY, NOT_CONTAINS_ALL, EQUALS_ANY | До 50 строк, не более 175 символов в строке |
price | GREATER_THAN, LESS_THAN | Одно целое число |
EQUALS_ANY | До 50 целых чисел | |
RANGE | До 10 диапазонов, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
body_type color folder_id mark_id | CONTAINS_ANY, NOT_CONTAINS_ALL, | До 50 строк, не более 175 символов в строке |
wheel | CONTAINS_ANY | Рекомендуемые значения: |
metallic | EQUALS_ANY | Рекомендуемые значения: |
availability | EQUALS_ANY | Рекомендуемые значения: |
year | EQUALS_ANY | До 10 чисел |
url | CONTAINS_ANY, NOT_CONTAINS_ALL, EQUALS_ANY | До 50 строк, не более 175 символов в строке |
price | GREATER_THAN, LESS_THAN | Одно целое число |
EQUALS_ANY | До 50 целых чисел | |
RANGE | До 10 диапазонов, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
description name | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
price oldprice | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
description name | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
price oldprice | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой | |
RANGE | До 10 диапазонов, до 2 знаков после запятой, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
category description name second_title | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
price sale_price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
IN_RANGE | До 10 диапазонов, до 2 знаков после запятой | |
EQUALS_ANY | До 50 значений, до 2 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
category description name second_title | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
price sale_price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
IN_RANGE | До 10 диапазонов, до 2 знаков после запятой | |
EQUALS_ANY | До 50 значений, до 2 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
Category destination origin Title | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
price sale_price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
IN_RANGE | До 10 диапазонов, до 2 знаков после запятой | |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
Category destination origin Title | CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
EXISTS | Передайте значение 1 | |
url | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | До 50 строк, не более 175 символов в строке |
price sale_price | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой |
IN_RANGE | До 10 диапазонов, до 2 знаков после запятой | |
EQUALS_ANY | До 50 чисел, до 2 знаков после запятой |
Примеры
- Значение содержит одну из заданных строк
-
{ "Operand": "mark_id", "Operator": "CONTAINS_ANY", "Arguments": ["Audi","Opel"] }
- Диапазон: цена от 111 до 222 или от 3000 до 10000
-
{ "Operand": "price", "Operator": "IN_RANGE", "Arguments": ["111-222", "3000-10000"] }
- Значение из списка
-
{ "Operand": "wheel", "Operator": "EQUALS_ANY", "Arguments": ["левый"] }
Состояние фильтра
Параметр State отражает текущее состояние показов по фильтру.
Состояние | Описание |
---|---|
ON | Показы по фильтру возможны. |
OFF | Фильтр еще не применяется. |
SUSPENDED | Показы по фильтру остановлены владельцем (с помощью метода suspend или в веб-интерфейсе). |
DELETED | Фильтр удален владельцем. Примечание. Метод get возвращает фильтр в состоянии DELETED, только если в параметре States указано значение DELETED или в параметре Ids указан идентификатор этого фильтра. Если параметры Ids и States оба не заданы, метод не возвращает фильтры в состоянии DELETED. |
UNKNOWN | Неизвестное состояние. Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API. |
Состояние | Описание |
---|---|
ON | Показы по фильтру возможны. |
OFF | Фильтр еще не применяется. |
SUSPENDED | Показы по фильтру остановлены владельцем (с помощью метода suspend или в веб-интерфейсе). |
DELETED | Фильтр удален владельцем. Примечание. Метод get возвращает фильтр в состоянии DELETED, только если в параметре States указано значение DELETED или в параметре Ids указан идентификатор этого фильтра. Если параметры Ids и States оба не заданы, метод не возвращает фильтры в состоянии DELETED. |
UNKNOWN | Неизвестное состояние. Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API. |