Ваши объявления в Trovit

XML файл Недвижимость

Если у вас есть сайт с объявлениями, вы можете включить ваши объявления в результаты поиска Trovit! Это очень просто:

    1. Создайте XML файл в специальном формате, указанном ниже.
    2. Используйте нашу контактную форму для отправки URL (Например: http://www.ваше-доменное-имя.com/wp_feed.xml), на ваш XML файл.

С этого времени, мы будем периодически читать ваш XML файл, чтобы добавлять новые объявления, вносить необходимые изменения и удалять объявления, с истекшим сроком действия, которые больше не присутствуют в вашем XML файле.

Ваши объявления будут включены в результаты поиска Trovit как можно раньше.

Если у вас есть вопросы или замечания, пожалуйста, свяжитесь с нами!

Формат XML файла

Вот несколько простых инструкций для подготовки XML файла, для того, чтобы включить ваши объявления в результаты поиска Trovit. Если вам необходима дополнительная информация о формате XML, рекомендуем обратиться к Wikipedia.

Кодировка файла должна быть UTF-8.

XML файл будет содержать один главный тег ‘trovit’ , который будет содержать множество объявлений, представленных блоками тегов ‘ad’. Каждый блок ‘ad’ содержит обязательные и необязательные поля:

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

Обязательные поля – это набор тегов XML, которые обеспечивают минимальное количество информации, необходимой для нашей системы, чтобы включить ваши объявления в результаты поиска Trovit.

  • id: Идентификационный номер объявления на вашем сайте (цифровой или буквенно-цифровой, он должен быть уникальным, поскольку мы используем его, чтобы избежать дублирования записей).
  • url: Адрес объявления на вашем сайте.
  • title: Название объявления.
  • type: Тип объявления. Содержание этого поля должно быть одним из следующих:
    • “For Rent”: Долгосрочная аренда жилой недвижимости (квартиры, комнаты, дома, дачи, коттеджи и т.д.);
    • “For Sale”: Продажа жилой недвижимости (квартиры, комнаты, дома, дачи, коттеджи и т.д.);
    • “Office For Rent”: Аренда офисов (скоро открытие);
    • “Office For Sale”: Продажа офисов (скоро открытие);
    • “Land For Sale”: Продажа земельных участков (скоро открытие);
    • “For Rent Local”: Аренда помещений (скоро открытие);
    • For Sale Local”: Продажа помещений (скоро открытие).
  • content: Описание объявления (минимум 30 символов). Обратите внимание, что качество описания объявления имеет большое влияние на количество посетителей.
  • date: Дата публикации объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС и ГГГГ/MМ/ДД or ГГГГ/MМ/ДД ЧЧ:MM:СС.

ДОПОЛНИТЕЛЬНЫЕ ПОЛЯ

Дополнительные поля не являются обязательными для заполнения. Но если эти поля присутствуют в объявлениях на вашем сайте, вы можете включить их в свой XML файл. Алгоритм сортировки Trovit ставит в приоритет качество объявления, поэтому, чем больше дополнительной информации включено в ваше объявление, тем выше ваша позиция!

  • mobile_url: URL объявления на вашем сайте, когда пользователь просматривает на мобильном устройстве. Полезно, если ваш сайт имеет мобильную версию.
  • price: Цена объекта недвижимости. Вы можете указать период (monthly, weekly) в качестве атрибута в этом таге:
    <price period="monthly"><![CDATA[...]]></price>
    <price period="weekly"><![CDATA[...]]></price>

    См. технические характеристики, чтобы узнать какие ограничения по умолчанию существуют для каждого типа объявлений.

    Если цена указана в валюте, которая не является официальной валютой страны, необходимо использовать атрибут ‘currency’. Вид валюты определяется по стандарту ISO-4217. Таким образом, Trovit будет осуществлять конвертацию в официальную валюту страны.

    Период по умолчанию ежемесячный, но также можно установить еженедельный. Синтаксис будет следующим:

    <price period="weekly" currency="USD"><![CDATA[...]]></price>

    В данном примере цена указана в неделю, в долларах. Символ валюты не должен находиться рядом с ценой.

  • property_type: Вид объекта недвижимости (например: квартира, дом, студия, пентхаус и т. д.). Применяется только в том случае, если тип объявления «For rent» или «For sale».
  • address: Адрес, по которому находиться объект недвижимости.
  • floor_number: Этаж, на котором находится объект недвижимости.
  • neighborhood: Район, в котором находится объект недвижимости.
  • city_area: Часть города (округ/окрестность), в которой находится объект недвижимости.
  • city: Город, в котором находится объект недвижимости.
  • postcode: Почтовый индекс.
  • region: Название области/Республики/края, в котором находится объект недвижимости.
  • latitude: Широта, на которой находится объект недвижимости. См. технические характеристики для более подробной информации.
  • longitude: Долгота, на которой находится объект недвижимости. См. технические характеристики для более подробной информации.
  • orientation: Информация об ориентации объекта недвижимости (север, юг, восток, запад и т. д.).
  • agency: Название агенства. См. поле by_owner для дополнительной информации.
  • floor_area: Площадь объекта недвижимости. Если единица измерения не указана, единицей измерения по умолчанию является квадратный метр. Вы можете указать единицу измерения при помощи атрибута ‘unit’:
    <floor_area unit="feet"><![CDATA[...]]></floor_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>

    Доступными значениями ‘unit’ являются: “meters” или “feet”.

  • plot_area: Площадь земельного участка, на котором находится объект недвижимости. Если единица измерения не указана, берется местная единица измерения по умолчанию. Вы можете указать единицу измерения при помощи атрибута ‘unit’:
    <plot_area unit="feet"><![CDATA[...]]></plot_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>

    Доступными значениями ‘unit’ являются: “meters”, “feet”, “acres” или “hectares”.

  • rooms: Количество комнат объекта недвижимости.
  • bathrooms: Количество ванных комнат объекта недвижимости.
  • condition: Информация о состоянии объекта недвижимости (например: недавно отремонтирован).
  • year: Год постройки объекта недвижимости. Допустимый формат: ГГГГ.
  • virtual_tour: URL на виртуальный тур по объекту недвижимости.
  • eco_score: Информация, в свободной форме, об энергоэффективности недвижимости.
  • pictures: Этот тег включает различные изображения объекта недвижимости.
    Полем, которое определяет особенности конкретного изображения является <picture>:

    • picture: Этот тег включает в себя поля, предназначеные для того, чтобы указывать URL и название изображения (опционально). С помощью атрибута ‘featured’, есть возможность указать будет ли это изображение показываться:
              <picture featured="true"><![CDATA[...]]></picture>

      Возможные значения атрибута ‘featured’: “true” или “false”.

      Поля, содержащиеся внутри тега <picture> :

        • picture_url: URL изображения.
        • picture_title: Название изображения.
      <pictures>
          <picture>
              <picture_url><![CDATA[...]]></picture_url>
              <picture_title><![CDATA[...]]>/picture_title>
          </picture> 
      
          <picture featured="true">
              <picture_url><![CDATA[...]]></picture_url>
              <picture_title><![CDATA[...]]>/picture_title>
          </picture>
              ...
      </pictures>

      Изображение/фотография, которое будет показываться для объявления в Trovit, будет являться первым изображением/фотографией из всех изображений/фотографий, которые содержит объявление. Выберите наиболее подходящее изображение/фотографию, поскольку оно имеет большое влияние на количество кликов пользователей.

      Trovit не позволяет использование корпоративных изображений/фотографий с надписями типа «доступных изображений нет». Если подобные изображения/фотографии будут обнаружены, Trovit оставляет за собой право заблокировать ваши объявления.

      После того как ваши объявления будут добавлены в результаты поиска Trovit, изображения, связанные с объявлениями станут недоступными для изменения. Убедитесь, что новые объявления, которые вы добавляете в свой XML файл содержат правильные изображения/фотографии.

  • expiration_date: Дата, на которую истекает срок действия объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС и ГГГГ/MМ/ДД or ГГГГ/MМ/ДД ЧЧ:MM:СС.
    Следующие поля должны быть заполнены в соответствии с тем, являются ли они «истинными» или «ложными». См. технические характеристики, чтобы узнать, какие значения представляют «истину» и какие «ложь».
  • by_owner: Предлагается ли объект недвижимости собственником. В случае отрицательного значения будет понятно, что объект предлагается агенством.
  • parking: Располагает ли объект недвижимости паркингом/гаражом.
  • is_rent_to_own: Сдается ли недвижимость в аренду с правом выкупа.
  • is_furnished: Меблирован ли объект недвижимости или нет.
  • is_new: Является ли объект недвижимости новостройкой.

XML файл будет иметь следующий вид:

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>
    <content><![CDATA[...]]></content>
    <price><![CDATA[...]]></price>
    <property_type><![CDATA[...]]></property_type>
    <address><![CDATA[...]]></address>
    <floor_number><![CDATA[...]]></floor_number>
    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <postcode><![CDATA[...]]></postcode>
    <region><![CDATA[...]]></region>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <orientation><![CDATA[...]]></orientation>
    <agency><![CDATA[...]]></agency>
    <floor_area><![CDATA[...]]></floor_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <condition><![CDATA[...]]></condition>
    <year><![CDATA[...]]></year>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <date><![CDATA[...]]></date>
    <by_owner><![CDATA[...]]></by_owner>
    <parking><![CDATA[...]]></parking>
    <foreclosure><![CDATA[...]]></foreclosure>
    <is_furnished><![CDATA[...]]></is_furnished>
    <is_new><![CDATA[...]]></is_new>

    <pictures>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        ...
    </pictures>

</ad>

<ad>
    ....
</ad>

...

</trovit>

Пример XML файла

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.ваше-доменное-имя.com/ad/7004578]]></url>
	<title><![CDATA[2-комнатная квартира в Санкт-Петербурге]]></title>
	<type><![CDATA[For rent]]></type>
	<content><![CDATA[Уютная квартира с хорошим ремонтом в отличном районе, рядом с метро.]]></content>
        <price><![CDATA[24500]]></price>
	<property_type><![CDATA[Квартира]]></property_type>
	<address><![CDATA[Московский просп, д. 206]]></address>
	<floor_number><![CDATA[2]]></floor_number>
	<city_area><![CDATA[Московский район]]></city_area>
	<city><![CDATA[Санкт-Петербург]]></city>
	<postcode><![CDATA[196066]]></postcode>
	<region><![CDATA[Санкт-Петербург]]></region>
	<agency><![CDATA[Недвижимость Санкт-Петербурга]]></agency>
	<floor_area><![CDATA[40]]></floor_area>
	<rooms><![CDATA[2]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<condition><![CDATA[]]></condition>
	<year><![CDATA[2000]]></year>
	<virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[31/05/2011 18:30:00]]></date>
        <by_owner><![CDATA[1]]></by_owner>
	<parking><![CDATA[1]]></parking>
	<is_furnished><![CDATA[0]]></is_furnished>
	<is_new><![CDATA[0]]></is_new>

        <pictures>
		<picture>
			<picture_url><![CDATA[http://www.ваше-доменное-имя.com/image.jpg]]></picture_url>
			<picture_title><![CDATA[кухня]]></picture_title>
		</picture>
	</pictures>

</ad>

<ad>
	<id><![CDATA[332A53BC2]]></id>
	<url><![CDATA[http://www.ваше-доменное-имя.com/ad/332A53BC2]]></url>
	<title><![CDATA[3-к квартира м. Пр-т Вернадского Ленинский  дом 92 корп. 1]]></title>
	<type><![CDATA[For sale]]></type>
	<content><![CDATA[3-комнатная квартира на 6-м этаже 30-и этажного дома. С/у - раздельный, без балкона]]></content>
	<price><![CDATA[30000000]]></price>
	<property_type><![CDATA[Квартира]]></property_type>
	<address><![CDATA[Ленинский пр. 92]]></address>
	<floor_number><![CDATA[6]]></floor_number>
	<city_area><![CDATA[Западный административный округ]]></city_area>
	<city><![CDATA[Москва]]></city>
	<postcode><![CDATA[119415]]></postcode>
	<region><![CDATA[Москва]]></region>
	<agency><![CDATA[]]></agency>
	<floor_area><![CDATA[137]]></floor_area>
	<plot_area><![CDATA[]]></plot_area>
	<rooms><![CDATA[3]]></rooms>
	<bathrooms><![CDATA[1]]></bathrooms>
	<condition><![CDATA[]]></condition>
	<year><![CDATA[2005]]></year>
	<virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[15/06/2011]]></date>
        <by_owner><![CDATA[1]]></by_owner>
	<parking><![CDATA[0]]></parking>
	<is_furnished><![CDATA[]]></is_furnished>
	<is_new><![CDATA[]]></is_new>

	<pictures>
		<picture>
			<picture_url><![CDATA[http://www.ваше-доменное-имя.com/image.jpg]]></picture_url>
			<picture_title><![CDATA[гостиная]]></picture_title>
		</picture>
	</pictures>

</ad>
</trovit>
Privacy policy · Legal Notice · Terms and conditions · Cookie policy