Обязательные поля в фидах данных для недвижимости
| Название, тип и описание | Требования |
|---|---|
| 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 по большей стороне Рекомендуемое соотношение сторон изображений — квадратное (1:1). Иначе к изображениям будет применён автоматический ресайз на стороне площадки Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: 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 должны совпадать Диплинк должен корректно открываться (быть рабочим) Например: ozon://products/105207/ |
| ios_url (строка) - диплинк для iOS | URL-схемы полей android_url и ios_url должны совпадать Диплинк должен корректно открываться (быть рабочим) Например: ozon://products/105207/ |
Пример каталога для недвижимости
<?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>