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

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

Сервис

Для управления условиями нацеливания для динамических объявлений предназначен сервис DynamicFeedAdTargets.

Методы

Редактирование условий нацеливания для динамических объявлений не предусмотрено. Если требуется изменить условие нацеливания, необходимо удалить его и создать новое условие.

Ограничения

Условие нацеливания для динамических объявлений может быть добавлено только в группу объявлений с типом DYNAMIC_TEXT_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


Поле фида	Операторы	Ограничения на значения
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 диапазонов, целые числа, см. пример.


Поле фида	Операторы	Ограничения на значения
Р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 диапазонов, см. пример.


Поле фида	Операторы	Ограничения на значения
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 знаков после запятой, см. пример.


Поле фида	Операторы	Ограничения на значения
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 знаков после запятой


Поле фида	Операторы	Ограничения на значения
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 знаков после запятой


Поле фида	Операторы	Ограничения на значения
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.


Состояние	Описание
ON	Показы объявлений по условию нацеливания для динамических объявлений возможны.
OFF	Условие нацеливания для динамических объявлений еще не применяется.
SUSPENDED	Показы по условию нацеливания для динамических объявлений остановлены владельцем (с помощью метода suspend или в веб-интерфейсе).
DELETED	Условие нацеливания для динамических объявлений удалено владельцем. Примечание. Метод get возвращает условие нацеливания для динамических объявлений в состоянии DELETED, только если в параметре States указано значение DELETED или в параметре Ids указан идентификатор этого условия. Если параметры Ids и States оба не заданы, метод не возвращает условий нацеливания в состоянии DELETED.
UNKNOWN	Неизвестное состояние. Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API.

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

Расскажите, что вам не понравилось в статье:

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

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

В этой статье

Сервис Ограничения Тип отбора товарных предложений Правило отбора Состояние условия нацеливания для динамических объявлений

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

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