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

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

Сервис

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

Методы

add | delete | suspend | resume | get | setBids

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

Ограничения

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

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