Обязательные поля в фидах данных для недвижимости
| Название, тип и описание | Требования |
|---|---|
| offer.internal-id (строка) - уникальный ID объекта недвижимости | Максимальное число символов: 128 ID должен быть уникальным в рамках одного товарного фида ID может включать все символы латинского алфавита в верхнем и нижнем регистре, символы нижнего подчеркивания и дефис, а также цифры Например: 10000000179185 |
| location (строка) - месторасположение объекта недвижимости | |
address (строка) - адрес объекта недвижимости (улица) (вложено в location)
| Максимальное число символов: 256 Например: 3-я улица Строителей, 55 |
locality-name (строка) - населенный пункт, в котором расположен объект недвижимости (вложено в location)
| Максимальное число символов: 256 Например: Санкт-Петербург |
region (строка) - регион, в котором расположен объект недвижимости (вложено в location)
| Максимальное число символов: 256 Например: Санкт-Петербург |
country (строка) - страна, в которой расположен объект недвижимости (вложено в location)
| Максимальное число символов: 256 Например: Россия |
| price - цена продажи или аренды объекта недвижимости | |
value (int) - цена в виде числа (вложено в price)
| В качестве десятичного разделителя необходимо использовать точку (.), а не запятую (,) Значение поля должно быть более 0 Например: 4000000 |
currency (строка) - валюта в виде кода (вложено в price)
| Поддерживаемые коды валют:
Не указывайте валюту с помощью символов $, € или £ Например: RUR |
| image (строка) - URL основного изображения | Допустимые форматы файла изображения — JPEG, PNG, GIF, WEBP Рекомендуемый размер: 600px по большей стороне Минимальный размер: 300px по большей стороне Максимальный размер: 6000px по большей стороне Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: https://somesite.ru/item/10000000188131.jpeg При обновлении изображения обязательно измените ссылку на него, иначе изменения не будут распознаны. Изображение товара должно соответствовать требованиям Правил размещения рекламы. См. также Пояснения к Правилам размещения рекламы |
| url (строка) - URL страницы объекта недвижимости на сайте компании | Ссылки должны быть рабочими, начинаться с http:// или https:// и размещаться на домене сайта вашей компании Они должны вести на правильную страницу каждого объекта недвижимости Например: https://somesite.ru/item/10000000188131.html |
Правила формирования названия объекта недвижимости:
- если поле
<building-name>не пустое, то используется его значение для названия, - если поле
<building-name>пустое, то используется составное название объекта недвижимости вида:<category> + <country> + <locality-name> + <address>
Необязательные поля в фидах данных для недвижимости
| Название, тип и описание | Требования |
|---|---|
| organization (строка) - название компании-застройщика | Максимальное число символов: 256 Например: СМУ-88 |
metro (строка) - ближайшая станция метро (вложено в location)
| Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация. Например: Удельная |
name (строка) (вложено в metro)
| Например: Удельная |
| description (строка) - описание объекта недвижимости | Максимальное число символов: 256 Например: Уютный жилой комплекс в 15 минутах от центра города |
| rooms (float) - общее количество комнат | Требований нет Например: 3 |
| floor (int) - этаж, на котором расположен объект недвижимости | Требований нет Например: 3 |
| floors_total (int) - всего этажей в здании, где расположен рекламируемый объект недвижимости | Требований нет Например: 15 |
| category (строка) - вид недвижимости | Допустимые значения:
Например: apartment |
| type (строка) - тип объявления | Одно из значений:
Например: продажа |
| area (строка) - площадь объекта недвижимости |
|
value (int) - значение площади объекта (вложено в area)
| Требований нет Например: 250 |
unit (строка) - единица измерения площади объекта недвижимости (вложено в area)
| Одно из значений:
Например: sq_m |
| built-year (строка) - год постройки объекта недвижимости | Максимальное число символов: 256 Например: 2020 |
custom_label (строка) - пользовательские поля с дополнительной информацией. Используются при создании групп продуктов Варианты: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
| Максимальное число символов: 256 Например: Летняя распродажа |
Обязательные поля для рекламы мобильных приложений
| Название, тип и описание | Требования |
|---|---|
| android_tracking_url (строка) - трекинг-ссылка для Android | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/goldapple.ru.goldapple.customers?pid=mail.ru_int |
| ios_tracking_url (строка) - трекинг-ссылка для iOS | Ссылки должны быть рабочими, начинаться с http:// или https:// Допустимые домены в зависимости от используемого трекера приложений
Например: https://app.appsflyer.com/id1154436683?pid=mail.ru_int |
| bundle_id (строка) - идентификатор Android приложения | Требований нет Например: ru.sunlight.sunlight |
| ios_app_store_id (строка) - идентификатор iOS приложения | Требований нет Например: 1068913968 |
| android_url (строка) - диплинк для Android | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
| ios_url (строка) - диплинк для iOS | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
Пример каталога для недвижимости
<?xml version="1.0" encoding="UTF-8"?><realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06"> <generation-date>2010-12-11T12:00:00+04:00</generation-date> <offer internal-id="0"> <type>продажа</type> <property-type>жилая</property-type> <category>квартира</category> <location> <country>Россия</country> <region>Москва</region> <locality-name>Москва</locality-name> <address>Яузская улица, 27</address> <apartment>135</apartment> <metro> <name>Китай-город</name> </metro> <metro> <name>Таганская</name> </metro> <metro> <name>Марксистская</name> </metro> </location> <custom_label_0>Распродажа</custom_label_0> <custom_label_1>Скидки</custom_label_1> <custom_label_2>Последние квартиры</custom_label_2> <custom_label_3>Льготная ипотека</custom_label_3> <price> <value>4000000</value> <currency>RUR</currency> </price> <url>https://yandex.ru/moskva_i_moskovskaya_oblast/kupit/novostrojka/molzhaninovo-2890148/</url> <image>https://cdn-icons-png.flaticon.com/512/108/108732.png</image> <area> <value>56</value> <unit>кв. м</unit> </area> <rooms>2</rooms> <floor>12</floor> <floors>12</floors> <description>lorem ipsum dolor</description> <ios_url>yandex://items/1</ios_url> <ios_app_store_id>42</ios_app_store_id> <android_url>yandex://items/1</android_url> <bundle_id>com.yandex.mobile.realty</bundle_id> </offer></realty-feed>