Direct
Help
Contact us

Managing Feeds

To create a smart banner, you need to add the feed (a file with information about your 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.

Feed Requirements

Your feed must be provided in YML format. YML is a format developed and recommended by Yandex for posting information to Yandex.Market. For details about the YML format, see Yandex.Market Help.

Yandex.Direct supports two types of product offering descriptions:

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

Adding a Feed

To add a feed, click the Feed management link on the campaign editing page and click Add feed in the displayed window. To send a feed to Yandex.Direct, add the file link or upload the file. You can add up to 20 feeds.

Post the feed on your store website. The feed must not exceed 512 MB in size. Once a day, the file is downloaded by the robot and updated data is imported into Yandex.Direct.

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

If the links have UTM tags not suitable for tracking an 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).

Select the file that you want to upload. The loaded file must not exceed 512 MB in size. During the update, the file is downloaded by the robot and new data is imported into Yandex.Direct.

You can place your feed in an archive created with the use of compression algorithms such as ZIP (.zip) or GNU ZIP (.gz).

If an error occurred while adding the feed (for example, 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 the More information link.

Validating the file

The following requirements are checked for when reading the file:

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

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

YML Format

YML is a format developed and recommended by Yandex for posting information to Yandex.Market. 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.надежнаятехника.рф/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>Антивирус ESET NOD32 Platinum Edition</name>
<vendor>Eset</vendor>
<vendorCode>NOD32-ENA-NS(BOX)-2-1</vendorCode>
<description>Антивирус ESET NOD32 Platinum Edition - лицензия на 2 года NOD32-ENA-NS(BOX)-2-1</description>
<sales_notes>Оплата: Наличные, Б/Н, пластиковые карты, кредит</sales_notes>
<manufacturer_warranty>true</manufacturer_warranty>
<country_of_origin>Россия</country_of_origin>
<age unit="year">18</age>
</offer>

Elements included in the <offer>

Element

Description

name

Product offering name We recommend indicating the vendor or manufacturer name and code in the name of a simplified offer.

Required element.

model

Model.

Optional element.

vendor

Vendor or manufacturer.

Optional element.

vendorCode

Product code (enter the vendor code).

Optional element.

id

Product ID.

Required element.

url

URL of the product page.

Required element.

price

The price at which this product is being offered.

Required element.

oldprice

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

Optional element.

currencyId

Currency (RUR, USD, UAH, KZT).

Required element.

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

Optional element.

picture

Link to image.

Required element.

store

Product available in retail stores:

  • true — yes;

  • false — no.

Optional element.

pickup

Customer pickup from delivery point:

  • true — available;

  • false — not available.

Optional element.

delivery

Delivery by courier:

  • true — available;

  • false — not available.

Optional element.

description

Product offering description.

Optional element.

sales_notes

Order information:

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

  • payment options, descriptions of promotions and sales.

Optional element.

manufacturer_warranty

Official warranty:

  • true — available;

  • false — not available.

Optional element.

country_of_origin

Country of origin.

Optional element.

adult

This products belongs to the “adult” category:

  • true — yes;

  • false — no.

Optional element.

age

Product age category.

Optional element.

downloadable

Product download:

  • true — yes;

  • false — no.

Optional element.

This type of description is practical and versatile. We recommend using it for describing products in most categories.

Example:
<offer id="1234567" type="vendor.model" available="true">
<url>http://www.надежнаятехника.рф/catalog/element/index.php?from=ya_market&amp;utm_source=ya_market&amp;utm_medium=cpc&amp</url>
<price>889.00</price>
<oldprice>17000.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>Принтер</typePrefix>
<vendor>НP</vendor>
<model>Deskjet D2663</model>
<description>
Серия принтеров для людей, которым нужен надежный, простой в использовании цветной принтер для повседневной печати...
</description>
<sales_notes>Необходима предоплата.</sales_notes>
<manufacturer_warranty>true</manufacturer_warranty>
<country_of_origin>Япония</country_of_origin>
</offer>
Elements included in the <offer>

Element

Description

type

Product offering description type. The value must be vendor.model.

Required element.

model

Model.

Required element.

vendor

Vendor or manufacturer.

Required element.

vendorCode

Product code (enter the vendor code).

Optional element.

typePrefix

Product type / category (for example, “mobile telephone”, “washing machine”, “corner sofa”).

Optional element.

id

Product ID.

Required element.

url

URL of the product page.

Required element.

price

The price at which this product is being offered.

Required element.

oldprice

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

Optional element.

currencyId

Currency (RUR, USD, UAH, KZT).

Required element.

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

Optional element.

picture

Link to image.

Required element.

delivery

Delivery by courier:

  • true — available;

  • false — not available.

Optional element.

pickup

Customer pickup from delivery point:

  • true — available;

  • false — not available.

Optional element.

store

Product available in retail stores:

  • true — yes;

  • false — no.

Optional element.

description

Product offering description.

Optional element.

sales_notes

Order information:

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

  • payment options, descriptions of promotions and sales.

Optional element.

manufacturer_warranty

Official warranty:

  • true — available;

  • false — not available.

Optional element.

country_of_origin

Country of origin.

Optional element.

adult

This products belongs to the “adult” category:

  • true — yes;

  • false — no.

Optional element.

age

Product age category.

Optional element.

downloadable

Product download:

  • true — yes;

  • false — no.

Optional element.

Rate this article
Thank you for your feedback!