Feeds for products according to Google specification are supported in XML and CSV/TSV formats. See below for sample files.
Required fields
id
Type: string
Description: Unique product ID
Requirements/Constraints:
- Maximum allowed number of characters: 128.
- The product ID must be unique within one product feed.
- The product ID can include all characters of the Latin alphabet in upper and lower case, underscores and hyphens, as well as numbers.
Example: 10000000179185
title
Type: string
Description: Product name
Requirements/Constraints:
- Maximum number of characters allowed: 256
- The text must not be written in capital letters only
- The text must not be written in lowercase letters only
Example: T-shirt
price
Type: string
Description: Sale or rental price of the property
Requirements/Constraints:
- Price as a number with a three-letter ISO 4217 currency code separated by a space.
- Use a dot (.) as the decimal separator, not a comma (,).
- Do not specify a currency using $, €, or £ symbols.
Supported currency codes:
- RUR or RUB: Russian rouble
- USD: American dollar
- EUR: Euro
- UAH: Ukrainian Hryvnia
- BYN: Belarusian ruble
- KZT: Kazakh tenge
- MDL: Moldovan Leu
- AZN: Azerbaijani manat
- UZS: Uzbek soum
- AMD: Armenian Dram
- TJS: Tajik Somoni
- KGS: Kyrgyz som
Example: 1000000 RUB
link
Type: string
Description: URL of the product page on the company website, where customers can learn more about the product or buy it
Requirements/Constraints: The links must be valid, start with http:// or https:// and be located on the domain of your company website. They must lead to the correct page for each of the products.
Example: https://example.ru/item/10000000188131.html
image_link
Type: string
Description: URL of the main image
Requirements/Constraints:
- Acceptable image file formats are JPEG, PNG, GIF, WEBP.
- Recommended size: 600 pixels on the largest side.
- Minimal size: 300 pixels.
- Maximum size: 6000 pixels on the largest side.
- The background of the image should be monochrome, we recommend using white colour for the background.
- The image should only show the product itself without any additional inscriptions, watermarks or logos.
The image of the product must comply with Rules for Placing Advertisements.
Example: https://somesite.ru/item/10000000188131.jpeg
Note! When updating an image, be sure to change the link to it, otherwise the changes will not be recognized.
brand
Type: string
Description: Product brand name
Requirements/Constraints: Maximum number of characters: 256
Example: Sokolov
Optional fields
availability
Type: string
Description: Current item availability
Requirement/Constraint: Supported values: True (in stock) and False (out of stock)
Example: False
description
Type: string
Description: Product description.
Requirements/Constraints: Maximum allowed number of characters: 256.
Product descriptions must not contain:
- HTML code or links,
- Excessive punctuation (e.g. "!!!"), upper or lower case letters only,
- Shipping or company information,
- Phone numbers and email addresses,
- Complex text, such as list items or multiple paragraphs.
Example: Women's organic cotton t-shirt in royal blue. Loose fit
condition
Type: string
Description: State of the product
Requirements/Constraints: One of the values:
- new
- refurbished
- used
Example: new
age_group
Type: string
Description: The age group for which the product is intended.
Requirements/Constraints: One of the values:
- adult,
- all ages,
- teen,
- kids (children over 3 years old),
- toddler (children one to three years old),
- infant,
- newborn.
Example: newborn
gender
Type: string
Description: The gender for which the product is intended
Requirements/Constraints: One of the values:
- female,
- male,
- unisex.
Tag values can be either upper case or lower case. For example: FEMALE, Female, female.
Example: unisex
sale_price
Type: string
Description: Discounted price of the product
Requirements/Constraints: The requirements to the field content and formatting are the same as for the price field
Example: 9.99 USD or 700.99 RUB
min_price
Type: string
Description: The minimum price of the product. When adding a minimum product price to the banner, the preposition "from" is specified before the price.
Requirements/Constraints: The requirements to the field content and formatting are the same as for the price field.
Example: 1000 RUB
max_price
Type: string
Description: Maximum price of the product. When adding a minimum product price to the banner, the preposition "to" is specified before the price.
Requirements/Constraints: The requirements to the field content and formatting are the same as for the price field.
Example: 5000 RUB
product_type
Options: fb_product_category or google_product_category
Type: string
Description: The category the product belongs to according to the advertiser's product categorization system
Requirements/Constraints: Maximal allowed number of characters: 750
Example: Home & Garden > Kitchen & Dining > Appliances > Refrigerators
custom_label
Options: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
Type: string
Description: Custom fields with additional information. Used when creating product groups.
Requirement/Constraint: Max allowed number of characters: 256
Example: Summer sale
rating
Type: float
Description: User rating of the product
Requirement/Constraint: Only positive float numbers from 1 to 5 inclusive may be used
Example: 4.0
Required fields for mobile apps
android_tracking_url
Type: string
Description: Tracking link for Android
Requirements/Constraints:
- Links must be valid, starting with http:// or https://
- Acceptable domains depending on the application tracker used
- MyTracker: trk.mail.ru
- Adjust: app.adjust.com
- Appsflyer: app.appsflyer.com
- AppMetrica: redirect.appmetrica.yandex.com
Example: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int
ios_tracking_url
Type: string
Description: Tracking link for iOS
Requirements/Constraints:
- Links must be valid, starting with http:// or https://
- Acceptable domains depending on the application tracker used
- myTracker: trk.mail.ru
- Adjust: app.adjust.com
- Appsflyer: app.appsflyer.com
- AppMetrica: redirect.appmetrica.yandex.com
Example: https://app.appsflyer.com/id1154436683?pid=mail.ru_int
android_app_link
Type: string
Description: Identifier of the Android application
Requirement/Constraints: none
Example: ru.sunlight.sunlight
mobile_ios_app_store_id
Type: string
Description: iOS application identifier
Requirements/Constraints: none
Example: 1068913968
mobile_android_app_link
Type: string
Description: Deep link for Android
Requirements/Constraints:
- URL schemas of mobile_android_app_link and mobile_ios_app_link fields must match
- The deep link must open correctly (valid)
Example:
- https://goldapple.ru/11139-10023300001-vanilla-lime#sku%3D10023300001
- ozon://products/105207/
mobile_ios_app_link
Type: string
Description: Deep link for iOS
Requirements/Constraints:
- URL schemas of mobile_android_app_link and mobile_ios_app_link fields must match
- The deep link must open correctly (be valid)
Example:
- https://goldapple.ru/11139-10023300001-vanilla-lime#sku%3D10023300001
- ozon://products/105207/
An example of a product feed in XML format. Atom 1.0 specification
<?xml version="1.0"?><feed xmlns="http://www.w3.org/2005/Atom" xmlns:g="http://base.google.com/ns/1.0"> <entry> <g:id>TV_123456</g:id> <g:title>LG 22LB4510 - 22" LED TV - 1080p (FullHD)</g:title> <g:description>Attractively styled and boasting stunning picture quality, the LG 22LB4510 - 22" LED TV - 1080p (FullHD) is an excellent television/monitor. </g:description> <g:link>http://www.example.com/electronics/tv/22LB4510.html</g:link> <g:image_link>http://images.example.com/TV_123456.png</g:image_link> <g:condition>used</g:condition> <g:availability>in stock</g:availability> <g:price>159.00 RUB</g:price> <g:rating>5.0</g:rating> <g:brand>LG</g:brand> <g:product_type>Consumer Electronics > TVs > Flat Panel TVs</g:product_type> </entry></feed>
Example of a product feed in XML format. RSS 2.0 specification
<rss xmlns:g="http://base.google.com/ns/1.0" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xml:lang="ru-RU"><channel><title>Store fancy clothes</title><link>https://butik.com/</link><description>Butik.COM - Men's Clothing Boutique</description><item><g:id>21286</g:id><g:title>Denim Jacket</g:title><g:link>https://butik.com/katalog-tovarov/kurtka-dzhinsovaya-524577-10.html</g:link><g:description>Gray denim jacket with detachable hood</g:description><g:image_link>https://butik.com/files/7/103/276922.jpg</g:image_link><g:brand>Karl Lagerfeld</g:brand><g:condition>new</g:condition><g:availability>in stock</g:availability><g:price>24000.00 RUB</g:price><g:rating>5.0</g:rating></item></channel></rss>
Example feed in CSV format
Example of a feed with mobile parameters
<rss xmlns:g="http://base.google.com/ns/1.0" version="2.0"><channel><title>Vill</title><link>https://vill.ru</link><description>Ville is a chain of grocery stores.</description><item><g:title>Sour cream 25%, 350 г</g:title><g:link>https://vill.ru/goods/sour-cream-25-350-g-52.html</g:link><g:image_link>https://img.vill.ru/pim/images/site_for_feed/c68308ef-2969-4fce-8488-558c4400a353.jpg?1706056095.0147</g:image_link><g:mobile_ios_app_link>vill://goods/52</g:mobile_ios_app_link><g:mobile_ios_app_store_id>100500</g:mobile_ios_app_store_id><g:mobile_android_app_link>vill://goods/52</g:mobile_android_app_link><g:android_app_link>ru.vill</g:android_app_link><android_tracking_url>https://app.appsflyer.com/ru.vill?af_dp=vill%3A%2F%2Fgoods%2F52</android_tracking_url><ios_tracking_url>https://app.appsflyer.com/id100500?af_dp=vill%3A%2F%2Fgoods%2F52</ios_tracking_url><g:condition>new</g:condition><g:availability>in stock</g:availability><g:id>52</g:id><g:product_type>Dairy products</g:product_type><g:price>151 RUB</g:price><g:brand>Ville</g:brand></item></channel></rss>