Feed requirements. Other categories
Google Ads' Hotels and Rentals feed
Google Ads' Hotels and Rentals feed must be in CSV format. The first string contains the column names, while the following strings contain the 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 feed for hotels in CSV format
Elements included in CSV
The table below describes feed elements which are used for creating product ads or catalog page ads in the unified performance campaign.
Element |
Description |
|
ID of hotel. Required element. |
|
Accommodation type. For example:
|
|
Name of hotel. Required element. |
|
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. |
|
Location of hotel (no more than 25 characters). Required element. |
|
Image link. We recommend to use images of at least 500px in width or height. This element is required for serving ads in the Yandex Advertising Network |
|
Offer price. Currency number and code ( |
|
The number of stars. A whole number from 1 to 5. |
|
User rating, expressed as number. Use a dot (.) as the decimal separator. |
|
Maximum possible rating, expressed as a whole number. The default number is 5. |
|
Facilities or services provided by the hotel. Enter the values separated by semicolons: |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters. You can only use custom feed elements to create filters in 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 hotel is part of a certain promo. |
|
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. |
Note
Values that contain a comma need to be written in quotation marks (""). For example, "Moscow, center".
Auto.ru feed
Auto.ru feed must be in XML format. Data in the feed must be encoded in UTF-8.
Description of the XML format for passenger cars in Auto.ru Help.
The <cars>
element holds the list of offers from the business. Each car is described in a separate <car>
element.
Example:
<?xml version="1.0"?>
<data>
<cars>
<car>
<mark_id>Hyundai</mark_id>
<folder_id>Sonata</folder_id>
<modification_id>2.0 AT (150 л.с.)</modification_id>
<url>http://www.auto.ru/1</url>
<images>http://picture.auto.ru/1.jpg</images>
<body_type>Седан</body_type>
<color>серый</color>
<availability>в наличии</availability>
<custom>растаможен</custom>
<year>2022</year>
<price>2575000</price>
<currency>RUR</currency>
<vin>XWBCA41ZXDK259205</vin>
<owners_number>Не было владельцев</owners_number>
</car>
</cars>
</data>
<?xml version="1.0"?>
<data>
<cars>
<car>
<mark_id>Nissan</mark_id>
<folder_id>Juke, I Рестайлинг</folder_id>
<modification_id>1.6 CVT (117 л.с.)</modification_id>
<url>http://www.auto.ru/2</url>
<body_type>Внедорожник 5 дв.</body_type>
<color>белый</color>
<availability>в наличии</availability>
<custom>растаможен</custom>
<state>среднее</state>
<owners_number>Один владелец</owners_number>
<run>60000</run>
<year>2017</year>
<price>550000</price>
<currency>RUR</currency>
<vin>XWBCA41ZXDK259107</vin>
<images>
<image>http://price.site.ru/files/image2.jpg</image>
<image>http://price.site.ru/files/image3.jpg</image>
</images>
</car>
</cars>
</data>
Child elements included in the <car>
element
The table below describes feed elements which are used for creating product ads or catalog page ads in the unified performance campaign.
Element |
Description |
Required element |
|
Product offer ID. |
If the |
|
Automobile VIN (17 symbols). |
If the |
|
A link to the product offer page. |
yes |
|
A link to an image of the specific model or model variant.
You can use multiple
Add multiple images in different formats (horizontal, vertical, square), each in a separate |
Impressions in the Yandex Advertising Network |
|
The price at which the automobile may be purchased. |
Recommended |
|
Currency code ( |
if the |
|
The name of the car brand. |
If the |
|
The name of the model. |
If the |
|
The name of the model variant. |
no |
|
The year the automobile was manufactured. |
no |
|
Mileage in kilometers. Use an integer higher than 0. |
no |
|
Number of owners by Vehicle Title. Restricted values
|
no |
|
The body type of the automobile. Restricted values
|
no |
|
Vehicle color. Restricted values
|
no |
|
Vehicle condition. Restricted values
|
no |
|
To serve ads in a combined format (catalog page ads and product ads), transmit the link between the car description and the catalog. The value equals |
Recommended if |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters.
|
no |
|
Custom element. Numeric value: zero or a positive integer.
|
no |
In the feed, you can transmit information about car catalogs. In the tree structure, the <collections>
element comes after the <offers>
element.
Child elements of the <collections>
element
Element |
Description |
Required element |
||||||||||||
|
Unique catalog ID. Maximum length: 60 characters. The value can be numeric, alphabetic, or alphanumeric. The IDs for each catalog must be unique. |
yes |
||||||||||||
|
URL of the catalog page. Maximum link length: 2048 characters. You can use links in Cyrillic. (We recommend converting links in Cyrillic characters using Punycode). The URL format follows the RFC 3986 standard. The URL must specify the How to encode characters in a URL?
URLs must not contain spaces. Replace spaces with |
yes |
||||||||||||
|
Image link. You can add multiple image links, each in its own picture element. How do I change the image in the ad?For the Yandex robot to update the catalog image in ads, change its link in the feed. For example:
|
For impressions in YAN |
||||||||||||
|
Catalog name. |
yes |
||||||||||||
|
Catalog description. |
no |
Example for catalog pages
<?xml version="1.0" encoding=utf-8?>
<data>
<cars>
<car></car>
<car></car>
</cars>
<collections>
<collection id="1">
<url>https://auto.ru/new</url>
<name>Новые автомобили в наличии</name>
<description>Купить новые автомобили у официального дилера</description>
<picture>http://auto.ru/newavto/00016.jpg</picture>
</collection>
</collections>
</data>
Yandex Realty feed
Yandex Realty feed must be in YRL (Yandex Realty Language) format. For more information about the YRL format, see Yandex.Realty Help.
Each product offering is described in a separate <offer>
element.
You can send information about different residential homes by different property developers in one feed. To do this, enter legal information about the developer in the child <offer>
element for each <sales-agent>
element.
Example:
<offer internal-id="15782295">
<type>продажа</type>
<property-type>жилая</property-type>
<category>квартира</category>
<url>http://www.developer.ru/search18</url>
<creation-date>2015-04-02T19:00:06+03:00</creation-date>
<location>
<locality-name>Санкт-Петербург</locality-name>
<sub-locality-name>о. Васильевский</sub-locality-name>
<address>18-я линия В.О., 32</address>
<metro>
<name>Василеостровская</name>
<time-on-foot>10</time-on-foot>
<time-on-transport>5</time-on-transport>
</metro>
</location>
<deal-status>первичная продажа</deal-status>
<price>
<value>4780000</value>
<currency>RUR</currency>
</price>
<sales-agent>
<organization>ЗАО "Застройщик"</organization>
</sales-agent>
<rooms>2</rooms>
<floor>13</floor>
<floors-total>15</floors-total>
<area>
<value>63.00</value>
<unit>кв. м</unit>
</area>
<building-name>Северная фантазия</building-name>
<building-state>unfinished</building-state>
<ready-quarter>3</ready-quarter>
<image>http://www.developer.ru/images/plans/000001289.jpg</image>
<image>http://www.developer.ru/images/plans/000001290.jpg</image>
<description>Продается 2 к. кв., 13 этаж, 15 минут на машине до метро «Василеостровская».
Дом комфорт-класса с продуманными планировочными решениями и широким выбором квартир.
Внутренний двор «Северной фантазии» выполнен по эксклюзивному дизайн-проекту.
В районе постройки нового ЖК развита инфраструктура: школы и детские сады, больница, аптеки магазины, кафе и спортивные центры.
Доступны разные условия ипотеки, скидки и зачет жилья.</description>
</offer>
Attributes of the <offer>
element
Attribute |
Description |
|
Product offer ID. Mandatory attribute. |
Child elements of <offer>
element
The table below describes feed elements used for creating product ads or catalog page ads in unified performance campaigns.
Attribute |
Description |
Required element |
|
Type of deal.
Only value used is |
yes |
|
Type of deal. Category of the property. Possible values:
|
no |
|
Set of elements describing the location of the object in question. Information about the location is detailed in nested tags.
|
yes |
|
The name of the populated locality. |
yes |
|
The region where the populated locality is located. |
Recommended |
|
Street and house number. |
Recommended |
|
Nearest metro station.
|
Recommended |
|
The time it takes in minutes to get to the metro on public transport. |
Recommended |
|
Metro station name. |
Recommended |
|
The time it takes in minutes to get to the metro on foot. |
Recommended |
|
A link to the product offer page. |
yes |
|
Image link.
|
Impressions in the Yandex Advertising Network |
|
Name of the residential home or building. Apartments in the residential building are combined for this element. |
for new buildings |
|
Information about the developer. Detailed information is indicated in nested tags.
|
yes |
|
Legal name of the developer. |
yes |
|
Set of elements describing the price of the object in question. The sum and currency of the price is indicated in nested tags.
|
yes |
|
The price. |
Recommended |
|
Currency code ( |
if the |
|
Total area. The value and unit of measurement is indicated in nested tags.
|
Recommended |
|
The area value. Indicated as a numeric value. |
Recommended |
|
The unit of floor space.
Possible values: |
Recommended |
|
The floor the property is located on. |
Recommended |
|
The total number of floors in the building. |
no |
|
The total number of rooms in the apartment. For shell-and-core properties, the number of rooms is indicated according to the property's passport. This element is not used for studio apartments. |
no |
|
Type of bathroom. Possible values:
|
no |
|
Finishing. Possible values:
|
no |
|
Additional information. You can use it as a tag for manual management of ad titles and ad texts. |
no |
|
Construction stage. Values are restricted:
|
no |
|
Year of handover (year of construction). The year must be stated in full: for example, “1996” rather than “96”. |
for buildings (residential complexes) that were handed over less than 5 years ago or will be handed over in the future |
|
The quarter when the building was or will be handed over. Restricted values: “1”, “2”, “3”, “4”. |
no |
|
Type of building. Possible values:
|
no |
|
Type of deal. Possible values:
|
no |
|
To serve ads in a combined format (catalog page ads and product ads), pass real estate links to the catalog. The value equals |
Recommended if |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The element length can be up to 175 characters. Make sure that the element is not nested in other tags: 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 the name of a residential building. |
no |
|
Custom element. Numeric value: 0 or a positive integer. Make sure that the element is not nested in other tags: 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 the number of rooms. |
no |
In the feed, you can transmit information about real estate catalogs. In the tree structure, the <collections>
element comes after the closing tag of the last <offer>
element.
Child elements of the <collections>
element
Element |
Description |
Required element |
||||||||||||
|
Unique catalog ID. Maximum length: 60 characters. The value can be numeric, alphabetic, or alphanumeric. The IDs for each catalog must be unique. |
yes |
||||||||||||
|
URL of the catalog page. Maximum link length: 2048 characters. You can use links in Cyrillic. (We recommend converting links in Cyrillic characters using Punycode). The URL format follows the RFC 3986 standard. The URL must specify the How to encode characters in a URL?
URLs must not contain spaces. Replace spaces with |
yes |
||||||||||||
|
Image link. You can add multiple image links, each in its own picture element. How do I change the image in the ad?For the Yandex robot to update the catalog image in ads, change its link in the feed. For example:
|
For impressions in YAN |
||||||||||||
|
Catalog name. |
yes |
||||||||||||
|
Catalog description. |
no |
Example for catalog pages
<?xml version="1.0" encoding=utf-8?>
<realty-feed>
<offer>
</offer>
<collections>
<collection id="1">
<url>https://developer.ru/#/macrocatalog/complexes/1111111</url>
<name>Двухкомнатные квартиры на Васильевском острове</name>
<description>Двухкомнатные квартиры на Васильевском острове с отделкой от застройщика и современной планировкой</description>
<picture>http://www.developer.ru/images/plans/000001279.jpg</picture>
</collection>
</collections>
</realty-feed>
When creating ads, fill out the offers using as many available elements (tags) as possible, even if they aren't required. This will help create an eye-catching ad that will be displayed in all possible formats.
Examples of banners created from highly populated offers
![]() |
![]() |
![]() |
---|
Google Ads' Flights feed
Google Ads' Flights feed must be in CSV format. 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 feed for flights in CSV format
Elements included in CSV
The table below describes feed elements which are used for creating product ads or catalog page ads in the unified performance campaign.
Element |
Description |
|
Destination ID. Required element. |
|
Destination name. Required element. |
|
Address of destination. Completing this field increases the relevance of the ad titles and descriptions that will be generated. |
|
Origin ID.
If you specified the |
|
Origin name. |
|
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 link. We recommend to use images of at least 500px in width or height. This element is required for serving ads in the Yandex Advertising Network. |
|
The price of the offer. Currency number and code ( |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters. You can only use custom feed elements to create filters in 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 flight is part of a specific promo. |
|
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. |
Universal feed
Universal feed must be in CSV format. 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 product ads or catalog page ads in the unified performance campaign.
Element |
Description |
|
ID of item. Required element. |
|
Second product ID
If you specified |
|
The URL of the offer page. Required element. |
|
Image link. We recommend to use images of at least 500px in width or height. This element is required for serving ads in the Yandex Advertising Network. |
|
Offer name. |
|
Offer description. |
|
Offer price without currency distinction. Use a dot (.) as the decimal separator. Recommended element. |
|
Currency code ( |
|
Old offer price, must be higher than the new price ( |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters. You can only use custom feed elements to create filters in 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 an offer is part of a specific promo. |
|
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. |
Google Ads' Custom feed
Google Ads' Custom feed must be in CSV format. 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 a sample Google Ads' Custom feed in CSV format
Elements included in CSV
The table below describes feed elements which are used for creating product ads or catalog page ads in the unified performance campaign.
Element |
Description |
|
ID of item. Required element. |
|
Second product ID
If you specified |
|
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 link. We recommend to use images of at least 500px in width or height. This element is required for serving ads in the Yandex Advertising Network. |
|
Name of item. |
|
Offer description. |
|
Offer price with a currency code in ISO 4217 encoding (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator. Recommended element. |
|
New offer price, must be lower than the old price ( |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters. You can only use custom feed elements to create filters in 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 an offer is part of a specific promo. |
|
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. |
Google Ads' Travel feed
Google Ads' Travel feed must be in CSV format. 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 a sample Google Ads' Travel feed in CSV format
Elements included in CSV
The table below describes feed elements which are used for creating product ads or catalog page ads in the unified performance campaign.
Element |
Description |
|
Destination ID. Required element. |
|
Destination name. Required element. |
|
Address of destination. Completing this field increases the relevance of the ad titles and descriptions that will be generated. |
|
Origin ID.
If you specified the |
|
Origin name. |
|
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 link. We recommend to use images of at least 500px in width or height. This element is required for serving ads in the Yandex Advertising Network. |
|
Name of item. |
|
Offer price with a currency code in ISO 4217 encoding ( |
|
New offer price, must be lower than the old price ( |
|
Custom elements. Free-form description. Latin and Cyrillic characters and numbers. The maximum length of one element is 175 characters. You can only use custom feed elements to create filters in 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 an offer is part of a specific promo. |
|
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. |
Questions?
Alert
Our customer service department can only help you with the campaigns created under the same username you use to contact us. You can check your username by opening ya.ru in another browser tab. Our team can access your data only when processing your request.