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
Auto.ru 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.


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
Auto.ru 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 must contain warnings 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. For details about the YML format, 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 products is contained in the <offers>element. Each product offering is described in a separate <offer>element.

This is the basic, simpler type of description.

Example:

<offer id= "0123456" available= "true">  <url>http://www.reliabletechnology.ru/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc&</url>  <price>1,620.00< / price>  <oldprice>1,800.00< / oldprice>  <currencyId>RUB< / currencyId>  <categoryId>19</categoryId>  <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture>  <store>false</store>  <pickup>true</pickup>  <delivery>false</delivery>  <name>ESET NOD32 Platinum Edition antivirus</name>  <vendor>Eset</vendor>  <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>  <description>ESET NOD32 Platinum Edition antivirus - two-year license NOD32-ENA-NS(BOX)-2-1</description>  <sales_notes>Payment: Cash, credit cards, credit offer</sales_notes>  <manufacturer_warranty>true</manufacturer_warranty>  <country_of_origin>Russia</country_of_origin>  <age unit="year">18</age></offer>

Attributes of offer>element


Attribute	Description
`id`	Product ID. Mandatory attribute.
`available`	Availability of product: `true` — product is in stock `false` — product is not in stock

Child elements of<offer>element


Element	Description
`name`	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`	URL of the product page. Required element.
`picture`	Link to image. Required element (for smart banners).
`price`	The price at which this product is being offered. Recommended element.
`currencyId`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`model`	Model.
`vendor`	Vendor or manufacturer.
`vendorCode`	Product code (enter the vendor code).
`description`	Product offering description.
`categoryId`	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.
`market_category`	Product category to be used on Yandex.Market.
`store`	Product available in retail stores: `true` — Available. `false` — Not available.
`pickup`	Customer pickup from delivery point: `true` — Available. `false` — Not available.
`delivery`	Delivery by courier: `true` — Available. `false` — Not available.
`oldprice`	The old product price, which must be higher than the new price (`price`).
`sales_notes`	Order information: minimum order price, minimum product consignment, required prepayment. payment options, descriptions of promotions and sales.
`manufacturer_warranty`	Official warranty: `true` — Available. `false` — Not available.
`country_of_origin`	Country of origin.
`adult`	This product belongs to the “adult” category: `true` — Yes. `false` — No.
`age`	Product age category.
`downloadable`	Product download: `true` — Available. `false` — Not available.


Element	Description
`name`	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`	URL of the product page. Required element.
`picture`	Link to image. Required element (for smart banners).
`price`	The price at which this product is being offered. Recommended element.
`currencyId`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`model`	Model.
`vendor`	Vendor or manufacturer.
`vendorCode`	Product code (enter the vendor code).
`description`	Product offering description.
`categoryId`	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.
`market_category`	Product category to be used on Yandex.Market.
`store`	Product available in retail stores: `true` — Available. `false` — Not available.
`pickup`	Customer pickup from delivery point: `true` — Available. `false` — Not available.
`delivery`	Delivery by courier: `true` — Available. `false` — Not available.
`oldprice`	The old product price, which must be higher than the new price (`price`).
`sales_notes`	Order information: minimum order price, minimum product consignment, required prepayment. payment options, descriptions of promotions and sales.
`manufacturer_warranty`	Official warranty: `true` — Available. `false` — Not available.
`country_of_origin`	Country of origin.
`adult`	This product belongs to the “adult” category: `true` — Yes. `false` — No.
`age`	Product age category.
`downloadable`	Product download: `true` — Available. `false` — Not available.

This type of description is practical and versatile. It's recommended you use it for describing products in most categories.

Example:

<offer id="1234567" type="vendor.model" available="true"> <url>http://www.reliabletechnology.ru/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc&</url> <price>889.00</price> <oldprice>17,000.00</oldprice> <currencyId>RUR</currencyId> <categoryId>1111</categoryId> <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture> <store>false</store> <pickup>false</pickup> <delivery>true</delivery> <typePrefix>Printer</typePrefix> <vendor>НP</vendor> <model>Deskjet D2663</model> <description>Printers for people who need a reliable, simple-to-use color printer for everyday printing...</description> <sales_notes>Must pre-pay.</sales_notes> <manufacturer_warranty>true</manufacturer_warranty> <country_of_origin>Japan</country_of_origin> </offer>

Attributes of offer>element


