Feed requirements. Other categories

Use the Google Ads “ Hotels and rentals” CSV feed for the “Hotels” business type. 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 smart banners or dynamic ads.

Element	Description
Property ID	ID of hotel. Required element.
Property name	Name of hotel. Required element.
Final URL	The URL of the offer page. Required element.
Destination name	Location of hotel (no more than 25 characters). Required element.
Image URL	Image link. We recommend to use images of at least 500px in width or height. Required element (for smart banners).
Price	The price of the offer. Currency number and code (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator. Recommended element.
Star rating	The number of stars. A whole number from 1 to 5.
Score	User rating, expressed as number. Use a dot (.) as the decimal separator.
Max score	Maximum possible rating, expressed as a whole number. The default number is 5.
Facilities	Facilities or services provided by the hotel. Enter the values separated by semicolons: bar;pool;free Wi-Fi
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 example, you can set a filter by whether a hotel 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 example, you can set a filter by an offer's profit margin.

Element	Description
Property ID	ID of hotel. Required element.
Property name	Name of hotel. Required element.
Final URL	The URL of the offer page. Required element.
Destination name	Location of hotel (no more than 25 characters). Required element.
Image URL	Image link. We recommend to use images of at least 500px in width or height. Required element (for smart banners).
Price	The price of the offer. Currency number and code (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator. Recommended element.
Star rating	The number of stars. A whole number from 1 to 5.
Score	User rating, expressed as number. Use a dot (.) as the decimal separator.
Max score	Maximum possible rating, expressed as a whole number. The default number is 5.
Facilities	Facilities or services provided by the hotel. Enter the values separated by semicolons: bar;pool;free Wi-Fi
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 example, you can set a filter by whether a hotel 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 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".

You should use the Auto.ru feed in XML format for “Automobile” businesses. Data in the feed must be encoded in UTF-8.

Description of the XML format for passenger cars in Auto.ru Help

The list of advertised offers is contained in the <cars> element. Each car is described in a separate <car> element.

Example:

• For a brand new car
• For a previously owned car

<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Hyundai</mark_id>
            <folder_id>Sonata</folder_id>
            <modification_id>2.0 AT (150 Hp)</modification_id>
            <url>http://www.auto.ru/1</url>
            <images>http://picture.auto.ru/1.jpg</images>
            <body_type>Sedan</body_type>
            <color>gray</color>
            <availability>in stock</availability>
            <custom>cleared</custom>
            <year>2022</year>
            <price>2575000</price>
            <currency>RUB</currency>
            <vin>XWBCA41ZXDK259205</vin>
            <owners_number>No past owners</owners_number>
         </car>
     </cars>
</data>

<?xml version="1.0"?>
<data>
    <cars>
        <car>
            <mark_id>Nissan</mark_id>
            <folder_id>Juke, I Restyled</folder_id>
            <modification_id>1.6 CVT (117 Hp)</modification_id>
            <url>http://www.auto.ru/2</url>
            <body_type>SUV 5 doors</body_type>
            <color>white</color>
            <availability>in stock</availability>
            <custom>cleared</custom>
            <state>moderate</state>
            <owners_number>one owner</owners_number>
            <run>60000</run>
            <year>2017</year>
            <price>550000</price>
            <currency>RUB</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 smart banners or dynamic ads.

Element	Description
unique_id	Product offer ID. Required element if the vin element is omitted.
vin	Automobile VIN (17 symbols). Required element if the unique_id element is omitted.
url	A link to the product offer page. Required element.
images	A link to an image of the specific model or model variant. Required element (for smart banners). You can use multiple image tags inside the images tag. <images> <image></image> <image></image> </images> Add multiple images in different formats (horizontal, vertical, square), each in a separate image tag. The image that best fits the aspect ratio will be used.
price	The price at which the automobile may be purchased. Recommended element.
currency	Currency code (RUB, USD, UAH, KZT). Required element if the price element is present.
mark_id	The name of the car brand. Required element if the folder_id element is omitted.
folder_id	The name of the model. Required element if the mark_id element is omitted.
modification_id	The name of the model variant.
year	The year the automobile was manufactured.
run	Mileage in kilometers. Use an integer higher than 0.
owners_number	Number of owners by Vehicle Title. Restricted values one owner two owners three owners four or more owners. no owners.
body_type	The body type of the automobile. Restricted values SUV convertible compact MPV coupe hardtop coupe landaulet limousine liftback microvan minivan pickup roadster sedan hardtop sedan speedster targa station wagon fastback phaeton phaeton estate van hatchback
color	Vehicle color. Restricted values beige white light blue yellow green gold brown red orange purple pink silver gray blue violet
state	Vehicle condition. Restricted values excellent good moderate requires repair.
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 example, you can set a filter by whether a car is part of a specific 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 example, you can set a filter by an offer's profit margin.

Element	Description
unique_id	Product offer ID. Required element if the vin element is omitted.
vin	Automobile VIN (17 symbols). Required element if the unique_id element is omitted.
url	A link to the product offer page. Required element.
images	A link to an image of the specific model or model variant. Required element (for smart banners). You can use multiple image tags inside the images tag. <images> <image></image> <image></image> </images> Add multiple images in different formats (horizontal, vertical, square), each in a separate image tag. The image that best fits the aspect ratio will be used.
price	The price at which the automobile may be purchased. Recommended element.
currency	Currency code (RUB, USD, UAH, KZT). Required element if the price element is present.
mark_id	The name of the car brand. Required element if the folder_id element is omitted.
folder_id	The name of the model. Required element if the mark_id element is omitted.
modification_id	The name of the model variant.
year	The year the automobile was manufactured.
run	Mileage in kilometers. Use an integer higher than 0.
owners_number	Number of owners by Vehicle Title. Restricted values one owner two owners three owners four or more owners. no owners.
body_type	The body type of the automobile. Restricted values SUV convertible compact MPV coupe hardtop coupe landaulet limousine liftback microvan minivan pickup roadster sedan hardtop sedan speedster targa station wagon fastback phaeton phaeton estate van hatchback
color	Vehicle color. Restricted values beige white light blue yellow green gold brown red orange purple pink silver gray blue violet
state	Vehicle condition. Restricted values excellent good moderate requires repair.
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 example, you can set a filter by whether a car is part of a specific 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 example, you can set a filter by an offer's profit margin.

You should use the Yandex Realty feed in YRL (Yandex Realty Language) format for “Realty” businesses. For more information about the YRL format, see Yandex Realty Help.

Each product offer 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>sale</type>
  <property-type>residential</property-type>
  <category>apartment</category>
  <url>http://www.developer.ru/search18</url>
  <creation-date>2015-04-02T19:00:06+03:00</creation-date>
  <location>    
    <locality-name>Saint Petersburg</locality-name>
    <sub-locality-name>Vasilyevsky island</sub-locality-name>
    <address>Line 18 V.O., 32</address>
    <metro>
      <name>Vasileostrovskaya</name>
      <time-on-foot>10</time-on-foot>
      <time-on-transport>5</time-on-transport>
   </metro>
  </location>
  <deal-status>primary sale</deal-status>
  <price>
    <value>4780000</value>
    <currency>RUB</currency>
  </price>
  <sales-agent>    
    <organization>Builders Inc</organization>    
  </sales-agent>
  <rooms>2</rooms>
  <floor>13</floor>
  <floors-total>15</floors-total>
  <area>
    <value>63.00</value>
    <unit>sq.m.</unit>
  </area>
  <building-name>Northern Fantasy</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-room apartment for sale, 13th floor, 15-minute driving distance from Vasileostrovskaya metro station. A comfort-class residential complex with intelligent layout solutions and a wide choice of apartments. The inner courtyard of 'Northern Fantasy' was created according to an exclusive design project. The surrounding infrastructure includes schools and kindergartens, a hospital, pharmacies, shops, cafés, and sports facilities. Multiple mortgage programs, discounts, and trade-in options available.</description>
  <custom_label_0>one-room apartments</custom_label_0> 
  <custom_label_1>serviced apartments</custom_label_1>
  <custom_score>4580000<custom_score> 
</offer>

Attributes of the <offer> element

Child elements of the <offer> element

The table below describes feed elements which are used for creating smart banners or dynamic ads.

<location>
      <locality-name></locality>
      <address></address>
      <metro></metro>
      …
 </location>

<metro>
      <name></name>
      <time-on-foot></time-on-foot>
      <time-on-transport></time-on-transport>
</metro>

<sales-agent>
  <organization></organization>
</sales-agent>

<price>
    <value></value>
    <currency></currency>
</price>

<area>
  <value></value>
  <unit></unit>
</area>

<location>
      <locality-name></locality>
      <address></address>
      <metro></metro>
      …
 </location>

<metro>
      <name></name>
      <time-on-foot></time-on-foot>
      <time-on-transport></time-on-transport>
</metro>

<sales-agent>
  <organization></organization>
</sales-agent>

<price>
    <value></value>
    <currency></currency>
</price>

<area>
  <value></value>
  <unit></unit>
</area>

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

For the “Flights” business type, you can use the Google Ads “Flights” feed 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 flights in CSV format

Elements included in CSV

The table below describes feed elements which are used for creating smart banners or dynamic ads.

Element	Description
Destination ID	Destination ID. Required element.
Destination name	Destination name. Required element.
Destination address	Address of destination.
Origin ID	Origin ID. If you specified the Origin ID in the feed and enabled e-commerce in Yandex Metrica, use the Origin ID and Destination ID (separated by a hyphen) in the e-commerce object as the offer ID. For example, "id": "VKO-LHR".
Origin name	Origin name.
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).
Flight price	The price of the offer. Currency number and code (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator. Recommended element.
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 example, you can set a filter by whether a flight is part of a specific 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 example, you can set a filter by an offer's profit margin.

Element	Description
Destination ID	Destination ID. Required element.
Destination name	Destination name. Required element.
Destination address	Address of destination.
Origin ID	Origin ID. If you specified the Origin ID in the feed and enabled e-commerce in Yandex Metrica, use the Origin ID and Destination ID (separated by a hyphen) in the e-commerce object as the offer ID. For example, "id": "VKO-LHR".
Origin name	Origin name.
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).
Flight price	The price of the offer. Currency number and code (RUB, USD, UAH, KZT). Use a dot (.) as the decimal separator. Recommended element.
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 example, you can set a filter by whether a flight is part of a specific 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 example, you can set a filter by an offer's profit margin.

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.

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.

You can use a Google Ads “Travel” 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.