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

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

Сервис

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

Методы

add | delete | suspend | resume | get | setBids

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

Ограничения

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

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

EXISTS

Передайте значение 1

age

EQUALS_ANY

Допустимые значения: целое число от 0 до 12, 16 или 18.

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

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 символов в строке

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 символов в строке

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 символов в строке

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.