Feed requirements
Product sales
General requirements for product feeds:
- Each product must have a unique ID.
The IDs of the same product must be the same in different feeds, even when the feeds have different types. For example, the same product should have the same ID in your Yandex Market and Google Shopping feeds both.
- 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> <picture>http://89.123.45.678/catalog/photo/19/7.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-2-year license NOD32-ENA-NS (BOX) - 2-1</description> <sales_notes>Payment: cash, wire transfer, bank card, 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. The IDs of each product must be unique and not overlap in different feeds.
available
Availability of product:
true
— Product is in stock.false
— Product is not in stock.
Attribute Description id
Product ID.
Mandatory attribute. The IDs of each product must be unique and not overlap in different feeds.
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
Image link.
Required element (for smart banners).
Add multiple images from the card of one product. For example, images of the product shown from different angles or in different interiors. YAN allows you to display up to five images in some formats. For more information about the selection and processing of images in smart banners, see Questions and answers.
price
The price at which this product is being offered.
Recommended element for dynamic ads and smart banners.
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.
You can use the Yandex Market feed in YML (Yandex Market Language) format for “Retail” and “Other” type businesses. 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. Add the <currencies>
and <categories>
elements in the <shop>
element before the list of product offers. To learn more about elements comprising <shop>
, see Yandex Market Help.
This is the basic, simpler type of description.