Articles in this section

See more

Italia - Feed Case

Avatar
Thribee Help Center
  • Updated
Follow

Nel caso in cui fossi in possesso di una pagina web con annunci immobiliari, puoi includere le tue offerte in Trovit/Mitula/Nestoria/Nuroa. È 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/Mitula/Nestoria/Nuroa 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/Mitula/Nestoria/Nuroa. 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/Mitula/Nestoria/Nuroa.

  • 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/Mitula/Nestoria/Nuroa 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/Mitula/Nestoria/Nuroa 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 locali 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/Mitula/Nestoria/Nuroa 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/Mitula/Nestoria/Nuroa non permette l’inclusione di foto corporative con il messaggio “Immagine non disponibile”.
    Se si individuerà questo caso, Trovit/Mitula/Nestoria/Nuroa si riserva il diritto di bloccare i tuoi annunci.

    Una volta che i tuoi annunci in Trovit/Mitula/Nestoria/Nuroa 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.

Related articles

Comments

0 comments

Please sign in to leave a comment.