Attribute	Description
`id`	Product ID. Mandatory attribute.
`type`	Product offering description type. The value must be `vendor.model`. Mandatory attribute.
`available`	Availability of product: `true` — product is in stock `false` — product is not in stock


Attribute	Description
`id`	Product ID. Mandatory attribute.
`type`	Product offering description type. The value must be `vendor.model`. Mandatory attribute.
`available`	Availability of product: `true` — product is in stock `false` — product is not in stock

Child elements of<offer>element


Element	Description
`url`	URL of the product page. Required element.
`picture`	Link to image. Required element (for smart banners).
`price`	The price at which this product is being offered. Recommended element.
`currencyId`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`model`	Model. Required element.
`vendor`	Vendor or manufacturer. Required element.
`vendorCode`	Product code (enter the vendor code).
`description`	Product offering description.
`typePrefix`	Product type / category (for example, “mobile telephone”, “washing machine”, “corner sofa”).
`categoryId`	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.
`market_category`	Product category to be used on Yandex.Market.
`store`	Product available in retail stores: `true` — Available. `false` — Not available.
`pickup`	Customer pickup from delivery point: `true` — Available. `false` — Not available.
`delivery`	Delivery by courier: `true` — Available. `false` — Not available.
`oldprice`	The old product price, which must be higher than the new price (`price`).
`sales_notes`	Order information: minimum order price, minimum product consignment, required prepayment. payment options, descriptions of promotions and sales.
`manufacturer_warranty`	Official warranty: `true` — Available. `false` — Not available.
`country_of_origin`	Country of origin.
`adult`	This product belongs to the “adult” category: `true` — Yes. `false` — No.
`age`	Product age category.
`downloadable`	Product download: `true` — Available. `false` — Not available.


Element	Description
`url`	URL of the product page. Required element.
`picture`	Link to image. Required element (for smart banners).
`price`	The price at which this product is being offered. Recommended element.
`currencyId`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`model`	Model. Required element.
`vendor`	Vendor or manufacturer. Required element.
`vendorCode`	Product code (enter the vendor code).
`description`	Product offering description.
`typePrefix`	Product type / category (for example, “mobile telephone”, “washing machine”, “corner sofa”).
`categoryId`	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.
`market_category`	Product category to be used on Yandex.Market.
`store`	Product available in retail stores: `true` — Available. `false` — Not available.
`pickup`	Customer pickup from delivery point: `true` — Available. `false` — Not available.
`delivery`	Delivery by courier: `true` — Available. `false` — Not available.
`oldprice`	The old product price, which must be higher than the new price (`price`).
`sales_notes`	Order information: minimum order price, minimum product consignment, required prepayment. payment options, descriptions of promotions and sales.
`manufacturer_warranty`	Official warranty: `true` — Available. `false` — Not available.
`country_of_origin`	Country of origin.
`adult`	This product belongs to the “adult” category: `true` — Yes. `false` — No.
`age`	Product age category.
`downloadable`	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.

Example:: 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 recommended that images be at least 500px in width or height. Required element (for smart banners).
`Price`	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.
`Score`	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`	Facilities or services provided by the hotel. Enter the values separated by semicolons: `bar;pool;free Wi-Fi`


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 recommended that images be at least 500px in width or height. Required element (for smart banners).
`Price`	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.
`Score`	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`	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: Auto.ru feed

You should use the Auto.ru 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.

Example:

<?xml version= "1.0"?><data>    <cars>        <car>                        <folder_id>Fusion</folder_id>            <modification_id>1.4d AT (68 hp)</modification_id>            <url>http://www.auto.ru/1</url>            <images>http://picture.auto.ru/1.jpg</images>            <body_type>Hatchback 5 door</body_type>            <color>red</color>            <availability>available</availability>            <custom>customs-cleared</custom>            <year>2015</year>            <price>575,000</price>            <currency>RUR</currency>            <vin>XWBCA41ZXDK259205</vin>         </car>     </cars></data>

Child elements included in <car> element

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


Element	Description
`unique_id`	Product offering ID. Required element if the `vin` element is not present.
`vin`	Automobile VIN (17 symbols). Required element if the `unique_id` element is not present.
`url`	A link to the product offer page. Required element.
`images`	A link to an image of the specific model or model variant. Required element (for smart banners).
`price`	The price at which the automobile may be purchased. Recommended element.
`currency`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`mark_id`	The name of the car brand.
`folder_id`	The name of the model.
`modification_id`	The name of the model variant.
`body_type`	The body type of the automobile.
`year`	The year the automobile was manufactured.


