România - Feed Imobiliare

Dacă deții un website dedicat anunțurilor publicitare, poți include anunțurile tale în Trovit, Mitula!
Urmează acești pași simpli:

1. Pregătește un feed UTF-8 XML în formatul specificat pentru verticala Imobiliare (vezi mai jos)
2. Trimite link-ul URL unde putem citi feed-ul XML la Contactează (Exemplu: http://www.domeniultau.com/wp_feed.xml)

După primirea feed-ului tău, vom indexa anunțurile tale în Trovit, Mitula în cel mai scurt timp.
Dacă ai întrebări sau nelămuriri, te rugăm să ne contactezi!

FORMAT FEED XML

Iată câteva recomandări simple pentru pregătirea unui feed XML. Poți folosi Specificațiile Tehnice pentru a vedea restricțiile pentru fiecare etichetă. Dacă dorești informații suplimentare despre formatul XML, citește aici.

*Feed-ul ar trebui să fie scris în UTF-8. Fișierul are o singură etichetă ‘trovit’, și unul sau mai multe elemente ‘anunț’. Fiecare element ‘anunț’ include următoarele câmpuri:

CÂMPURI OBLIGATORII

Câmpurile următoare sunt obligatorii în feed pentru că includ informațiile de bază necesare pentru ca sistemul nostru să includă anunțurile tale în Trovit, Mitula.

• id: id-ul anunțului tău pe website-ul nostru (numeric sau alphanumeric, trebuie să fie unic pentru că îl folosim pentru a evita postările duplicate)
• url: URL-ul anunțului pe website-ul tău
• title: titlul anunțului (un rezumat scurt al anunțului ce nu include denumirea sau URL-ul website-ului tău).
• type: selectează tipul imobilului per anunț:
  • “for rent”: imobil de închiriat
  • “for sale”: imobil de vânzare
• content: descrierea imobilului (minim 30 de caractere). Te rugăm să ții cont de faptul că numărul vizitatorilor primiți este influențat semnificativ de calitatea descrierii tale!

CÂMPURI OPȚIONALE

Câmpurile opționale nu sunt strict necesare feed-ului. Cu toate acestea, dacă deții mai multe informații referitoare la anunț, este indicat să le incluzi în feed! Algoritmul Trovit, Mitula prioritizează anunțurile de calitate. Prin urmare, introducerea unui număr mare de detalii în anunț îți va optimiza poziția în motorul nostru de căutare!

• mobile_url: URL-ul anunțului pe website-ul tău în momentul în care un utilizator efectuează căutarea de pe un dispozitiv mobil. Este folositor atunci când website-ul tău are o versiune pentru mobil.
• price: prețul imobilului. Termenul de plată predefinit este lunar, dar poți indica alți termeni de plată (săptămânal sau zilnic) prin aplicarea unei sintaxe corespunzătoare:

  <price period="săptămânal"><![CDATA[...]]></price>
  <price period="zilnic"><![CDATA[...]]></price>

  Te rugăm să nu incluzi simboluri precum $ sau €. Dacă prețul este specificat într-o altă monedă decât moneda oficială (EUR/€), te rugăm să aplici sintaxa corespunzătoare în interiorul etichetei ‘price’ folosind ISO-4217. În acest mod, Trovit, Mitula va putea converti prețul la moneda oficială (EUR/€).

  <price period="săptămânal" currency="CAD"><![CDATA[...]]></price>

  În acest exemplu, prețul săptămânal este exprimat în dolari canadieni.

• property_type: apartament, casă, garsonieră, vilă. (se aplică doar dacă ai completat câmpurile “închiriere” sau “vânzare” în câmpul “tip”) Te rugăm să vezi Specificațiile Tehnice pentru mai multe detalii.
• foreclosure: specifică dacă imobilul este sau nu sub executare silită; (format: 0 = Nu, 1 = Da)
• foreclosure_type: stadiul curent al imobilului; selectează unul dintre textele următoare:
  • “Pre foreclosure”
  • “Auction”
  • “Bank owned”
• address: denumirea străzii
• floor_number: numărul etajului/nivelurilor
• city_area: zona sau cartierul unde este situat imobilul
• city: denumirea orașului
• postcode: codul poștal
• region: județ (sunt permise abrevieri)
• latitude: latitudinea imobilului [-90.0, 90.0]
• longitude: longitudinea imobilului [-180.0,180.0]
• orientation: orientarea imobilului: nord, sud, est sau vest
• agency: denumirea agenției imobiliare care publică anunțul
• floor_area: suprafața imobilului (valoare întreagă)
• plot_area: suprafața lotului / suprafața terenului pe care este situat imobilul; selectează una dintre următoarele variante:

  <plot_area unit="m²"><![CDATA[...]]></plot_area>
  <plot_area unit="ha"><![CDATA[...]]></plot_area>

• rooms: numărul dormitoarelor
• bathrooms: numărul băilor, valorile decimale sunt permise (ex. 2.5)
• condition: condiția în care se află imobilul ex: “renovat” sau “apartament second hand”
• year: anul în care a fost construit imobilul: AAAA
• virtual_tour: URL către turul virtual al imobilului
• eco_score: informații, în format free-text, despre eficiența energetică a imobilului
• pictures: Această etichetă include imagini reprezentative ale imobilului.
  Câmpul care definește o imagine specifică a imobilului este <picture>:
  • picture: Această etichetă include câmpurile care specifică URL-ul și titlul imaginii (titlul este opțional). Poți specifica dacă imaginea este cea featured prin intermediul atributului ‘featured’.

            <picture featured="true"><![CDATA[...]]></picture>

    Valorile disponibile pentru ‘featured’ sunt: “adevărat” sau “fals”.

    Câmpurile de definit în interiorul elementului <picture> sunt:

    • picture_url: URL imagine
    • picture_title: Titlu imagine

  <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>

  Imaginea prezentată pe Trovit, Mitula pentru un anume anunț va fi prima din setul de imagini al anunțului, cu excepția situației în care una dintre ele este marcată drept ‘featured’.
  Alege cu grijă imaginea anunțului pentru că aceasta influențează semnificativ click-urile utilizatorilor.

  Trovit, Mitula nu permite imagini ce includ mesajul “Imagine nedisponibilă”.
  Dacă vom detecta prezența acestui tip de imagini, ne rezervăm dreptul de a-ți bloca anunțurile.

  Odată ce anunțurile tale au fost indexate în Trovit, Mitula,  imaginile asociate anunțului nu mai pot fi modificate, inclusiv imaginea din feed.
  Te rugăm să te asiguri că anunțurile noi pe care le vei include în feed-ul tău sunt însoțite de imagini corecte.
  Imaginile trebuie să fie cel puțin 186x186px și să aibă maxim 1MB.

• date: data și ora când a fost publicat anunțul. Formate valide: ZZ/LL/AAAA sau ZZ/LL/AAAA HH:MM:SS și AAAA/LL/ZZ sau AAAA/LL/ZZ HH:MM:SS.
• expiration_date: data când va expira anunțul. Formate valide: ZZ/LL/AAAA sau ZZ/LL/AAAA HH:MM:SS și AAAA/LL/ZZ sau AAAA/LL/ZZ HH:MM:SS.
• by_owner: dacă imobilul este sau nu pus la Vânzare Direct De Proprietar (format: 0 = Nu, 1 = Da.) Nu este necesar să completezi acest câmp dacă imobilul este promovat de un Agent Imobiliar.
• is_rent_to_own: dacă imobilul este închiriat sau nu cu posibilitatea cumpărării ulterioare.
• parking: dacă imobilul are sau nu loc de parcare. (format: 0 = Nu, 1 = Da)
• is_furnished: dacă imobilul este sau nu mobilat (format: 0 = Nu, 1 = Da)
• is_new: dacă imobilul este sau nu nou (format: 0 = Nu, 1 = Da)
  

  FORMAT UTF-8 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>
      <foreclosure><![CDATA[...]]></foreclosure>
      <foreclosure_type><![CDATA[...]]></foreclosure_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>
  
      <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>
  
      <date><![CDATA[...]]></date>
      <expiration_date><![CDATA[...]]></expiration_date>
      <by_owner><![CDATA[...]]></by_owner>
      <parking><![CDATA[...]]></parking>
      <is_furnished><![CDATA[...]]></is_furnished>
      <is_new><![CDATA[...]]></is_new>
  
  </ad>
  
  <ad>
      ....
  </ad>
  
  ...
  
  </trovit>

   

  EXEMPLUL UNUI FEED XML

   

  <?xml version="1.0" encoding="utf-8"?>
  <trovit>
  <ad>
  	<id><![CDATA[7004578]]></id>
  	<url><![CDATA[http://www.domeniultau.com/anunt/7004578]]></url>
  	<title><![CDATA[4 cam, 2 băi Casă - District Karu, Abuja]]></title>
  	<type><![CDATA[De închiriat]]></type>
  	<content><![CDATA[Apartament spațios cu 4 camere, bucătărie mare, și intrare secundară cu terasă.]]></content>
  
          <price><![CDATA[1195]]></price>
  	<property_type><![CDATA[Casă]]></property_type>
  	<foreclosure><![CDATA[]]></foreclosure>
  	<foreclosure_type><![CDATA[]]></foreclosure_type>
  
  	<address><![CDATA[332 E. Jefferson]]]></address>
  	<floor_number><![CDATA[2]]></floor_number>
  	<city_area><![CDATA[District Karu]]></city_area>
  	<city><![CDATA[Abuja]]></city>
  	<postcode><![CDATA[900110]]></postcode>
  	<region><![CDATA[Teritoriul Capitalei Federale Abuja]]></region>
  
  	<latitude><![CDATA[42.276230]]></latitude>
  	<longitude><![CDATA[-83.7455700]]></longitude>
  	<orientation><![CDATA[]]></orientation>
  	<agency><![CDATA[Stanward Properties]]></agency>
  
  	<floor_area><![CDATA[2000]]></floor_area>
  	<plot_area unit="acres"><![CDATA[1]]></plot_area>
  
  	<rooms><![CDATA[4]]></rooms>
  	<bathrooms><![CDATA[2]]></bathrooms>
  	<condition><![CDATA[]]></condition>
  	<year><![CDATA[2006]]></year>
  	<virtual_tour><![CDATA[]]></virtual_tour>
  
          <pictures>
  		<picture>
  			<picture_url><![CDATA[http://www.domeniultau.com/image.jpg]]></picture_url>
  			<picture_title><![CDATA[living room]]></picture_title>
  		</picture>
  	</pictures>
  
  	<date><![CDATA[31/2/2011 17:30]]></date>
          <expiration_date><![CDATA[1/6/2012]]></expiration_date>
          <by_owner><![CDATA[1]]></by_owner>
  	<parking><![CDATA[1]]></parking>
  	<is_furnished><![CDATA[0]]></is_furnished>
  	<is_new><![CDATA[0]]></is_new>
  </ad>
  
  <ad>
  	<id><![CDATA[332A53BC2]]></id>
  	<url><![CDATA[http://www.domeniultau.com/anunț/332A53BC2]]></url>
  	<title><![CDATA[ 1 cam, 1 baie Apartament - Abuja]]></title>
  	<type><![CDATA[De vânzare]]></type>
  	<content><![CDATA[Grădină 1 dormitor etaj 1 Living room intim ce se bucură de lumină naturală. Baie principală proaspăt renovată.]]></content>
  
  	<price><![CDATA[209950]]></price>
  	<property_type><![CDATA[Apartament]]></property_type>
  	<foreclosure><![CDATA[]]></foreclosure>
  	<foreclosure_type><![CDATA[]]></foreclosure_type>
  
  	<address><![CDATA[711 E. Kinsley Unit 1]]></address>
  	<floor_number><![CDATA[]]></floor_number>
  	<city_area><![CDATA[District Karu]]></city_area>
  	<city><![CDATA[Abuja]]></city>
  	<postcode><![CDATA[900110]]></postcode>
  	<region><![CDATA[Teritoriul Capitalei Federale Abuja]]></region>
  
  	<latitude><![CDATA[42.276230]]></latitude>
  	<longitude><![CDATA[-83.7455700]]></longitude>
  	<orientation><![CDATA[vest]]></orientation>
  	<agency><![CDATA[]]></agency>
  
  	<floor_area><![CDATA[1100]]></floor_area>
  	<plot_area unit="feet"><![CDATA[]]></plot_area>
  	<rooms><![CDATA[1]]></rooms>
  	<bathrooms><![CDATA[1]]></bathrooms>
  	<condition><![CDATA[]]></condition>
  	<year><![CDATA[1998]]></year>
  	<virtual_tour><![CDATA[]]></virtual_tour>
  
  	<pictures>
  		<picture>
  			<picture_url><![CDATA[http://www.domeniultau.com/image.jpg]]></picture_url>
  			<picture_title><![CDATA[living room]]></picture_title>
  		</picture>
  	</pictures>
  
  	<date><![CDATA[31/06/2011 09:30]]></date>
          <expiration_date><![CDATA[31/12/2012]]></expiration_date>
          <by_owner><![CDATA[1]]></by_owner>
  	<parking><![CDATA[0]]></parking>
  	<is_furnished><![CDATA[]]></is_furnished>
  	<is_new><![CDATA[]]></is_new>
  </ad>
  </trovit>

SPECIFICAȚII TEHNICE

Pentru mai multe detalii, vezi: specificații tehnice