Feed requirements. Product sales. Other types

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:sale_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. You can add an image link from a third-party service, but it must be direct and free of intermediaries. For example, you can't use images uploaded to Yandex Disk because this link won't be direct.

<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_4>
• <g:custom_label_4>
• <g:custom_label_4>
• <g:custom_label_4>
• <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 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 specific promo.

<g:custom_label_0>summer release</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 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

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 the offer ID. For example, "id": "VKO-LHR".

URL

An offer page URL for promoting a site or a tracking link for promoting a mobile app. If you are promoting a mobile app, we recommend adding deferred deeplinks. Required element.

Image

Image link. We recommend to use images of at least 500px in width or height. You can add an image link from a third-party service, but it must be direct and free of intermediaries. For example, you can't use images uploaded to Yandex Disk because this link won't be direct. This element is required for serving ads in the Yandex Advertising Network.

Title

Name of item.

Description

Offer description.

Price

Offer price 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

Old offer price, must be higher than the new price (Price).

• custom_label_0
• custom_label_0
• custom_label_0
• custom_label_0
• custom_label_0

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 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 promotion.

custom_score

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

You can only use custom feed elements to create filters for 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 the offer ID. For example, "id": "VKO-LHR".

Final URL

An offer page URL for promoting a site or a tracking link for promoting a mobile app. If you are promoting a mobile app, we recommend adding deferred deeplinks. Required element.

Image URL

Image link. We recommend to use images of at least 500px in width or height. You can add an image link from a third-party service, but it must be direct and free of intermediaries. For example, you can't use images uploaded to Yandex Disk because this link won't be direct. This element is required for serving ads in the Yandex Advertising Network.

Item title

Name of item.

Item description

Offer description.

Price

Offer price 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, must be lower than the old price (Price).

• custom_label_0
• custom_label_0
• custom_label_0
• custom_label_0
• custom_label_0

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 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 promotion.

custom_score

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

You can only use custom feed elements to create filters for 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.