Element	Description
`unique_id`	Product offering ID. Required element if the `vin` element is not present.
`vin`	Automobile VIN (17 symbols). Required element if the `unique_id` element is not present.
`url`	A link to the product offer page. Required element.
`images`	A link to an image of the specific model or model variant. Required element (for smart banners).
`price`	The price at which the automobile may be purchased. Recommended element.
`currency`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `price` element is present.
`mark_id`	The name of the car brand.
`folder_id`	The name of the model.
`modification_id`	The name of the model variant.
`body_type`	The body type of the automobile.
`year`	The year the automobile was manufactured.

Realty: Yandex.Realty feed

You should use the Yandex.Realty feed in YRL (Yandex Realty Language) format for “Realty” businesses. For details about the YRL format, see Yandex.Realty Help.

The list of real estate that the advertiser is selling is contained in the <offers> element. Each product offering is described in a separate <offer>element.

You can send information about different residential homes by different property developers in one feed. To do this, enter legal information about the developer in the child <sales-agent> element for each <offer> element.

Attention.

Yandex.Direct does not accept feeds with realty offers for rent.

Example:

<offer internal-id="15782295">  <type>sale</type>  <property-type>residential</property-type>  <category>apartment</category>  <url>http://www.developer.ru/search18</url>  <creation-date>2015-04-02T19:00:06+03:00</creation-date>  <location>        <locality-name>Saint Petersburg</locality-name>    <sub-locality-name>Vasilyevsky Island</sub-locality-name>    <address>32 18th St., V.O.</address>    <metro>      <name>Vasileostrovskaya</name>      <time-on-foot>10</time-on-foot>      <time-on-transport>5</time-on-transport>   </metro>  </location>  <price>    <value>4,780,000</value>    <currency>RUR</currency>  </price>  <sales-agent>        <organization>Builder, CJSC</organization>      </sales-agent>  <floor>13</floor>  <floors-total>15</floors-total>  <area>    <value>63.00</value>    <unit>sq. m.</unit>  </area>  <building-name>Severnaya Fantaziya</building-name>  <image>http://www.developer.ru/images/plans/000001289.jpg</image></offer>

Attributes of offer>element


Attribute	Description
`internal-id`	Product offering ID. Mandatory attribute.

Child elements of<offer>element

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


Element	Description
`type`	Type of deal. Only value used is `sale`. Required element.
`location`	Set of elements describing the location of the object in question. Information about the location is detailed in nested tags. `<location> <locality-name></locality> <address></address> <metro></metro> … </location>` Required element.
`locality-name`	The name of the populated locality. Required element.
`sub-locality-name`	The region where the populated locality is located. Recommended element.
`address`	Street and house number. Recommended element.
`metro`	Nearest metro station. If there are several stations, then each one should be entered as a separate element. Detailed information is indicated in nested tags. `<metro> <name></name> <time-on-foot></time-on-foot> <time-on-transport></time-on-transport> </metro>` Recommended element.
`name`	Metro station name. Recommended element.
`time-on-transport`	The time it takes in minutes to get to the metro on public transport. Recommended element.
`time-on-foot`	The time it takes in minutes to get to the metro on foot. Recommended element.
`url`	A link to the product offer page. Required element.
`image`	Image link. If the feed has several images entered, then the first one will be used. Required element (for smart banners).
`building-name`	Name of the residential home or building. Apartments in the residential building are combined for this element. If the name of the residential building are unknown, enter the street and house number (e.g. Tverskaya St., 25) Required element.
`sales-agent`	Information about the developer. Detailed information is indicated in nested tags. `<sales-agent> <organization></organization> </sales-agent>` Required element.
`organization`	Legal name of the developer. Required element.
`price`	Set of elements describing the price of the object in question. The sum and currency of the price is indicated in nested tags. `<price> <value></value> <currency></currency> </price>` Recommended element.
`value`	The price. Recommended element.
`currency`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `value` element is present.
`area`	Total area. The value and unit of measurement is indicated in nested tags. `<area> <value></value> <unit></unit> </area>` Recommended element.
`value`	The area value. Indicated as a numeric value. Recommended element.
`unit`	The unit of floor space. This element is used if the price is indicated as per unit. Possible values: `кв. м` or `sq. m`. Recommended element.
`floor`	The floor the property is located on. Recommended element.


