---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/objects/ad.md
  - https://yandex.com/dev/direct/doc/ru/objects/ad.md
  - href: ru/objects/ad.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/dg/objects/ad.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# Объявление (Ad)

Объявление представляет собой рекламно-информационный материал. Набор параметров объявления зависит от его типа.

## Узнайте больше

* [Ведение кампании](https://yandex.com/dev/direct/doc/ru/best-practice/launch-campaign.md).

## Сервис {#service}

Для управления объявлениями предназначен сервис [Ads](https://yandex.ru/dev/direct/doc/ref-v5/ads/ads.html).

### Методы

[add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html) | [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html) | [delete](https://yandex.ru/dev/direct/doc/ref-v5/ads/delete.html) | [suspend](https://yandex.ru/dev/direct/doc/ref-v5/ads/suspend.html) | [resume](https://yandex.ru/dev/direct/doc/ref-v5/ads/resume.html) | [archive](https://yandex.ru/dev/direct/doc/ref-v5/ads/archive.html) | [unarchive](https://yandex.ru/dev/direct/doc/ref-v5/ads/unarchive.html) | [moderate](https://yandex.ru/dev/direct/doc/ref-v5/ads/moderate.html) |[get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html) 

Для работы с товарными объявлениями используется адрес `https://api.direct.yandex.com/v501/`.


## Ограничения {#restrictions}

Тип объявления должен соответствовать типу группы, см. таблицу в разделе [Тип объявления](#types).

Никакие операции с объявлениями в архивной кампании невозможны.

Ограничение на количество объявлений в группе можно получить с помощью метода [Clients](https://yandex.ru/dev/direct/doc/ref-v5/clients/clients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/clients/get.html) или [AgencyClients](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/agencyclients.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/agencyclients/get.html) (элемент ADS_TOTAL_PER_ADGROUP массива [Restrictions](*Restrictions)).

Ограничения на параметры объявления см. в разделе [Количественные ограничения](https://yandex.ru/support/direct/troubleshooting/interface.html#limitations) Справки Директа.


{% note info %}

- Объявление на белорусском языке можно добавить только в группу, у которой регионы показа ограничены Беларусью.
- Объявление на казахском языке можно добавить только в группу, у которой регионы показа ограничены Казахстаном.
- Объявление на турецком языке можно добавить только в группу, у которой регионы показа ограничены Турцией.

{% endnote %}



## Тип объявления {#types}

<!-- source: ru/_includes/update-tga.md -->
{% note alert " " %}

С 30 июня текстово-графические объявления в Единых перфоманс-кампаниях доступны только для редактирования. Для задач, которые раньше решались с помощью текстово-графических объявлений, создавайте комбинаторные.

С 14 июля началось обновление существующих текстово-графических объявлений до комбинаторных. Статистика и настройки, которые вы задавали изначально, после обновления сохранятся.

[Подробнее об изменениях](https://yandex.ru/dev/direct/doc/ru/update-tga)

{% endnote %}
<!-- endsource: ru/_includes/update-tga.md -->

Тип объявления задается при создании и недоступен для изменения.

В настоящее время существуют следующие типы объявлений:

- TEXT_AD — текстово-графическое (обычное) объявление.

    Объявление содержит заголовок и текст объявления, а также ссылку на продвигаемый сайт. В объявление также можно добавить Турбо-страницу, отображаемую ссылку, изображение, видео, цену, набор [быстрых ссылок](https://yandex.com/dev/direct/doc/ru/objects/sitelink.md), [уточнения](https://yandex.com/dev/direct/doc/ru/objects/adextension.md), идентификатор профиля организации на Яндексе. Объявлению может быть автоматически присвоена [возрастная метка](#age) — в этом случае значение метки можно изменить.

    Чтобы создать или отредактировать текстово-графическое объявление, его параметры необходимо передать в структуре `TextAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления (кроме параметров цены), необходимо перечислить имена параметров во входном параметре `TextAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html). Чтобы получить параметры цены, необходимо перечислить их имена во входном параметре `TextAdPriceExtensionFieldNames`.

- SMART_AD — смарт-баннер.

    Объявление содержит креатив, созданный в конструкторе креативов.

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `SmartAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `SmartAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- MOBILE_APP_AD — объявление для продвижения мобильных приложений.

    Объявление содержит заголовок, текст и возрастное ограничение, а также надпись на кнопке загрузки/установки. В объявление также можно добавить изображение, указать трекинговую ссылку для отслеживания установок и набор дополнений, которые требуется загружать из магазина приложений (иконка, рейтинг и др.). Подробнее о продвижении мобильных приложений см. в разделе [Продвижение мобильных приложений](https://yandex.ru/support/direct/mobile/advertising-mobile-apps.html) Справки Директа.

    Чтобы создать или отредактировать объявление для продвижения мобильных приложений, его параметры необходимо передать в структуре `MobileAppAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры мобильного объявления, необходимо перечислить имена параметров во входном параметре `MobileAppAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- DYNAMIC_TEXT_AD — динамическое объявление.

    Объявление содержит текст. В объявление также можно добавить [изображение](https://yandex.com/dev/direct/doc/ru/objects/adimage.md), [набор быстрых ссылок](https://yandex.com/dev/direct/doc/ru/objects/sitelink.md), [уточнения](https://yandex.com/dev/direct/doc/ru/objects/adextension.md). Подробнее о динамических объявлениях см. в разделе [Динамические объявления](https://yandex.ru/support/direct/dynamic-text-ads/about-da.html) Справки Директа.

    Чтобы создать или отредактировать динамическое объявление, его параметры необходимо передать в структуре `DynamicTextAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `DynamicTextAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- IMAGE_AD — графическое объявление.

    Существуют четыре подтипа графических объявлений:

    - TEXT_IMAGE_AD

      Объявление содержит изображение, а также ссылку на продвигаемый сайт и/или Турбо-страницу.

      Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `TextImageAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

      Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `TextImageAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

    - MOBILE_APP_IMAGE_AD

      Объявление содержит изображение. В объявление также можно добавить трекинговую ссылку для отслеживания установок.

      Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `MobileAppImageAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

      Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `MobileAppImageAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

    - TEXT_AD_BUILDER_AD

      Объявление содержит креатив, созданный в конструкторе креативов, а также ссылку на продвигаемый сайт и/или Турбо-страницу.

      Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `TextAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

      Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `TextAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

    - MOBILE_APP_AD_BUILDER_AD

      Объявление содержит креатив, созданный в конструкторе креативов. В объявление также можно добавить трекинговую ссылку для отслеживания установок.

      Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `MobileAppAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

      Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `MobileAppAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

    {% note alert %}

    Графические объявления показываются только в сетях (Рекламной сети Яндекса и внешних сетях), но не показываются на поиске.

    Показ графического объявления возможен только при условии, что ставка по ключевой фразе или условию нацеливания на аудиторию не ниже минимальной ставки для объявления с включенным в него изображением, указанной на странице [Минимальный и максимальный размер цены за клик](https://yandex.ru/legal/direct_table/).

    {% endnote %}

    Подробнее о графических объявлениях см. в разделе [Графические объявления](https://yandex.ru/support/direct/features/image-ads.html) Справки Директа.

- CPC_VIDEO_AD — видеообъявление в кампаниях с типом «Текстово-графические объявления» или «Реклама мобильных приложений».

    Объявление содержит креатив, созданный в конструкторе креативов, а также ссылку на продвигаемый сайт и/или Турбо-страницу.

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `CpcVideoAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `CpcVideoAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

    В кампаниях с типом «Реклама мобильных приложений» используется отдельный подтип для видеообъявлений — MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD.

    - **MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD**

      Такое объявление содержит креатив, созданный в конструкторе креативов. В объявление также можно добавить трекинговую ссылку для отслеживания установок.

      Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `MobileAppCpcVideoAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

      Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `MobileAppCpcVideoAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- CPM_BANNER_AD — медийный баннер.

    Объявление содержит креатив, загруженный в веб-интерфейсе или созданный в конструкторе креативов, а также ссылку на продвигаемый сайт или и/или Турбо-страницу страницу в соцсети с дополнительной информацией о предложении. В объявление также можно добавить пиксель Яндекс Аудиторий и счетчик показов ADFOX.

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `CpmBannerAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `CpmBannerAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- CPM_VIDEO_AD — медийное видеообъявление (в кампании с типом «Медийная кампания»).

    Объявление содержит креатив, созданный в конструкторе креативов, а также ссылку на продвигаемый сайт или и/или Турбо-страницу страницу в соцсети с дополнительной информацией о предложении. В объявление также можно добавить счетчик показов ADFOX.

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `CpmVideoAdBuilderAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `CpmVideoAdBuilderAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- SHOPPING_AD – товарное объявление (в кампании с типом «Единая перфоманс кампания»).

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `ShoppingAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `ShoppingAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- LISTING_AD – объявление для страниц каталога (в кампании с типом «Единая перфоманс кампания»).

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `ListingAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `ListingAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

- RESPONSIVE_AD – объявление, в котором можно указать несколько заголовков, текстов, изображений и видео.

    В одну группу можно добавить до 3 неархивных комбинаторных объявлений и до 10 объявлений этого типа с учетом архивных.

    Чтобы создать или отредактировать объявление, его параметры необходимо передать в структуре `ResponsiveAd` методов [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html), [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html).

    Чтобы получить параметры объявления, необходимо перечислить имена параметров во входном параметре `ResponsiveAdFieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).


Параметры `Type`, `Subtype`, `Status`, `State`, `StatusClarification`, `AdCategories`, `AgeLabel` являются общими для всех типов объявлений. Чтобы получить их, необходимо перечислить имена нужных параметров во входном параметре `FieldNames` метода [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html).

Соответствие типов объявлений и групп представлено в таблице ниже.

#|
|| **Тип группы** | **Допустимые типы объявлений** ||

|| TEXT_AD_GROUP | TEXT_AD, IMAGE_AD, подтипы TEXT_IMAGE_AD, TEXT_AD_BUILDER_AD, CPC_VIDEO_AD ||

|| SMART_AD_GROUP | SMART_AD ||

|| MOBILE_APP_AD_GROUP | MOBILE_APP_AD, IMAGE_AD, подтипы MOBILE_APP_IMAGE_AD, MOBILE_APP_AD_BUILDER_AD, CPC_VIDEO_AD, подтип MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD ||

|| DYNAMIC_TEXT_AD_GROUP | DYNAMIC_TEXT_AD ||

|| CPM_BANNER_AD_GROUP | CPM_BANNER_AD ||

|| CPM_VIDEO_AD_GROUP | CPM_VIDEO_AD ||

|| UNIFIED_AD_GROUP | TEXT_AD, IMAGE_AD, подтипы TEXT_IMAGE_AD, TEXT_AD_BUILDER_AD, SHOPPING_AD, LISTING_AD, RESPONSIVE_AD ||
|#


## Статус и состояние объявления {#status}

Параметр `State` отражает текущее состояние объявления.

#|
|| **Состояние** | **Описание** ||

|| SUSPENDED | Показы объявления остановлены владельцем с помощью метода [suspend](https://yandex.ru/dev/direct/doc/ref-v5/ads/suspend.html) или в веб-интерфейсе.  ||

|| OFF_BY_MONITORING | Показы объявления автоматически остановлены [мониторингом доступности сайта](https://yandex.ru/support/direct/campaigns/site-monitoring.html). ||

|| ON | Объявление активно, принадлежит к активной кампании и может быть показано (при наличии средств на кампании, в соответствии с настройками временного таргетинга и т. п.).  ||

|| OFF | Объявление неактивно (черновик, ожидает модерации, отклонено) или принадлежит к неактивной либо остановленной кампании.  ||

|| ARCHIVED | Объявление помещено в архив (с помощью метода [archive](https://yandex.ru/dev/direct/doc/ref-v5/ads/archive.html) или пользователем в веб-интерфейсе) или принадлежит к архивной кампании.  ||
|#

Параметр `Status` отражает результат модерации объявления.

#|
|| **Статус** | **Описание** ||

|| DRAFT | Объявление создано и еще не отправлено на модерацию.  ||

|| MODERATION | Объявление находится на модерации.  ||

|| PREACCEPTED | Объявление допущено к показам автоматически, но будет дополнительно проверено модератором.  ||

|| ACCEPTED | Объявление принято модерацией.  ||

|| REJECTED | Объявление отклонено модерацией.  ||
|#


{% note info %}

Если объявление было отредактировано, новая версия ожидает модерации (статус MODERATION) или сразу отклонена модерацией (статус REJECTED), то продолжаются показы предыдущей версии объявления, если оно не было остановлено. В этом случае объявление находится в состоянии ON.

Если после редактирования новая версия объявления была допущена к показам автоматически (PREACCEPTED), а затем отклонена (REJECTED), показы предыдущей версии не возобновляются.

{% endnote %}



## Особая категория {#classification}

На модерации объявлению может быть присвоена отметка о принадлежности продвигаемого товара или услуги к особой категории. При этом у объявления появляется параметр `AdCategories`, недоступный для изменения.

Для некоторых категорий показ объявлений запрещен, для других — при показе объявлений выводятся предупреждения в соответствии с законодательством РФ.

Справочник особых категорий можно получить с помощью метода [Dictionaries](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/dictionaries.html).[get](https://yandex.ru/dev/direct/doc/ref-v5/dictionaries/get.html).

Изменение, присвоение или снятие категории через API недоступно. Если вы не согласны с присвоенной категорией, обратитесь в [службу поддержки](https://yandex.ru/support/direct/troubleshooting/shows.html#warning).


## Возрастная метка {#age}

Параметр `AgeLabel` содержит возрастную категорию продвигаемой продукции, если указание категории требует Федеральный закон РФ «О рекламе». Порядок присвоения возрастной метки отличается в зависимости от типа объявления.


{% list tabs %}

- TEXT_AD

  Значение возрастной метки зависит от принадлежности к [особой категории](#classification) BABY_FOOD:

  - Для объявлений, относящихся к категории BABY_FOOD, — возраст ребенка в месяцах: "MONTHS_0", "MONTHS_1", "MONTHS_2", ..., "MONTHS_12".

  - Для прочих объявлений — возраст, на которую ориентирована информационная продукция. Возможные значения: "AGE_0", "AGE_6", "AGE_12", "AGE_16", "AGE_18".


  Если у объявления отсутствует возрастная метка, задать ее нельзя (значение параметра игнорируется методом `update`).


  {% note alert %}

  Через API можно изменить только значение возрастной категории, если она есть у объявления. Чтобы изменить наличие/отсутствие возрастной категории, пожалуйста, обратитесь в [службу поддержки](https://yandex.ru/support/direct/troubleshooting/moderation.html#dissent).

  {% endnote %}



- MOBILE_APP_AD

  Возрастная метка присваивается всем объявлениям. Возможные значения: "AGE_0", "AGE_6", "AGE_12", "AGE_16", "AGE_18".

  Метку можно указать при создании объявления. Значение по умолчанию — "AGE_18". Значение метки можно изменить при редактировании объявления, но удалить метку нельзя.

{% endlist %}



## Дополнения к объявлению {#addons}

Методы [add](https://yandex.ru/dev/direct/doc/ref-v5/ads/add.html) и [update](https://yandex.ru/dev/direct/doc/ref-v5/ads/update.html) позволяют привязать к объявлению визитку, изображение, видеодополнение, набор быстрых ссылок, уточнения (в зависимости от типа объявления). Подробная инструкция приведена в разделе [Дополнения к объявлению](https://yandex.ru/dev/direct/doc/dg/best-practice/launch-campaign.html#harness).

Видеодополнения показываются только в сетях (Рекламной сети Яндекса и внешних сетях), но не показываются на поиске.

### Ставка для изображений и видеодополнений {#addons}

Показ изображения или видеодополнения возможен только в случае, если ставка по ключевой фразе или условию нацеливания на аудиторию не ниже минимальной ставки для объявления с включенным в него изображением, указанной на странице [Минимальный и максимальный размер цены за клик](https://yandex.ru/legal/direct_table/). В противном случае объявление будет показано без изображения и видеодополнения.

### Результат модерации дополнений {#moderate-addon}

Визитка, изображение, видеодополнение, набор быстрых ссылок проходят модерацию не изолированно, а в связке с объявлением. Отправка на модерацию происходит автоматически, если само объявление находится на модерации или уже проверено модерацией.

Метод [get](https://yandex.ru/dev/direct/doc/ref-v5/ads/get.html) возвращает результат модерации визитки (структура `VCardModeration`), изображения (структура `AdImageModeration`), набора быстрых ссылок (структура `SitelinksModeration`), видеодополнения (параметр `Status` в структуре `VideoExtension`).


#|
|| **Статус модерации** | **Описание** ||
|| DRAFT | Дополнение не отправлялось на модерацию.  ||
|| MODERATION | Дополнение находится на модерации.  ||
|| ACCEPTED | Дополнение принято модерацией. Объявление при показе будет содержать дополнение.  ||
|| REJECTED | Дополнение отклонено модерацией.  ||
|| UNKNOWN | Неизвестный статус. Используется для обеспечения обратной совместимости и отображения статусов, не поддерживаемых в данной версии API.  ||
|#


## Правила отбора для товарных объявлений {#unified-group-conditions}

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

- `Operand` — поле фида;
- `Operator` — оператор сравнения;
- `Arguments` — массив значений, с которыми сравнивается значение поля в фиде.

Совместимость полей фида и операторов зависит от фида:


{% cut "Розничная торговля, другой бизнес: фид Яндекс Маркета" %}

#|
|| **Поле фида** | **Операторы** | **Ограничения на значения** ||

|| categoryId | GREATER_THAN, LESS_THAN | Одно число ||
||     ^      | EQUALS_ANY | До 20 000 чисел ||
||     ^      | RANGE | До 10 диапазонов, см. [пример](#range-sample).  ||
||     id     | GREATER_THAN, LESS_THAN | Одно число ||
||     ^      | EQUALS_ANY | До 50 чисел ||
||     ^      | RANGE | До 10 диапазонов, см. [пример](#range-sample).  ||
|| 
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 знаков после запятой, см. [пример](#range-sample).  ||
||     ^      | EXISTS | Передайте значение 1 ||
||
adult

manufacturer_warranty

pickup

store         | EQUALS_ANY | Допустимые значения:
- 0
- 1 ||
||     ^      | EXISTS | Передайте значение 1 ||
||    age     | EQUALS_ANY | Допустимые значения: целое число от 0 до 12, 16 или 18.  ||
||     ^      | EXISTS | Передайте значение 1 ||
|#

{% endcut %}

{% cut "Отели: фид «Отели и аренда жилья» Google Рекламы" %}

#|
|| **Поле фида** | **Операторы** | **Ограничения на значения** ||
|| Рrice         | GREATER_THAN, LESS_THAN | Одно число, до 2 знаков после запятой ||
||       ^       | EQUALS_ANY | До 50 чисел, до 2 знаков после запятой ||
||       ^       | RANGE | До 10 диапазонов, до 2 знаков после запятой, см. [пример](#range-sample).  ||
||
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 диапазонов, целые числа, см. [пример](#range-sample).  ||
|#

{% endcut %}

{% cut "Автомобили: фид Авто.ру" %}

#|
|| **Поле фида** | **Операторы** | **Ограничения на значения** ||
||
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 диапазонов, см. [пример](#range-sample).  ||
|#

{% endcut %}

{% cut "Недвижимость: фид Яндекс Недвижимости" %}

Правила отбора для такого фида не предусмотрены.

{% endcut %}

{% cut "Авиабилеты: фид «Авиабилеты» Google Рекламы" %}

Правила отбора для такого фида не предусмотрены.

{% endcut %}

{% cut "Другой бизнес: универсальный фид" %}

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

{% endcut %}

{% cut "Другой бизнес: фид «Специальный» 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 знаков после запятой ||
|#

{% endcut %}

{% cut "Другой бизнес: фид «Путешествия» 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 знаков после запятой ||
|#

{% endcut %}


## Примеры {#examples}

**Значение содержит одну из заданных строк**:

```json translate=no
    {
      "Operand": "mark_id",
      "Operator": "CONTAINS_ANY",
      "Arguments": ["Audi","Opel"]
    }
```

**Диапазон: цена от 111 до 222 или от 3000 до 10000**: {#range-sample}

```json translate=no
    {
      "Operand": "price",
      "Operator": "IN_RANGE",
      "Arguments": ["111-222", "3000-10000"]
    }
```

**Значение из списка**:

```json translate=no
    {
      "Operand": "wheel",
      "Operator": "EQUALS_ANY",
      "Arguments": ["левый"]
    }
```


## Маркировка продвижения {#ad-labeling}

Параметр `ErirAdDescription` содержит описание объекта продвижения.

Параметр `AutogeneratedErirAdDescription` содержит автоматически сгенерированное Описание объекта продвижения.

Подробнее про маркировку продвижения см. [здесь](https://yandex.ru/support/direct/technologies-and-services/ad-labelingl.html).

[*Restrictions]: **Для пользователя**

Количественные ограничения на объекты пользователя.

**Для агентства**

—