Сервис «Импорт объявлений»
Руководство по составлению XML-фида для импорта объявлений на портал Est
http:///
20.05.2016
Общие сведения
Портал недвижимости Est! принимает объявления в xml файлах (xml фидах), основанных на формате YRL (Yandex Realty Language). Соответственно xml файл должен соответствовать определенным требованиям (с учетом некоторых нюансов, исключений и дополнений, который будут описаны ниже в данном документе):
Технические требования к фиду YRL:
https://yandex. ru/support/webmaster/realty/requirements. xml
Пример файла YRL:
https://yandex. ru/support/webmaster/realty/yrl-example. xml
Валидатор YRL фида:
https://webmaster. /xsdtest. xml
XML-файл допустимо предоставлять в заархивированном виде (zip, gzip).
Процедура импорта объявлений выполняется один раз в сутки в промежутке с 00:00 до 08:00, по результатам которой партнеру отсылается письмо с отчетом о возникших ошибках.
Отличия в заполнении некоторых элементов YRL фида
Перечень элементов, которые принимают ограниченный или расширенный список значений:
Элемент | Описание |
type | Тип сделки. Строго ограниченные значения: «продажа» «покупка» «сдача» «сдача посуточно» «аренда» |
property-type | Тип недвижимости. Строго ограниченные значения: «жилая» «коммерческая» |
category | Категория объекта. Строго ограниченные значения: «апартамент» «аптека» «база отдыха» «баня» «бильярдный клуб» «гараж» «гостиница» «дача» «дом» «заправка» «здание» «кафе» «квартира» «клиника» «комната» «магазин» «мед. кабинет» «нефтебаза» «общепит» «отель» «офис» «пансионат» «парикмахерская» «паркинг» «парковка» «паркоместо» «помещение свободного назначения» «производство и промышленность» «ресторан» «салон красоты» «санаторий» «сауна» «склад» «спортзал» «стоянка» «СТО» «таунхаус» «торговый центр» «участок для объектов отдыха и здоровья» «участок для сельского хозяйства» «участок для строительства жилья» «участок для строительства коммерческих объектов» «фитнес клуб» «хостел» |
description | Дополнительная информация (описание в свободной форме, оставленное подателем объявления). В отличие от базового YRL, допускается передача в HTML формате. |
currency | Валюта. Строго ограниченные значения: «UAH» |
renovation quality | Ремонт и/или состояние объекта. Строго ограниченные значения: «дизайнерский ремонт» «евроремонт» «косметический ремонт» «после реконструкции» «жилое/советское» «требуется косметический ремонт» «неоконченный ремонт» «под чистовую отделку» «требуется капитальный ремонт» «незавершённое строительство» «без ремонта» |
Информация о продавце или арендодателе
Информация о продавце или арендодателе (элемент <sales-agent>) является обязательной, но ее содержание при импорте игнорируется. Т. к. объявления после импорта на портал Est привязываются к определенному пользователю, то и контактные данные получают из профиля этого пользователя.
Дополнительные данные
Объявления на портале Est, могут содержать дополнительные данные, не предусмотренные форматом YRL. Такие данные необходимо передавать с помощью особых элементов <custom-param>. Они не входят в стандарт YRL, но тем не менее проходят валидацию XSD от Яндекса (https://webmaster. /xsdtest. xml).
Формат:
<custom-param>
<name>название параметра</name>
<value>значения параметра</value>
</custom-param>
На данный момент, можно передавать такие дополнительные данные.
Параметр | Описание |
est-login | Привязка объявления к пользователю (указывается логин пользователя на портале Est) |
est-hot | Признак горячего объявления (платная услуга). Стоимость размещения в сутки – 3.3 грн / 10 рублей |
est-headline | Заголовок рекламного текста |
est-near-residence | Что находится рядом. Строго ограниченные значения (если несколько, то указываются через запятую): «детсад» «школа» «супермаркет» «остановки» «развлекательные заведения» «спортивно-оздоровительный центр» «спорткомплекс» «гостиница» «парк» «речка/озеро» «море» «лес» |
est-type-of-flat | Тип квартиры. Строго ограниченные значения: «отдельная» «коммунальная» «малосемейка» «двухуровневая» «студия» «общежитие» |
est-amount-of-bathrooms | Количество санузлов (актуально для домов, таунхаусов и т. п.) |
est-amount-of-beds | Количество спальных мест (актуально для аренды) |
est-air-conditioning | Кондиционер (актуально для аренды) Строго ограниченные значения: «да» или «нет» «true» или «false» «1» или «0» «+» или «-» |
est-agent-contract-type | Форма поручения. Строго ограниченные значения: «устные договоренности» «устный эксклюзивный договор» «письменный договор» «письменный эксклюзивный договор» «письменный эксклюзивный договор (СПП)» |
est-fees-payer | Кто платит комиссию. Строго ограниченные значения: «продавец» «покупатель» «арендатор» «арендодатель» |
est-agent-contract-from | Срок действия договора (от). Формат: DD. MM. YYYY (день. месяц. год) Например, 02.02.2015 |
est-agent-contract-till | Срок действия договора (до). Формат: DD. MM. YYYY (день. месяц. год) Например, 31.12.2015 |
est-agent-contract-awards | Вознаграждение партнеру. Например: 5% 1000 USD 10000 UAH |
Пример, заполнения дополнительных данных:
...
<parking>да</parking>
<!-- указываем, что объявление надо сделать горячим (платно) -->
<custom-param>
<name>est-hot</name>
<value>да</value>
</custom-param>
<!-- указываем заголовок объявления -->
<custom-param>
<name>est-headline</name>
<value>Роскошный вид на ялтинскую бухту с террасы Вашего Светлого коттеджа. Сосновый бор.</value>
</custom-param>
<!-- указываем, что находится рядом -->
<custom-param>
<name>est-near-residence</name>
<value>детсад, школа, супермаркет, остановки, лес</value>
</custom-param>
<!-- указываем количество санузлов (в доме или таунхаусе) -->
<custom-param>
<name>est-amount-of-bathrooms</name>
<value>4</value>
</custom-param>
<!-- указываем, что есть кондиционер -->
<custom-param>
<name>est-air-condinioning</name>
<value>есть</value>
</custom-param>
<!-- указываем какой договор заключен между риелтором и клиентом -->
<custom-param>
<name>est-agent-contract-type</name>
<value>письменный эксклюзивный договор (СПП)</value>
</custom-param>
<!-- указываем срок договора (от) -->
<custom-param>
<name>est-agent-contract-from</name>
<value>18.08.2015</value>
</custom-param>
<!-- указываем срок договора (до) -->
<custom-param>
<name>est-agent-contract-till</name>
<value>31.12.2015</value>
</custom-param>
<!-- указываем размер, которым риелтор поделится с партнером в случае совместного проведения сделки (Система Партнерских Продаж СПП) -->
<custom-param>
<name>est-agent-contract-awards</name>
<value>2.5 %</value>
</custom-param>
<creation-date>2015-09-01T14:45:45+03:00</creation-date>
...
Достоверность объявлений
На импортированные объявлений распространяются те же правила, что и на объявления, добавляемые вручную. Это в том числе касается и требований для получения звезд достоверности. Подробнее о статусе и достоверности — http:///services/credibility/.
Если у вас возникли какие-то вопросы, предложения или пожелания, то обращайтесь к менеджеру портала Est.
| Андрей Терещенко Руководитель отдела продаж http://admins. / тел.: +380 67 319-00-33 тел.: +380 99 548-00-33 тел.: +380 93 723-00-33 email: *****@***ua skype: andrew. tereshchenko |
Основные порталы (построено редакторами)