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) | Automotive | Sales of new and used cars |
Yandex.Realty feed (XML) | Real estate | Real estate sales |
Google Ads “Flights” feed (CSV) | Plane 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) | Automotive | Sales of new and used cars |
Yandex.Realty feed (XML) | Real estate | Real estate sales |
Google Ads “Flights” feed (CSV) | Plane 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.
Feed requirements
- Example:
-
<offer id="0123456" available="true"> <url>http://www.reliableappliances.biz/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc&</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> <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, B / N, plastic 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>
elementAttribute Description id
Product ID.
Mandatory attribute.
available
Availability of product:
true
— Product is in stock.false
— Product is not in stock.
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 the
<offer>
elementElement 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 onemarket_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 onemarket_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.
- Example:
-
<offer id="1234567" type="vendor.model" available="true"> <url>http://www.reliableappliances.biz/catalog/element/index.php?from=ya_market&utm_source=ya_market&utm_medium=cpc& <price>889.00</price> <oldprice>17000.00</oldprice> <currencyId>RUB</currencyId> <categoryId>1111</categoryId> <picture>http://89.123.45.678/catalog/photo/19/6.JPG</picture> <store>false</store> <pickup>false</pickup> <typePrefix>Printer</typePrefix> <vendor>NR</vendor> <model>Deskjet D2663</model> <description>Family of printers for people who need a reliable, easy-to-use color printer for everyday printing...</description> <sales_notes>Prepayment is required.</sales_notes> <manufacturer_warranty>true</manufacturer_warranty> <country_of_origin>Japan</country_of_origin> </offer>
Attributes of the
<offer>
elementAttribute 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 the
<offer>
elementElement 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 or category (for example, “mobile phone”, “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 onemarket_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 or category (for example, “mobile phone”, “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 onemarket_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.
- 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).
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 recommend 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". - Example:
-
<?xml version= "1.0"?> <data> <cars> <car> <folder_id>Fusion</folder_id> <modification_id>1.4 d AT (68 HP)</modification_id> <url>http://www.auto.ru/1</url> <images>http://picture.auto.ru/1.jpg</images> <body_type>Hatchback 5 DV.</body_type> <color>red</color> <availability>available</availability> <custom>customs clearance</custom> <year>2015</year> <price>575000</price> <currency>RUR</currency> <vin>XWBCA41ZXDK259205</vin> </car> </cars> </data>
Child elements included in the
<car>
elementThe table below describes feed elements which are used for creating smart banners or dynamic ads.
Element Description unique_id
Product offer 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 offer 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.
- Example:
-
<offer internal-id="15782295"> <type>sale</type> <property-type>residential</property-type> <category>flat</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 island</sub-locality-name> <address>Line 18 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 " Builder"</organization> </sales-agent> <floor>13</floor> <floors-total>15</floors-total> <area> <value>63.00</value> <unit>sqm</unit> </area> <building-name>Northern fantasy</building-name> <image>http://www.developer.ru/images/plans/000001289.jpg</image> </offer>
Attributes of the
<offer>
elementAttribute Description
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.
This type of description is practical and versatile. It's recommended you use it for describing products in most categories.
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.
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.
You should use the Yandex.Realty feed in YRL (Yandex Realty Language) format for “Realty” businesses. For more information 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 <offer>
element for each <sales-agent>
element.
Yandex.Direct only accepts feeds with residential property offers for sale.