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