Feed requirements. Product sales. Other types

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 must have the same ID in both the Yandex Market feed and the Google Shopping feed.

Retail, other business: Google Shopping feed

You can use a feed in Google Shopping format for the “Retail” and “Other business” types.

Example:
<channel>
<title>example.ru online store</title>
<link>example.ru</link>
<item>
<g:link>
https://example.ru/catalog/kompyutery/kompyuter-apple-mac-mini-z12p000b0-apple-m1-16gb-512gb/</g:link>
<g:id>123</g:id>
<g:price>15550.00 RUB</g:price>
<g:sale_price>12550.00 RUB</g:sale_price>
<g:condition>new</g:condition>
<g:availability>in stock</g:availability>
<g:product_type>Computers</g:product_type>
<g:image_link>
https://example.ru/upload/iblock/40a/40aca7181dcb81cb1cbffb3bc555e038.jpg
</g:image_link>
<g:brand>Apple</g:brand>
<g:google_product_category>Electronics</g:google_product_category>
<g:title>Computer APPLE Mac mini Z12P000B0, Apple M1, 16GB, 512GB (SSD), macOS, silver</g:title>
<g:description>
APPLE Mac mini Z12P000B0 features a matte enclosure case making it stylish and practical. The model weighs only 1.2 kg, making it easy to transport and store. To connect wired devices, you can use USB 3.0, HDMI, and Thunderbolt ports. For wireless devices, you can use the built-in Bluetooth module. This computer is Wi-Fi-enabled, so you won't have any problems getting online. Its SSD stores up to 512 GB.
</g:description>
</item>
</channel>
Elements included in Google Shopping
Element Description Example
<g:id> The product ID can include characters and digits. Required element. The IDs of each product must be unique and not overlap in different feeds. <g:id>123</g:id>
<g:title> Product name. Required element. <g:title>Computer APPLE Mac mini Z12P000B0, Apple M1, 16GB, 512GB(SSD), macOS, silver</g:title>
<g:description> Product description. Recommended element. <g:description>APPLE Mac mini Z12P000B0 features a matte finish that makes it stylish and practical. The model weighs only 1.2 kg, making it easy to transport and store. To connect wired devices, you can use USB 3.0, HDMI, and Thunderbolt ports. For wireless devices, you can use the built-in Bluetooth module. This computer is Wi-Fi-enabled, so you won't have any problems getting online. Its SSD stores up to 512 GB.</g:description>
<g:link> Link to the product on the site. Required element. <g:link>https://example.ru/catalog/kompyutery/kompyuter-apple-mac-mini-z12p000b0-apple-m1-16gb-512gb/</g:link>
<g:price> The price of the product in the currency. Format: “1000.00 RUB”. Recommended element. <g:price>15550.00 RUB</g:price>
<g:price> The price of the product with discount. The format is similar to <g:price>. Recommended element. <g:sale_price>12550.00 RUB</g:sale_price>
<g:image_link> Link to the product image. Required element. <g:image_link>https://example.ru/upload/iblock/40a/40aca7181dcb81cb1cbffb3bc555e038.jpg</g:image_link>
<g:brand> Manufacturer's brand. Optional element. <g:brand>Apple</g:brand>
<g:availability> Product availability. Optional element. It can take three values: in stock, out of stock, or preorder. <g:availability>in stock</g:availability>
<g:google_product_category> Product category according to the Google specification. Optional element. <g:google_product_category<Electronics</g:google_product_category>
<g:product_type> The product category on your site. Optional element. <g:product_type>Computers</g:product_type>
<g:condition> The condition of the product. Optional element. <g:condition>new</g:condition>
<g:material> Product material. Optional element. <g:material>Aluminum</g:material>
<g:gender> Gender Optional element. <g:gender>Men</g:gender>
<g:size> Product size or dimensions. Optional element. <g:size>44RUS</g:size>
<g:color> Product color. Optional element. <g:color>Blue</g:color>
  • <g:custom_label_0>
  • <g:custom_label_1>
  • <g:custom_label_2>
  • <g:custom_label_3>
  • <g:custom_label_4>

Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The element length can be up to 175 characters.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For example, you can set a filter by whether a product is part of a certain promo.

<g:custom_label_0>summer renewal</g:custom_label_0>
<g:custom_score>

Custom element. Numeric value: 0 or a positive integer.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For example, you can set a filter by an offer's profit margin.

<g:custom_score>11</g:custom_score>

If your feed includes tags not specified in the table, don't delete them. Extra tags are ignored during processing.

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. The IDs of each product must be unique and not overlap in different feeds.

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 e-commerce object as an offer ID. For example, "id": "VKO-LHR".

URL

The URL of the offer page.

Required element.

Image

Image link. We recommend to use images of 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 offer price, which must be higher than the new price (Price).

  • custom_label_0
  • custom_label_1
  • custom_label_2
  • custom_label_3
  • custom_label_4

Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The element length can be up to 175 characters.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For instance, for e-commerce, you can set a filter by whether a product is part of a certain promo.

custom_score

Custom element. Numeric value: 0 or a positive integer.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For instance, for e-commerce, you can set a filter by an offer's profit margin.

Other business: Google Ads “Custom” feed

You can use a Google Ads “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 Google Ads “Custom” 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. The IDs of each product must be unique and not overlap in different feeds.

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 e-commerce object as an offer ID. For example, "id": "VKO-LHR".

Final URL

The URL of the offer page.

Required element.

Image URL

Image link. We recommend to use images of 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

New offer price, which must be lower than the old price (Price).

  • custom_label_0
  • custom_label_1
  • custom_label_2
  • custom_label_3
  • custom_label_4

Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The element length can be up to 175 characters.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For instance, for e-commerce, you can set a filter by whether a product is part of a certain promo.

custom_score

Custom element. Numeric value: 0 or a positive integer.

You can only use custom feed elements to create filters for smart banners, dynamic ads, and unified performance campaigns. They don't affect the way creatives are generated. These filters are used for offer segmentation by specific parameters with no standard filters available. For instance, for e-commerce, you can set a filter by an offer's profit margin.

Have questions?

Attention. Our customer service can help you with the campaigns created under the same login that you use to contact us. You can see your current login in the upper-right corner of the screen. Our team can access your data only when processing your request.