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

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

Сервис

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

Методы

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

Ограничения

Условие нацеливания для динамических объявлений может быть добавлено только в группу объявлений с типом DYNAMIC_TEXT_AD_GROUP.

Не более 50 условий нацеливания для динамических объявлений в группе.

Тип условия нацеливания для динамических объявлений

Предусмотрено два типа условия нацеливания для динамических объявлений:

PAGES_ALL — «Все страницы сайта».
PAGES_SUBSET — «Группа страниц».

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

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

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

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

Совместимость операндов и операторов представлена в таблице ниже.


Operand	Описание	Применимые операторы
DOMAIN	Домен (любого уровня)	CONTAINS_ANY Operand содержит одну из строк массива Arguments. NOT_CONTAINS_ALL Operand не содержит ни одной из строк массива Arguments. Регистр символов не учитывается.
URL	Ссылка на товар
PAGE_TITLE	Заголовок страницы
PAGE_CONTENT	Контент страницы
OFFERS_LIST_URL	URL списка предложений (страница со списком товаров, например страница товарной категории или страница результатов поиска по заданным параметрам)	EQUALS_ANY Operand равен одной из строк массива Arguments. NOT_EQUALS_ALL Operand не равен ни одной из строк массива Arguments. Протокол (http:// или https://) при сравнении не учитывается.


Operand	Описание	Применимые операторы
DOMAIN	Домен (любого уровня)	CONTAINS_ANY Operand содержит одну из строк массива Arguments. NOT_CONTAINS_ALL Operand не содержит ни одной из строк массива Arguments. Регистр символов не учитывается.
URL	Ссылка на товар
PAGE_TITLE	Заголовок страницы
PAGE_CONTENT	Контент страницы
OFFERS_LIST_URL	URL списка предложений (страница со списком товаров, например страница товарной категории или страница результатов поиска по заданным параметрам)	EQUALS_ANY Operand равен одной из строк массива Arguments. NOT_EQUALS_ALL Operand не равен ни одной из строк массива Arguments. Протокол (http:// или https://) при сравнении не учитывается.

Примечание. Условие нацеливания для динамических объявлений может содержать не более одного правила с операндом OFFERS_LIST_URL и оператором EQUALS_ANY, а также не более одного правила с операндом OFFERS_LIST_URL и оператором NOT_EQUALS_ALL.

Состояние условия нацеливания для динамических объявлений

Параметр 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.