Managing feeds

To create dynamic ads you must add a feed — a file with information about products and services. Yandex.Direct will analyze the content of the feed and automatically generate a smart banner with product offerings to be displayed in the ad networks. You can use a feed that was uploaded while creating smart banners.

Types of businesses and feeds

To upload a feed, you must select the type of business that you are advertising.

Type of feed Type of business Business activity
Yandex.Market feed (XML) Retail Sales of electronics and accessories, appliances, industrial equipment, clothes, furniture, gardening products, sporting goods, construction materials, children's goods, tires and disks, cosmetics and perfumes, etc.
Google Ads “Hotels and rentals” feed (CSV) Hotels Hotel reservation feed (XML) Automobiles Sales of new and used cars
Yandex.Realty feed (XML) Realty Real estate sales
Google Ads “Flights” feed (CSV) Airplane tickets Sale of airplane tickets
Universal feed (CSV) Other business Goods and services that don't fit the other business types
Yandex.Market feed (XML)
Google Ads “Special” feed (CSV)
Google Ads “Travel” feed (CSV) Sales of travel packages, train/ferry tickets, etc.

Product offerings not described in accordance with their type will be rejected.

Attention. Smart banners and dynamic ads are not generated for ads that require notices and age restrictions.

Feed requirements

Retail sales, other business: Yandex.Market feed

You can use the Yandex.Market feed in YML (Yandex Market Language) format for businesses of the “Retail” and “Other” types. To learn more about YML, see Yandex.Market Help.

Any XML document may contain only one root element. The YML format uses the <yml_catalog> element as the root element. The date attribute of the <yml_catalog> element should correspond to the date and time the YML file was generated on the advertiser's side. The date must be in YYYY-MM-DD hh:mm format.

The list of the advertiser's product offerings is contained in the <offers> element. Each product offering is described in a separate <offer> element.

This is the basic, simpler type of description.

<offer id="0123456" available="true">
  <name>ESET NOD32 Platinum Edition Antivirus<name>
  <description>ESET NOD32 Platinum Edition - 2 year license NOD32-ENA-NS(BOX)-2-1<description>
  <sales_notes>Payment: Cash, wire transfer, plastic cards, credit<sales_notes>
  <age unit="year">18</age>

Attributes of the <offer> element

Attribute Description

Product ID.

Mandatory attribute.


Availability of product:

  • true — Product is in stock.
  • false — Product is not in stock.

Child elements of the <offer> element

Element Description

Product offering name It's recommended you indicate the vendor or manufacturer name and code in the name of a simplified offer.

Required element.


URL of the product page.

Required element.


Link to image.

Required element (for smart banners).


The price at which this product is being offered.

Recommended element.


Currency code (RUB, USD, UAH, KZT).

Required element if the price element is present.




Vendor or manufacturer.


Product code (enter the vendor code).


Product offering description.


Product category ID assigned by the advertiser (an integer of no more than 18 characters). The product offering can belong to only one category.

Required element. The <offer> element can only contain one <categoryId> element.


Product category to be used on Yandex.Market.


Product available in retail stores:

  • true — Available.

  • false — Not available.


Customer pickup from delivery point:

  • true — Available.

  • false — Not available.


Delivery by courier:

  • true — Available.

  • false — Not available.


The old product price, which must be higher than the new price (price).


Order information:

  • minimum order price, minimum product consignment, required prepayment.

  • payment options, descriptions of promotions and sales.


Official warranty:

  • true — Available.

  • false — Not available.


Country of origin.


This product belongs to the “adult” category:

  • true — Yes.

  • false — No.


Product age category.


Product download:

  • true — Available.

  • false — Not available.

Hotels: Google Ads “Hotels and rentals” feed

For the Google Ads “ Hotels and rentals” feed in CSV format, you can use “Hotels” for the business type. The first string contains the column names, while the following strings contain the data. The contents of the columns are separated by commas. Data in the feed must be encoded in UTF-8.


Download an example of a feed for hotels in CSV format

Elements included in CSV

The table below describes feed elements which are used for creating smart banners or dynamic ads.

Element Description

Property ID

ID of hotel.

Required element.

Property name

Name of hotel.

Required element.

Final URL

The URL of the offer page.

Required element.

Destination name

Location of hotel (no more than 25 characters).

Required element.

Image URL

Image link. We recommend that images be at least 500px in width or height.

Required element (for smart banners).


The price of the offer. Currency number and code (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator.

Recommended element.

Star rating

The number of stars. A whole number from 1 to 5.


User rating, expressed as number. Use a dot (.) as the decimal separator.

Max score

Maximum possible rating, expressed as a whole number. The default number is 5.


Facilities or services provided by the hotel. Enter the values separated by semicolons: bar;pool;free Wi-Fi

Note. Values that contain a comma need to be written in quotation marks (""). For example, "Moscow, center".
Automobiles: feed

You should use the feed in XML format for “Automobile” businesses. Data in the feed must be encoded in UTF-8.

Full description of the XML format for passenger cars (zip archive file, 897 KB)

The list of offers being advertised is contained in the <cars> element. Each car is described in a separate <car> element.

<?xml version= "1.0"?>
            <modification_id>1.4d AT (68 HP)</modification_id>
            <body_type>5-door hatchback</body_type>