Фиды для недвижимости поддерживаются в форматах XML и CSV/TSV. Примеры файлов представлены ниже.
Обязательные поля
| Название, тип и описание | Требования |
|---|---|
| id (строка) - уникальный ID объекта недвижимости | Максимальное число символов: 128 ID товара должен быть уникальным в рамках одного товарного фида ID товара может включать все символы латинского алфавита в верхнем и нижнем регистре, символы нижнего подчеркивания и дефис, а также цифры Например: 10000000179185 |
| title (строка) - название объекта недвижимости | Максимально число символов: 256 Текст не должен быть записан только заглавными / только строчными буквами Например: Жилой комплекс «Семейный» |
| location (строка) - месторасположение объекта недвижимости | |
address (строка) - адрес объекта недвижимости (улица) (вложен в location)
| Максимальное число символов: 256 Например: 3-я улица Строителей, 55 |
locality (строка) - населенный пункт, в котором расположен объект недвижимости (вложен в location)
| Максимальное число символов: 256 Например: Санкт-Петербург |
region (строка) - регион, в котором расположен объект недвижимости (вложен в location)
| Максимальное число символов: 256 Например: Санкт-Петербург |
country (строка) - страна, в которой расположен объект недвижимости (вложен в location)
| Максимальное число символов: 256 Например: Россия |
price (строка) - цена продажи или аренды объекта недвижимости
| Цена в виде числа с трехбуквенным кодом валюты согласно стандарту ISO 4217 через пробел В качестве десятичного разделителя необходимо использовать точку (.), а не запятую (,) Не указывайте валюту с помощью символов $, € или £ Значение поля должно быть более 0 Поддерживаемые коды валют:
Например: 1000000 RUB |
| image_link (строка) - URL основного изображения | Допустимые форматы файла изображения — JPEG, PNG, GIF, WEBP Рекомендуемый размер: 600px по большей стороне Минимальный размер: 300px по большей стороне Максимальный размер: 6000px по большей стороне Фон изображения должен быть однотонным, мы рекомендуем использовать белый цвет для фона На картинке должен быть изображен только сам продукт без дополнительных надписей, водяных знаков и логотипов Например: https://somesite.ru/item/10000000188131.jpeg При обновлении изображения обязательно измените ссылку на него, иначе изменения не будут распознаны. Изображение товара должно соответствовать требованиям Правил размещения рекламы. См. также Пояснения к Правилам размещения рекламы |
| link (строка) - URL страницы объекта недвижимости на сайте компании | Ссылки должны быть рабочими, начинаться с http:// или https:// и размещаться на домене сайта вашей компании Они должны вести на правильную страницу каждого объекта недвижимости Например: https://somesite.ru/item/10000000188131.html |
Необязательные поля
| Название, тип и описание | Требования |
|---|---|
| brand (строка) - название компании-застройщика | Максимальное число символов: 256 Например: СМУ-88 |
metro (строка) - ближайшая станция метро (вложен в location) | Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация. Например: Удельная |
name (строка) (вложено в metro) | Например: Удельная |
| sale_price (строка) - цена со скидкой или специальная цена | Требования к содержимому и форматированию аналогичны полю price Например: 10000000 RUB |
| min_price (строка) - Минимальная цена объекта недвижимости. При добавлении минимальной цены товара в баннер перед ценой указывается предлог «от». | Требования к содержимому поля и форматированию аналогичны полю price Например: 9500000 RUB |
| max_price (строка) - Максимальная цена объекта недвижимости. При добавлении максимальной цены товара в баннер перед ценой указывается предлог «до». | Требования к содержимому поля и форматированию аналогичны полю price Например: 11000000 RUB |
| description (строка) - Описание объекта недвижимости | Максимальное число символов: 256 Например: Уютный жилой комплекс в 15 минутах от центра города |
| num_rooms (float) - Общее количество комнат | Требований нет Например: 3 |
| floor (int) - этаж, на котором расположен объект недвижимости | Требований нет Например: 3 |
| floors_total (int) - всего этажей в здании, где расположен рекламируемый объект недвижимости | Требований нет Например: 15 |
| property_type (строка) - вид недвижимости | Допустимые значения:
Например: apartment |
custom_label (строка) - пользовательские поля с дополнительной информацией. Используются при создании групп продуктов Варианты: custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4
| Максимальное число символов: 256 Например: Летняя распродажа |
| listing_type (строка) - Тип объекта недвижимости | Допустимые значения:
Например: for_sale_by_owner |
| area_size (int) - площадь объекта недвижимости | Требований нет Например: 250 |
| area_unit (строка) - единица измерения площади объекта недвижимости | Допустимые значения:
Например: sq_m |
| year (строка) - Год постройки объекта недвижимости | Максимальное число символов: 256 Например: 2020 |
| availability (строка) - текущая доступность объекта недвижимости | Одно из значений:
Например: True |
Обязательные поля для мобильных приложений
| Название, тип и описание | Требования |
|---|---|
| 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 |
| android_app_link (строка) - идентификатор Android приложения | Требований нет Например: ru.sunlight.sunlight |
mobile_ios_app_store_id (строка) - идентификатор iOS приложения | Требований нет Например: 1068913968 |
| mobile_android_app_link (строка) - диплинк для Android | URL-схемы полей mobile_android_app_link и mobile_ios_app_link должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
| mobile_ios_app_link (строка) - диплинк для iOS | URL-схемы полей mobile_android_app_link и mobile_ios_app_link должны совпадать Диплинк должен корректно открываться (быть рабочим) Например:
|
Пример каталога для недвижимости — XML
<?xml version="1.0" encoding="UTF-8"?><channel> <title>example.com Feed</title> <link rel="self" href="http://www.example.com"/> <item> <id>12345678</id> <title>ЖК Изумрудный город</title> <brand>Унистрой</brand> <availability>true</availability> <description>Уютный жилой комплекс в 15 минутах от центра города</description> <location> <country>Россия</country> <region>Республика Татарстан</region> <locality>Казань</locality> <address>Рихарда Зорге 66Д </address> <metro> <name>Удельная</name> </metro> </location> <image_link>http://example.com/12345678-1.jpg</image_link> <num_rooms>2</num_rooms> <price>6000000 RUB</price> <link>http://www.example.com/link_to_listing</link> <year>2014</year> </item></channel>