Фильтр — условие нацеливания для смарт-баннеров (SmartAdTarget)

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

Сервис

Для управления фильтрами предназначен сервис SmartAdTargets.

Методы

Ограничения

Фильтр может быть добавлен только в группу объявлений с типом SMART_AD_GROUP.

Не более 50 фильтров в группе.

Тип отбора товарных предложений

Предусмотрено два типа отбора:

ITEMS_ALL — «Выбрать все».

Смарт-баннеры будут генерироваться для всех товарных предложений из фида.
ITEMS_SUBSET — «Группа страниц».

Фильтр содержит до 10 правил отбора. Смарт-баннеры будут генерироваться только для тех товарных предложений, которые удовлетворяют одновременно всем правилам отбора.

Примечание

Для фида Яндекс Недвижимости и фида «Авиабилеты» Google Рекламы предусмотрен только тип отбора ITEMS_ALL.

Правило отбора

Правило отбора состоит из трех параметров:

Operand — поле фида;
Operator — оператор сравнения;
Arguments — массив значений, с которыми сравнивается значение поля в фиде.

Описание полей для каждого типа фида представлено в разделе Настройка фильтров помощи Директа.

Совместимость полей фида и операторов зависит от фида:

Розничная торговля, другой бизнес: фид Яндекс Маркета

Поле фида	Операторы	Ограничения на значения
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 символов в строке
market_category typePrefix vendor	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	Допустимые значения: 0 1
adult manufacturer_warranty pickup store	EXISTS	Передайте значение 1
age	EQUALS_ANY	Допустимые значения: целое число от 0 до 12, 16 или 18.
age	EXISTS	Передайте значение 1

Отели: фид «Отели и аренда жилья» Google Рекламы

Поле фида	Операторы	Ограничения на значения
Р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	Допустимые значения: 1 2 3 4 5
class	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 диапазонов, см. пример.

Недвижимость: фид Яндекс Недвижимости

Правила отбора для такого фида не предусмотрены.

Авиабилеты: фид «Авиабилеты» Google Рекламы

Правила отбора для такого фида не предусмотрены.

Другой бизнес: универсальный фид

Поле фида	Операторы	Ограничения на значения
url	EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL	До 50 строк, не более 175 символов в строке
description name	CONTAINS_ANY, NOT_CONTAINS_ALL	До 50 строк, не более 175 символов в строке
description name	EXISTS	Передайте значение 1
price oldprice	GREATER_THAN, LESS_THAN	Одно число, до 2 знаков после запятой
	EQUALS_ANY	До 50 чисел, до 2 знаков после запятой
	RANGE	До 10 диапазонов, до 2 знаков после запятой, см. пример.

Другой бизнес: фид «Специальный» Google Рекламы

Поле фида	Операторы	Ограничения на значения
category description name second_title	CONTAINS_ANY, NOT_CONTAINS_ALL	До 50 строк, не более 175 символов в строке
category description name second_title	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 знаков после запятой

Другой бизнес: фид «Путешествия» Google Рекламы

Поле фида	Операторы	Ограничения на значения
Category destination origin Title	CONTAINS_ANY, NOT_CONTAINS_ALL	До 50 строк, не более 175 символов в строке
Category destination origin Title	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.

Была ли статья полезна?

Фид (Feed)

Условие нацеливания для динамических объявлений (DynamicFeedAdTarget)