Ваши объявления в 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”: Продажа жилой недвижимости;
  • content: Описание объявления (минимум 30 символов). Обратите внимание, что качество описания объявления имеет большое влияние на количество посетителей.

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

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

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

      • date: Дата публикации объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС and ГГГГ/MМ/ДД or ГГГГ/MМ/ДД ЧЧ:MM:СС.
      • expiration_date: Дата, на которую истекает срок действия объявления. Допустимый формат: ДД/ММ/ГГГГ или ДД/ММ/ГГГГ ЧЧ:MM:СС and ГГГГ/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[01125]]></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[61100]]></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 12:30:00]]></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