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

# Ad

An ad consists of advertising and promotional content. The set of parameters for an ad depends on its type.

## Learn more

* [Managing ad campaigns](https://yandex.ru/dev/direct/doc/en/best-practice/launch-campaign.md).

## Service {#service}

Use the [Ads](https://yandex.com/dev/direct/doc/ads/ads.html) service for managing ads.

### Methods

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

To manage product ads, use this URL: `https://api.direct.yandex.com/v501/`.


## Restrictions {#restrictions}

The ad type must match the group type. See the table in [Ad type](#types).

Operations with ads are not possible in archived campaigns.

To check the limit on the number of ads per group, use the [Clients](https://yandex.com/dev/direct/doc/clients/clients.html).[get](https://yandex.com/dev/direct/doc/clients/get.html) or [AgencyClients](https://yandex.com/dev/direct/doc/agencyclients/agencyclients.html).[get](https://yandex.com/dev/direct/doc/agencyclients/get.html) method (look for the ADS_TOTAL_PER_ADGROUP element in the [Restrictions](*Restrictions) array).

For restrictions on ad parameters, see [Quantitative restrictions](https://yandex.com/support/direct/en/troubleshooting/interface.html#limitations) in Yandex Direct Help.


{% note info %}

- An ad in Belarusian can only be added to a group that has the display region restricted to Belarus.
- An ad in Kazakh can only be added to a group that has the display region restricted to Kazakhstan.
- An ad in Turkish can only be added to a group that has the display region restricted to Turkey.

{% endnote %}



## Ad type {#types}

The ad type is set when creating an ad and can't be changed.

The following types of ads are currently available:

- TEXT_AD: A Text & Image (regular) ad.

    The ad contains a title, text, and a link to the promoted site. You can also include a Turbo page, display link, image, video, price, [sitelinks](https://yandex.ru/dev/direct/doc/en/objects/sitelink.md), [callouts](https://yandex.ru/dev/direct/doc/en/objects/adextension.md), and the ID of your business profile in Yandex Maps. The ad can be automatically assigned an [age label](#age). In this case, you can change the label.

    To create or edit a Text & Image ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `TextAd` structure.

    To get the ad parameters (other than price parameters), list the parameter names in the `TextAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method. To get the price parameters, list their names in the `TextAdPriceExtensionFieldNames` input parameter.

- SMART_AD: A smart banner.

    The ad contains a creative that was created in Ad Builder.

    To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `SmartAdBuilderAd` structure.

    To get the ad parameters, list the parameter names in the `SmartAdBuilderAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- MOBILE_APP_AD: An ad for promoting mobile apps.

    The ad contains a title, text, and age restriction, as well as a label for the button to download or install. You can also add an image, specify a tracking link to track installs, and include a set of add-ons that need to be downloaded from the app store (icon, rating, and so on). For more information about mobile app promotion, see [App promotion](https://yandex.com/support/direct/en/mobile/advertising-mobile-apps.html) in Yandex Direct Help.

    To create or edit a mobile app ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `MobileAppAd` structure.

    To get the parameters of a mobile ad, list the parameter names in the `MobileAppAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- DYNAMIC_TEXT_AD: A dynamic ad.

    The ad contains text. You can also include an [image](https://yandex.ru/dev/direct/doc/en/objects/adimage.md), a [set of sitelinks](https://yandex.ru/dev/direct/doc/en/objects/sitelink.md), and [callouts](https://yandex.ru/dev/direct/doc/en/objects/adextension.md) in an ad. For more information about dynamic ads, see [Dynamic ads](https://yandex.com/support/direct/en/dynamic-text-ads/about-da.html) in Yandex Direct Help.

    To create or edit a dynamic ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `DynamicTextAd` structure.

    To get the ad parameters, list the parameter names in the `DynamicTextAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- IMAGE_AD: An image ad.

    There are four subtypes of image ads:

    - TEXT_IMAGE_AD

      The ad contains an image and a link to the promoted site, a Turbo page, or both.

      To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `TextImageAd` structure.

      To get the ad parameters, list the parameter names in the `TextImageAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

    - MOBILE_APP_IMAGE_AD

      The ad contains an image. You can also add a tracking link to the ad to track app installs.

      To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `MobileAppImageAd` structure.

      To get the ad parameters, list the parameter names in the `MobileAppImageAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

    - TEXT_AD_BUILDER_AD

      The ad includes a creative designed in the Ad Builder, along with a link to the promoted site, a Turbo page, or both.

      To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `TextImageAd` structure.

      To get the ad parameters, list the parameter names in the `TextAdBuilderAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

    - MOBILE_APP_AD_BUILDER_AD

      The ad contains a creative that was created in Ad Builder. You can also add a tracking link to the ad to track app installs.

      To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `MobileAppImageAd` structure.

      To get the ad parameters, list the parameter names in the `MobileAppAdBuilderAdFieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

    {% note alert %}

    Image ads are only displayed in ad networks (the Yandex Advertising Network and external networks); they are not displayed in search results.

    Displays of image ads are possible only if the bid on a keyword or audience target meets the minimum CPC for an ad containing an image, which you can find on the [Minimum and maximum CPC](https://yandex.ru/legal/direct_table/) page.

    {% endnote %}

    For more information about image ads, see [Image ads](https://yandex.com/support/direct/en/features/image-ads.html) in Yandex Direct Help.

- CPC_VIDEO_AD: A video ad (in a "Text & Image Ads" or "Ads for mobile apps" campaign).

    The ad includes a creative designed in the Ad Builder, along with a link to the promoted site, a Turbo page, or both.

    To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `CpcVideoAdBuilderAd` structure.

    To get the ad parameters, list the parameter names in the `CpcVideoAdBuilderAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

    The "Ads for mobile apps" campaigns use a separate subtype for video ads — MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD.

    - **MOBILE_APP_CPC_VIDEO_AD_BUILDER_AD**

      Such an ad contains a creative that was created in Ad Builder. You can also add a tracking link to the ad to track app installs.

      To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `MobileAppCpcVideoAdBuilderAd` structure.

      To get the ad parameters, list the parameter names in the `MobileAppCpcVideoAdBuilderAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- CPM_BANNER_AD: A display banner.

    The ad includes a creative uploaded via the web interface or designed in the Ad Builder, as well as a link to the promoted site and/or a Turbo social media page with more information about the offer. You can also add a Yandex Audience pixel and an ADFOX impression tag to your ads.

    To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `CpmBannerAdBuilderAd` structure.

    To get the ad parameters, list the parameter names in the `CpmBannerAdBuilderAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- CPM_VIDEO_AD: A display video ad in a display campaign.

    The ad includes a creative designed in the Ad Builder, as well as a link to the promoted site or and/or a Turbo social media page with more information about the offer. You can also add an ADFOX impression tag to an ad.

    To create or edit an ad, pass the parameters in the `CpmBannerAdBuilderAd` structure for the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method.

    To get the ad parameters, list the parameter names in the `CpmBannerAdBuilderAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- SHOPPING_AD: A product ad in a "unified performance campaign".

    To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `ShoppingAd` structure.

    To get the ad parameters, list the parameter names in the `ShoppingAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- LISTING_AD: An ad for catalog pages in a "unified performance campaign".

    To create or edit an ad, use the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method with the ad parameters defined in the `ListingAd` structure.

    To retrieve ad parameters, list the parameter names in the `ListingAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

- RESPONSIVE_AD: An ad where you can specify multiple title, text, image, and video options.

    You can add up to 3 non-archived combinatorial ads per group, and up to 10 ads of this type per group, including archived ones.

    To create or edit an ad, pass the parameters in the `ResponsiveAd` structure for the [add](https://yandex.com/dev/direct/doc/ads/add.html) or [update](https://yandex.com/dev/direct/doc/ads/update.html) method.

    To retrieve ad parameters, list the parameter names in the `ResponsiveAdFieldNames` input parameter of the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.


The `Type`, `Subtype`, `Status`, `State`, `StatusClarification`, `AdCategories`, and `AgeLabel`  parameters are common to all types of ads. To get these parameters, list the desired parameter names in the `FieldNames` input parameter for the [get](https://yandex.com/dev/direct/doc/ads/get.html) method.

The table below shows how ad types correspond to group types.

#|
|| **Group type** | **Possible types of ads** ||

|| TEXT_AD_GROUP | TEXT_AD, IMAGE_AD, subtypes TEXT_IMAGE_AD, TEXT_AD_BUILDER_AD, CPC_VIDEO_AD ||

|| SMART_AD_GROUP | SMART_AD ||

|| MOBILE_APP_AD_GROUP | MOBILE_APP_AD, IMAGE_AD, subtypes MOBILE_APP_IMAGE_AD, MOBILE_APP_AD_BUILDER_AD, CPC_VIDEO_AD, subtype 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, subtypes TEXT_IMAGE_AD, TEXT_AD_BUILDER_AD, SHOPPING_AD, LISTING_AD, RESPONSIVE_AD ||
|#


## Ad status and state {#status}

The `State` parameter reflects the current state of the ad.

#|
|| **State** | **Description** ||

|| SUSPENDED | Ad displays were stopped by the owner using the [suspend](https://yandex.com/dev/direct/doc/ads/suspend.html) method or in the web interface.  ||

|| OFF_BY_MONITORING | Ad displays are automatically stopped by [site availability monitoring](https://yandex.com/support/direct/en/campaigns/site-monitoring.html). ||

|| ON | The ad is active, belongs to an active campaign, and can be displayed (if the campaign has funds, time targeting settings allow displays, and so on).  ||

|| OFF | The ad is inactive (a draft, pending review, or rejected), or belongs to an inactive or suspended campaign.  ||

|| ARCHIVED | The ad has been archived (using the [archive](https://yandex.com/dev/direct/doc/ads/archive.html) method, or in the web interface), or belongs to an archived campaign.  ||
|#

The `Status` parameter reflects the result of reviewing the ad.

#|
|| **Status** | **Description** ||

|| DRAFT | The ad has been created but has not yet been submitted for review.  ||

|| MODERATION | The ad is under review.  ||

|| PREACCEPTED | The ad has been automatically accepted for displays, but will be further reviewed by a moderator.  ||

|| ACCEPTED | The ad was accepted after review.  ||

|| REJECTED | The ad was rejected after review.  ||
|#


{% note info %}

If the ad was edited, and the new version is pending review (the MODERATION status) or was immediately rejected after review (the REJECTED status), the previous version of the ad continues being displayed if it was not suspended. In this case, the ad has the ON status.

If the new version of the ad was automatically accepted for display after editing (PREACCEPTED), and then it was rejected (REJECTED), displays of the previous version will not be resumed.

{% endnote %}



## Special category {#classification}

During the review, an ad can be assigned a label stating that the promoted product or service belongs to a special category. In this case, the ad is given the `AdCategories` parameter, which cannot be changed.

For certain categories, ad displays are forbidden. For others, ads are served with a special warning in accordance with the legislation of the Russian Federation.

To get the reference list of special categories, use the [Dictionaries](https://yandex.com/dev/direct/doc/dictionaries/dictionaries.html).[get](https://yandex.com/dev/direct/doc/dictionaries/get.html) method.

These categories cannot be changed, assigned, or removed via the API. If you disagree with the category assigned, contact the [Support service](https://yandex.com/support/direct/en/troubleshooting/shows.html#warning).


## Age label {#age}

The `AgeLabel` parameter specifies the age rating for the promoted product, if required for compliance with the Federal Law of the Russian Federation “On Advertising”. Assigning the age category depends on the ad type.


{% list tabs %}

- TEXT_AD

  The value of the age label depends on whether the ad belongs to the [special category](#classification) BABY_FOOD:

  - For ads that belong to the BABY_FOOD category, it is the age of the infant in months: "MONTHS_0", "MONTHS_1", "MONTHS_2", ..., "MONTHS_12".

  - For all other ads, it is the age that the informational product is appropriate for. Possible values: "AGE_0", "AGE_6", "AGE_12", "AGE_16", "AGE_18".


  If an ad does not have an age label, this parameter can't be set (the `update` method ignores the parameter value).


  {% note alert %}

  The API can only be used to change the value of the age category if the ad has one. In order to change whether an ad has or doesn't have an age category, contact the [Support service](https://yandex.com/support/direct/en/troubleshooting/moderation.html#dissent).

  {% endnote %}



- MOBILE_APP_AD

  An age label is assigned to all ads. Possible values: "AGE_0", "AGE_6", "AGE_12", "AGE_16", "AGE_18".

  The label can be specified when creating the ad. Default value: "AGE_18". You can change the value of the label when editing the ad, but you can't remove the label.

{% endlist %}



## Ad extensions {#addons}

You can use the [add](https://yandex.com/dev/direct/doc/ads/add.html) and [update](https://yandex.com/dev/direct/doc/ads/update.html) methods to link a vCard, image, video extension, set of sitelinks, or callouts with an ad (depending on the ad type). For detailed instructions, see [Ad extensions](https://yandex.com/dev/direct/doc/best-practice/launch-campaign.html#harness).

Video extensions are only displayed in ad networks (the Yandex Advertising Network and external networks); they are not displayed in search results.

### Bids for images and video extensions {#addons}

An image or video extension can be displayed only if the bid for the keyword or audience target meets the minimum CPC for an ad containing an image, which you can find on the [Minimum and maximum CPC](https://yandex.ru/legal/direct_table/) page. Otherwise, the ad is shown without the image or video extension.

### Results of an ad extension review {#moderate-addon}

The vCard, image, video extension, and sitelinks are not reviewed in isolation, but together with the ad. They are sent for moderation automatically if the ad is under moderation or already passed moderation.

The [get](https://yandex.com/dev/direct/doc/ads/get.html) method returns the result of reviewing the vCard (`VCardModeration` structure), image (`AdImageModeration` structure), sitelinks (`SitelinksModeration` structure), or video extension (`Status` parameter in the `VideoExtension` structure).


#|
|| **Review status** | **Description** ||
|| DRAFT | The ad extension has not been submitted for review.  ||
|| MODERATION | The ad extension is under review.  ||
|| ACCEPTED | The ad extension was accepted after review. The ad will contain the add-on when it is shown.  ||
|| REJECTED | The ad extension was rejected after review.  ||
|| UNKNOWN | The status is unknown. This value is used for backward compatibility and for displaying statuses that are not supported in this version of the API.  ||
|#


## Rules for selecting product ads. {#unified-group-conditions}

The selection rule consists of three parameters:

- `Operand` — The feed field.
- `Operator` — The comparison operator.
- `Arguments` — An array of values to compare the field value in the feed with.

The compatibility of feed fields and operators depends on the feed:


{% cut "Retail sales, other business: Yandex Market feed" %}

#|
|| **Feed field** | **The operators** | **Restrictions on values** ||

|| categoryId | GREATER_THAN, LESS_THAN | One number ||
||     ^      | EQUALS_ANY | Max 20,000 numbers ||
||     ^      | RANGE | Max 10 ranges. See [example](#range-sample).  ||
||     id     | GREATER_THAN, LESS_THAN | One number ||
||     ^      | EQUALS_ANY | Max 50 numbers ||
||     ^      | RANGE | Max 10 ranges. See [example](#range-sample).  ||
|| 
market_category 

typePrefix

vendor        | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||     ^      | EXISTS | Pass the value 1 ||
||
description

model

name          | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||    url     | EQUALS,CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||
oldprice

price         | GREATER_THAN, LESS_THAN | Single number, up to 2 decimal places ||
||     ^      | EQUALS_ANY | Max 50 numbers, up to 2 decimal places ||
||     ^      | RANGE | Max 10 ranges, up to 2 decimal places. See the [example](#range-sample).  ||
||     ^      | EXISTS | Pass the value 1 ||
||
adult

manufacturer_warranty

pickup

store         | EQUALS_ANY | Acceptable values:
- 0
- 1 ||
||     ^      | EXISTS | Pass the value 1 ||
||    age     | EQUALS_ANY | Acceptable values: integer from 0 to 12, 16, or 18.  ||
||     ^      | EXISTS | Pass the value 1 ||
|#

{% endcut %}

{% cut "Hotels: Google Ads "Hotels and rentals" feed" %}

#|
|| **Feed field** | **The operators** | **Restrictions on values** ||
|| Rsis         | GREATER_THAN, LESS_THAN | Single number, up to 2 decimal places ||
||       ^       | EQUALS_ANY | Max 50 numbers, up to 2 decimal places ||
||       ^       | RANGE | Max 10 ranges, up to 2 decimal places. See the [example](#range-sample).  ||
||
Description

max_score

name

location

url              | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
|| class         | EQUALS_ANY | Acceptable values:
- 1
- 2
- 3
- 4
- 5 ||
||       ^       | EXISTS | Pass the value 1 ||
||
OfferID

Score            | GREATER_THAN, LESS_THAN | Single integer ||
||       ^       | EQUALS_ANY        | Max 50 integers ||
||       ^       | RANGE | Max 10 ranges or integers. See the [example](#range-sample).  ||
|#

{% endcut %}

{% cut "Automobiles: Auto.ru feed" %}

#|
|| **Feed field** | **The operators** | **Restrictions on values** ||
||
body_type

color

folder_id

mark_id          | CONTAINS_ANY, NOT_CONTAINS_ALL, | Max 50 lines, max 175 characters per line ||
|| wheel         | CONTAINS_ANY | Recommended values:
- left
- right ||
|| metallic      | EQUALS_ANY | Recommended values:
- yes
- no ||
|| availability  | EQUALS_ANY | Recommended values:
- in stock
- on order ||
|| year          | EQUALS_ANY | Max 10 numbers ||
|| url           | CONTAINS_ANY, NOT_CONTAINS_ALL, EQUALS_ANY | Max 50 lines, max 175 characters per line ||
|| price         | GREATER_THAN, LESS_THAN | Single integer ||
||       ^       | EQUALS_ANY | Max 50 integers ||
||       ^       | RANGE | Max 10 ranges. See [example](#range-sample).  ||
|#

{% endcut %}

{% cut "Realty: Yandex Realty feed" %}

This feed doesn't use selection rules.

{% endcut %}

{% cut "Flights: Google Ads "Flights" feed" %}

This feed doesn't use selection rules.

{% endcut %}

{% cut "Other business: universal feed" %}

#|
|| **Feed field**    | **The operators** | **Restrictions on values** ||
|| url              | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||
description

name | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||       ^          | EXISTS | Pass the value 1 ||
|| 
price 

oldprice            | GREATER_THAN, LESS_THAN | Single number, up to 2 decimal places ||
||       ^          | EQUALS_ANY | Max 50 numbers, up to 2 decimal places ||
||       ^          | RANGE | Max 10 ranges, up to 2 decimal places. See the [example](#range-sample).  ||
|#

{% endcut %}

{% cut "Other business: Google Ads "Custom" feed" %}

#|
|| **Feed field** | **The operators** | **Restrictions on values** ||
||
category

description

name

second_title     | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||       ^       | EXISTS | Pass the value 1 ||
|| url           | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||
price

sale_price
| GREATER_THAN, LESS_THAN | Single number, up to 2 decimal places ||
||       ^       | IN_RANGE | Up to 10 ranges, up to 2 decimal places ||
||       ^       | EQUALS_ANY | Up to 50 values, up to 2 decimal places ||
|#

{% endcut %}

{% cut "Other business: Google Ads "Travel" feed" %}

#|
|| **Feed field** | **The operators** | **Restrictions on values** ||
||
Category

destination

origin

Title            | CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||       ^       | EXISTS | Pass the value 1 ||
|| url           | EQUALS_ANY, CONTAINS_ANY, NOT_CONTAINS_ALL | Max 50 lines, max 175 characters per line ||
||
price

sale_price       | GREATER_THAN, LESS_THAN | Single number, up to 2 decimal places ||
||       ^       | IN_RANGE | Up to 10 ranges, up to 2 decimal places ||
||       ^       | EQUALS_ANY | Max 50 numbers, up to 2 decimal places ||
|#

{% endcut %}


## Examples {#examples}

**The value contains one of the specified rows**:

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

**Range: price from 111 to 222 or 3000 to 10000**: {#range-sample}

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

**Value from the list**:

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


## Ad labeling {#ad-labeling}

The `ErirAdDescription` parameter contains the description of a promoted object.

The `AutogeneratedErirAdDescription` parameter contains an automatically generated description of a promoted object.

For more information about ad labeling, [click here](https://yandex.com/support/direct/en/technologies-and-services/ad-labelingl.html).

[*Restrictions]: **For a user**

Limits on the number of objects for a user.

**For an agency**

—