I tuoi annunci in Trovit Italia

Feed Case

Nel caso in cui fossi in possesso di una pagina web con annunci immobiliari, puoi includere le tue offerte in Trovit. È molto semplice:

  1. Crea un file XML seguendo il formato specifico per il verticale immobiliare, più in basso.
  2. Inviaci la URL (Esempio: http://www.tuodominio.it/wp_feed.xml) attraverso il nostro formulario di contatto.

A partire da questo momento, leggeremo il feed periodicamente per poter inserire annunci nuovi, realizzare le modifiche pertinenti o eliminare quegli annunci che non sono più presenti nel tuo feed.

I tuoi annunci saranno introdotti nei risultati di ricerca di Trovit il prima possibile.

Se hai un qualsiasi dubbio, non esitare a metterti in contatto con noi.

Formato del feed XML

Queste sono le istruzioni per generare un feed XML con il fine di includere le tue offerte in Trovit. Se hai bisogno di maggiori informazioni sul formato XML ti consigliamo di consultare Wikipedia.

La codifica del feed deve essere in UTF-8.

Il file XML conterrà una etichetta principale <trovit> che raccoglierà un insieme di annunci rappresentati da blocchi di etichette <ad></ad>. Ogni blocco <ad></ad> contiene campi obbligatori e opzionali:

CAMPI OBBLIGATORI

I campi obbligatori sono l’insieme delle etichette XML che costituiscono le informazioni minime necessarie affinché i nostri sistemi includano i tuoi annunci in Trovit.

  • id: id dell’annuncio nella tua pagina web (può essere numerico o alfanumerico, però deve essere unico, dato che lo utilizziamo per evitare annunci duplicati)
  • url: l’URL dell’annuncio nella tua pagina web
  • title: il titolo dell’annuncio (deve essere interamente riferito all’annuncio, non può contenere né il nome né l’URL della tua web).
  • type: tipo di annuncio:
    • “For Rent”: Immobile in affitto (per un periodo significativamente lungo)
    • “For Sale”: Immobile in vendita
    • “Roommate”: Stanza in affitto
    • “Parking for Rent”: Parking in affitto
    • “Parking for Sale”: Parking in vendita
    • “Office For Rent”: Ufficio in affitto
    • “Office For Sale”: Ufficio in vendita
    • “Land For Sale”: Terreno
    • “Transfer Local”: Cambio di gestione
    • “For Rent Local”: Locale in affitto
    • “For Sale Local”: Locale in vendita
    • “Country House Rentals”: Casa di campagna in affitto
    • “Warehouse For Rent”: Capannone/Magazzino in affitto
    • “Warehouse For Sale”: Capannone/Magazzino in vendita
  • content: descrizione dell’annuncio (minimo 30 caratteri). Ricorda quanto è più ricca la descrizione, maggiore sarà la quantità di clicks che ti passeremo.

CAMPI OPZIONALI

I campi opzionali non devono essere aggiunti se non hanno contenuto. Se invece disponi di questi campi nella tua pagina web, non dubitare a introdurli nel feed. L’ algoritmo  di Trovit priorizza la qualità e quanto più completo è l’ annuncio, migliore sarà il tuo posizionamento!

    • mobile_url: URL dell’annuncio nella tua pagina web quando l’utente accede da un dispositivo mobile. Utile quando la tua pagina web è preparata per tali dispositivi.
    • price: prezzo dell’ annuncio. Di default il prezzo si considera mensile però si può indicare il periodo (monthly, daily o weekly), come attributo dentro questo tag.
      <price period="weekly"><![CDATA[...]]></price>

      Anche se a volte non è necessario applicarlo, guarda le specifiche tecniche per sapere che restrizioni e periodi ha ogni tipo di annuncio di default.

      Quando il prezzo è specificato in una moneta che non è quella ufficiale del paese, si dovrà utilizzare l’attributo “currency” i valori verranno determinati secondo la norma ISO-4217. In questo modo, Trovit potrà realizzare il cambio alla moneta ufficiale.
      La sintassi per un esempio concreto sarebbe la seguente:

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

      Questo specificherebbe il prezzo di un affitto settimanale, in dollari, in Italia. Non si deve includere il simbolo della moneta insieme al prezzo

    • property_type: tipo di proprietà come: appartamento, casa, monolocale, bilocale, etc. Il tag è opzionale e solo applicabile se l’annuncio ha un tag type “For sale” o “For rent”
    • address: indirizzo
    • floor_number: numero del piano
    • city_area: area o quartiere nella quale si trova la proprietà
    • city: città
    • region: nome della provincia
    • postcode: codice postale
    • latitude: latitudine dell’immobile. Vedi le specifiche tecniche per maggiori dettagli.
    • longitude: longitudine dell’immobile. Vedi le specifiche tecniche per maggiori dettagli.
    • orientation: orientazione della proprietà: nord, sud, est o ovest
    • agency: nome dell’agenzia che gestisce l’immobile/appartamento. Guardare il campo by_owner per avere maggiori informazioni.
    • mls_database: identificatore unico assegnato ad ogni bene immobiliare in una base di dati MLS (Multiple Listing Service)
    • floor_area: superficie della proprietà. Se non si specifica l’unità di misura si prenderà in considerazione la locale (metri in Italia). Per unità di misura differenti, specificarla come ‘unit’:
      <floor_area unit="feet"><![CDATA[...]]></floor_area>

      I valori delle varie unità possibili saranno: “meters”,”feet”,”acres”,”hectares”

    • plot_area: superficie del terreno nel quale si situa la proprietà. Se non si specifica l’unità di misura si prenderà in considerazione la locale (metri in Italia), lo potrete specificare come ‘unit’:
<plot_area unit="hectares"><![CDATA[...]]></plot_area>

I valori delle varie unità possibili saranno: “meters”,”feet”

  • rooms: numero di camere da letto presenti nell’ immobile.
  • bathrooms: numero di bagni
  • condition: Informazione testuale sullo stato del bene immobiliare ( per esempio: riformato recentemente).
  • year: anno di costruzione della casa in formato AAAA
  • virtual_tour: URLs al tour virtuale della proprietà
  • eco_score: Informazione di testo sull’efficienza energetica dell’immobile
  • pictures: Questo tag ingloba le distinte immagini dell’immobile.
    Il campo che definisce un’immagine in particolare è <picture>:

    • picture: Questo tag ingloba i campi per specificare la URL e il titolo dell’immagine (quest’ultimo è opzionale). Si può specificare se l’immagine è la più rilevante attraverso l’attributo ‘featured’.
              <picture featured="true"><![CDATA[...]]></picture>

      I valori di ‘featured’ disponibili sono: “true” o “false”.

      I campi da definire dentro l’elemento <picture> sono:

      • picture_url: URL dell’immagine.
      • picture_title: Titolo dell’immagine.
    <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>

    L’immagine mostrata in Trovit di un annuncio in particolare sarà la prima dell’insieme di immagini dell’annuncio, eccetto se una di queste è marcata come immagine rilevante
    Scegli l’immagine più adeguata visto che avrà una grande influenza sui clicks degli utenti.

    Trovit non permette l’inclusione di foto corporative con il messaggio “Immagine non disponibile”.
    Se si individuerà questo caso, Trovit si riserva il diritto di bloccare i tuoi annunci.

    Una volta che i tuoi annunci in Trovit sono stati inseriti, le immagini associate agli annunci non si potranno modificare, neanche nella seguente lettura del tuo feed.
    Assicurati che i nuovi annunci che aggiungi al tuo feed includano le immagini corrette. Le immagini devono avere una dimensione minima di 186X186 px e un peso massimo di 1MB.

  • date: data dell’annuncio. Il formato accettato è GG/MM/AAAA o GG/MM/AAAA OO:MM:SS e AAAA/MM/GG o AAAA/MM/GG OO:MM:SS.
  • expiration_date: Il formato accettato è GG/MM/AAAA o GG/MM/AAAA OO:MM:SS e AAAA/MM/GG o AAAA/MM/GG OO:MM:SS.

I seguenti campi devono essere compilati a seconda che siano veri o falsi. Guarda le specifiche tecniche per sapere che valori rappresentano “vero” e che valori rappresentano “falso”.

  • By_owner: ogni volta che una proprietà è messa in vendita da un privato. Se è falso la proprietà si intenderà gestita da una agenzia.
  • is_rent_to_own: Se è una proprietà in affitto con opzione di acquisto o no.
  • parking: Se il bene immobiliare ha un parking oppure no.
  • foreclosure: Se la proprietà è all’asta per pignoramento oppure no
  • is_furnished: Se la proprietà è ammobiliata o no
  • is_new: Se la proprietà è una nuova costruzione o no.

Il feed XML risulterà così:

<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>
    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <region><![CDATA[...]]></region>
    <postcode><![CDATA[...]]></postcode>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <agency><![CDATA[...]]></agency>

    <floor_area unit="feet"><![CDATA[...]]></floor_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <parking><![CDATA[...]]></parking>

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

</ad>

<ad>
    ....
</ad>

<ad>
    ....
</ad>

...

</trovit>

Esempio di feed XML

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
    <id><![CDATA[7004578]]></id>
    <url><![CDATA[http://www.latupaginaweb.it/ad/7004578]]></url>
    <title><![CDATA[Appartamento 2 stanze a Trastevere, Roma]]></title>
    <type><![CDATA[For rent]]></type>
    <content><![CDATA[Appartamento 2 stanze a Trastevere, Roma ]]></content>

    <price><![CDATA[800]]></price>
    <property_type><![CDATA[Appartamento]]></property_type>

    <address><![CDATA[Viale Trastevere]]></address>
    <city_area><![CDATA[Trastevere]]></city_area>
    <city><![CDATA[Roma]]></city>
    <region><![CDATA[Roma]]></region>
    <postcode><![CDATA[00118]]></postcode>
    <latitude><![CDATA[41.409583]]></latitude>
    <longitude><![CDATA[2.187223]]></longitude>
    <agency><![CDATA[Agenzia Inmobiliare]]></agency>

    <floor_area unit="meters"><![CDATA[100]]></floor_area>
    <rooms><![CDATA[2]]></rooms>
    <bathrooms><![CDATA[1]]></bathrooms>
    <parking><![CDATA[0]]></parking>

    <pictures>
        <picture>
            <picture_url><![CDATA[http://www.iltudominio.it/image.jpg]]></picture_url>
            <picture_title><![CDATA[salone]]></picture_title>
        </picture>
    </pictures>

<date><![CDATA[01/01/2011 18:30:34]]></date>
</ad>

<ad>
    <id><![CDATA[332A53BC2]]></id>
    <url><![CDATA[http://www.latupaginaweb.it/ad/332A53BC2]]></url>
    <title><![CDATA[Appartamento nuovo a Milano]]></title>
    <type><![CDATA[For sale]]></type>
    <content><![CDATA[Appartamento nuovo, terzo piano, centro storico]]></content>

    <price><![CDATA[209950]]></price>

    <address><![CDATA[]]></address>
    <city><![CDATA[Milano]]></city>
    <region><![CDATA[Milano]]></region>
    <postcode><![CDATA[]]></postcode>

    <pictures>
        <picture>
            <picture_url><![CDATA[http://www.iltudominio.it/image.jpg]]></picture_url>
            <picture_title><![CDATA[salone]]></picture_title>
        </picture>
    </pictures>

    <date><![CDATA[01/01/2010 17:30:25]]></date>
</ad>
</trovit>

Specifiche tecniche

Per maggiori informazioni, clicca qui: guarda le specifiche tecniche.

Privacy policy · Legal Notice · Terms and conditions · Cookie policy