Условие нацеливания для динамических объявлений (DynamicFeedAdTarget)
Условие нацеливания определяет набор страниц сайта рекламодателя, для которых динамически генерируются объявления. Подробнее о динамических объявлениях см. в разделе Динамические объявления помощи Директа.
Сервис
Для управления условиями нацеливания для динамических объявлений предназначен сервис DynamicFeedAdTargets.
Методы
add | delete | suspend | resume | get | setBids
Редактирование условий нацеливания для динамических объявлений не предусмотрено. Если требуется изменить условие нацеливания, необходимо удалить его и создать новое условие.
Ограничения
Условие нацеливания для динамических объявлений может быть добавлено только в группу объявлений с типом DYNAMIC_TEXT_AD_GROUP.
Не более 50 условий нацеливания для динамических объявлений в группе.
Тип отбора товарных предложений
Предусмотрено два типа отбора:
ITEMS_ALL — «Выбрать все».
Динамические объявления будут генерироваться для всех товарных предложений из фида.
ITEMS_SUBSET — «Группа страниц».
Фильтр содержит до 10 правил отбора. Динамические объявления будут генерироваться только для тех товарных предложений, которые удовлетворяют одновременно всем правилам отбора.
Правило отбора
Правило отбора страниц состоит из трех параметров:
- Operand — поле фида;
- Operator — оператор сравнения;
- Arguments — массив значений, с которыми сравнивается значение поля в фиде.
Описание полей для каждого типа фида представлено в разделе Настройка фильтров помощи Директа.
Совместимость полей фида и операторов зависит от фида:
- 0
- 1
- 0
- 1
- 1
- 2
- 3
- 4
- 5
- 1
- 2
- 3
- 4
- 5
- левый
- правый
- да
- нет
- в наличии
- на заказ
- левый
- правый
- да
- нет
- в наличии
- на заказ
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 | Допустимые значения: |
EXISTS | Передайте значение 1 | |
age | EQUALS_ANY | Допустимые значения: целое число от 0 до 12, 16 или 18. |
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 символов в строке |
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 | Допустимые значения: |
EXISTS | Передайте значение 1 | |
age | EQUALS_ANY | Допустимые значения: целое число от 0 до 12, 16 или 18. |
EXISTS | Передайте значение 1 |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
Р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 | Допустимые значения: |
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 | Допустимые значения: |
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 диапазонов, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 знаков после запятой, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 знаков после запятой, см. пример. |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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 знаков после запятой |
Поле фида | Операторы | Ограничения на значения |
---|---|---|
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. |
Состояние | Описание |
---|---|
ON | Показы объявлений по условию нацеливания для динамических объявлений возможны. |
OFF | Условие нацеливания для динамических объявлений еще не применяется. |
SUSPENDED | Показы по условию нацеливания для динамических объявлений остановлены владельцем (с помощью метода suspend или в веб-интерфейсе). |
DELETED | Условие нацеливания для динамических объявлений удалено владельцем. Примечание. Метод get возвращает условие нацеливания для динамических объявлений в состоянии DELETED, только если в параметре States указано значение DELETED или в параметре Ids указан идентификатор этого условия. Если параметры Ids и States оба не заданы, метод не возвращает условий нацеливания в состоянии DELETED. |
UNKNOWN | Неизвестное состояние. Используется для обеспечения обратной совместимости и отображения состояний, не поддерживаемых в данной версии API. |