Managing feeds

To create a smart banner, you need to add a feed (a file with information about your products and services). Yandex.Direct will analyze the content of the feed and automatically generate smart banners with your product offerings that will display in the ad networks. You can use the feed that you uploaded when you created dynamic ads.

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.
AdWords “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
AdWords “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)
AdWords “Custom” feed (CSV)
AdWords “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. YML uses <yml_catalog> as its root element. The "date" attribute of the <yml_catalog> element must correspond to the date and time of YML file generation 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 by a separate element <offer>.

This is the basic, simpler type of description.

Example:
<offer id="0123456" available="true">
  <url>http://www.reliabletech.ru/catalog/element/index.php?from=ya_market&amp;utm_source=ya_market&amp;utm_medium=cpc&amp</url>
  <price>1620.00</price>
  <oldprice>1800.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>Antivirus ESET NOD32 Platinum Edition</name>
  <vendor>Eset</vendor>
  <vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
  <description>Antivirus ESET NOD32 Platinum Edition - license for 2 years NOD32-ENA-NS(BOX)-2-1</description>
  <sales_notes>Payment: Cash, cashless, bank cards, credit</sales_notes>
  <manufacturer_warranty>true</manufacturer_warranty>
  <country_of_origin>Russia</country_of_origin>
  <age unit="year">18</age>
</offer>

Attributes of the <offer> element

Attribute Description
id

Product ID.

Mandatory attribute.

available

Availability of product:

  • true — product is in stock
  • false — product is not in stock

Elements included in <offer>

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 contain only 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: AdWords “Hotels and rentals” feed

For “Hotels”, you can use the “Hotels and rentals” Google AdWords 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 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

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 the advertiser's product offerings is contained in the <cars> element. Each automobile is described separately by the <car> element.

Example:
<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Ford</mark_id>
            <folder_id>Fusion</folder_id>
            <modification_id>1.4d AT (68 л.с.)</modification_id>
            <url>http://www.auto.ru/1</url>
            <images>http://picture.auto.ru/1.jpg</images>
            <body_type>5-door Hatchback</body_type>
            <color>red</color>
            <availability>in stock</availability>
            <custom>customs-cleared</custom>
            <year>2015</year>
            <price>575000</price>
            <currency>RUR</currency>
            <vin>XWBCA41ZXDK259205</vin>
         </car>
     </cars>
</data>

Elements included in <car>

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.

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 realty offers for sale by the advertiser is contained in the <offers> element. Each product offering (apartment) is described separately by the offer element.

You can send information about different residential homes by different property developers in one feed. To do this, enter in each <offer> the legal information about a property developer in the <sales-agent> 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> Vasilievsky</sub-locality-name>
    <address>18th line V.O., 32</address>
    <metro>
      <name>Vasileostrovskaya</name>
      <time-on-foot>10</time-on-foot>
      <time-on-transport>5</time-on-transport>
   </metro>
  </location>
  <price>
    <value>4780000</value>
    <currency>RUR</currency>
  </price>
  <sales-agent>    
    <organization>CJSC "Developer"</organization>    
  </sales-agent>
  <floor>13</floor>
  <floors-total>15</floors-total>
  <area>
    <value>63.00</value>
    <unit>sq. m</unit>
  </area>
  <building-name>Northern Fantasy</building-name>
  <image>http://www.developer.ru/images/plans/000001289.jpg</image>
</offer>

Attributes of the <offer> element

Attribute Description
internal-id

Product offering ID.

Mandatory attribute.

Elements included in <offer>

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

Element Description
type

Type of transaction.

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: sq. m.

Recommended element.

floor

The floor the property is located on.

Recommended element.

Flights: AdWords “Flights” feed

For businesses of the “Flights” type, you can use the Google AdWords “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 a statement 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

Price

Price of item without currency distinction. Use a dot (.) as the decimal separator.

Recommended element.

Currency

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

Required element if the Price element is present.

Old Price

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

Other business: AdWords “Custom” feed

You can use a Google AdWords “Custom” 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 “Custom” AdWords 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".

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).

Item title

Name of item.

Item description

Description of product

Price

The price of an item with a currency code in ISO 4217 encoding (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator.

Recommended element.

Sale price

The new item price, which must be higher than the new price (Price).

Other business: AdWords “Travel” feed

You can use a Google AdWords “Travel” 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 “Travel” AdWords feed in CSV format

Elements included in CSV

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

Element Description

Destination ID

Destination ID.

Required element.

Destination name

Destination name.

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 a statement ID. For example, "id": "MOS-AMS".

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).

Title

Name of item.

Price

The price of an item with a currency code in ISO 4217 encoding (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator.

Recommended element.

Sale price

The new item price, which must be higher than the new price (Price).

Add a feed

To add a feed, click on the Feeds link on the campaign list page. On the Feed management page, click the +Add feed button and select your business type.

To send a feed to Yandex.Direct, add the file link or upload your file. You can add up to 20 feeds.

Post the feed on your store website. The maximum feed size is 512 MB. The robot will download your file once a day; updated data is imported into Yandex.Direct. The robot also checks your feed daily (or more often, when possible) to select products that match the filters you set and generate smart banners or dynamic ads using them. For large feeds, these checks may occur less frequently.

The file must be accessible via HTTP, HTTPS, or FTP. You can make passing authorization a requirement to access to the feed. In this case, enter the user name and password when you upload your feed. If you modify the feed URL or authorization data, make the appropriate changes to the feed parameters in the Yandex.Direct interface.

If links in your feed contain UTM tags that are not used to track your ad campaign, we recommend deleting them. Just select Automatically delete UTM tags. You can add new UTM tags on the page where you edit ad groups (the +Add parameters to links button).

You can archive your feed in a .zip or GNU ZIP (.gz) file.

If an error occurs while adding your feed (for example, if the feed size, format, or link length do not meet the requirements), you will see the “Upload error” status. To view the error report, click More information.

Validate a file

The following are verified when your file is read:

  • That all required elements are present
  • That all element names are correct
  • That each element is only present once

If any of these requirements is not met, your file will be rejected.

If you change the link or authorization parameters, your file will automatically get sent for repeat validation.