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>

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.

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.

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.