Element	Description
`type`	Type of deal. Only value used is `sale`. Required element.
`location`	Set of elements describing the location of the object in question. Information about the location is detailed in nested tags. `<location> <locality-name></locality> <address></address> <metro></metro> … </location>` Required element.
`locality-name`	The name of the populated locality. Required element.
`sub-locality-name`	The region where the populated locality is located. Recommended element.
`address`	Street and house number. Recommended element.
`metro`	Nearest metro station. If there are several stations, then each one should be entered as a separate element. Detailed information is indicated in nested tags. `<metro> <name></name> <time-on-foot></time-on-foot> <time-on-transport></time-on-transport> </metro>` Recommended element.
`name`	Metro station name. Recommended element.
`time-on-transport`	The time it takes in minutes to get to the metro on public transport. Recommended element.
`time-on-foot`	The time it takes in minutes to get to the metro on foot. Recommended element.
`url`	A link to the product offer page. Required element.
`image`	Image link. If the feed has several images entered, then the first one will be used. Required element (for smart banners).
`building-name`	Name of the residential home or building. Apartments in the residential building are combined for this element. If the name of the residential building are unknown, enter the street and house number (e.g. Tverskaya St., 25) Required element.
`sales-agent`	Information about the developer. Detailed information is indicated in nested tags. `<sales-agent> <organization></organization> </sales-agent>` Required element.
`organization`	Legal name of the developer. Required element.
`price`	Set of elements describing the price of the object in question. The sum and currency of the price is indicated in nested tags. `<price> <value></value> <currency></currency> </price>` Recommended element.
`value`	The price. Recommended element.
`currency`	Currency code (`RUB`, `USD`, `UAH`, `KZT`). Required element if the `value` element is present.
`area`	Total area. The value and unit of measurement is indicated in nested tags. `<area> <value></value> <unit></unit> </area>` Recommended element.
`value`	The area value. Indicated as a numeric value. Recommended element.
`unit`	The unit of floor space. This element is used if the price is indicated as per unit. Possible values: `кв. м` or `sq. m`. Recommended element.
`floor`	The floor the property is located on. Recommended element.

Flights: Google Ads “Flights” feed

For the “Flights” business type, you can use the Google Ads “Flights” feed in CSV format. 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.

Example:: Download an example of a feed for flights 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
`Destination ID`	Destination ID. Required element.
`Destination name`	Destination name. Required element.
`Origin ID`	Origin ID. If you specified the `Origin ID` in the feed and enabled e-commerce in Yandex.Metrica, use the `Origin ID` and `Destination ID` (separated by a hyphen) in the Ecommerce object as the offer ID. For example, `"id": "VKO-LHR"`.
`Origin name`	Origin name.
`Final URL`	The URL of the offer page. Required element.
`Image URL`	Image link. We recommended that images be at least 500px in width or height. Required element (for smart banners).
`Flight price`	The price of the offer. Currency number and code (`RUB`, `USD`, `UAH`, `KZT`). Use a dot (.) as the decimal separator. Recommended element.


Element	Description
`Destination ID`	Destination ID. Required element.
`Destination name`	Destination name. Required element.
`Origin ID`	Origin ID. If you specified the `Origin ID` in the feed and enabled e-commerce in Yandex.Metrica, use the `Origin ID` and `Destination ID` (separated by a hyphen) in the Ecommerce object as the offer ID. For example, `"id": "VKO-LHR"`.
`Origin name`	Origin name.
`Final URL`	The URL of the offer page. Required element.
`Image URL`	Image link. We recommended that images be at least 500px in width or height. Required element (for smart banners).
`Flight price`	The price of the offer. Currency number and code (`RUB`, `USD`, `UAH`, `KZT`). Use a dot (.) as the decimal separator. Recommended element.

Other business: universal feed

You can use a universal feed in CSV format for the “Other business” type. The first string contains the column names, and the following strings contain the actual data. The contents of the columns are separated by commas. Data in the feed must be encoded in UTF-8.

Example

Download an example of a universal feed in CSV format

Elements included in CSV

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


Element	Description
`ID`	ID of item. Required element.
`ID2`	Second product ID If you specified `ID2` in the feed and enabled e-commerce in Yandex.Metrica, use the `ID` and `ID2` (separated by a hyphen) in the Ecommerce object as a statement ID. For example, `"id": "VKO-LHR"`.
`URL`	The URL of the offer page. Required element.
`Image`	Image link. We recommended that images be at least 500px in width or height. Required element (for smart banners).
`Title`	Name of item.
`Description`	Description of product