I tuoi annunci in Trovit Italia

Feed Auto

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

  1. Crea un archivio XML seguendo il formato specificato più in basso.
  2. Inviaci la URL (Esempio: http://www.tuodominio.it/wp_feed.xml) attraverso il nostro contatto. I tuoi annunci saranno introdotti nei risultati di ricerca di Trovit il prima possibile.

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

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

Se hai un qualsiasi interrogativo, non dubbitare in metterti in contatto on 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 codificazione dell’archivio deve essere in UTF-8.

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

CAMPI OBBLIGATORI

I campi obbligatori sono l’insieme dei tag XML che proporzionano la quantità minima di informazioni necessarie perchè il nostro sistema includa 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 utiliziamo 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).
  • content: descrizione dell’avviso (minimo 30 caratteri). Ricorda che quanto più ricca sarà la descrizione, maggiore sarà il numero dei potenziali clienti

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’auto. Se il prezzo è specificato in un’altra valuta 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 la conversione alla moneta ufficiale.
    <price currency="USD"><![CDATA[...]]></price>

    In questo modo specificheresti il prezzo di un auto in dollari. No se vuoi includere il símbolo della moneta insieme al prezzo. Guarda le specifiche técniche per maggiori informazioni.

  • car_type: che tipo di auto è: berlina, 4×4, decappottabile, etc
  • dealer: concesionario in cui si trova l’auto.
  • city_area: zona o quartiere in cui si trova l’auto (opzionale)
  • city: città
  • region: nome della provincia
  • postcode: codice postale
  • vin_database:numero di identificazione dell’ auto. Identificazione única.
  • make: marca dell’auto
  • model: modelo dell’auto
  • color: color dell’auto
  • year: anno di fabbricazione dell’auto. Il formato accettato è AAAA.
  • mileage: chilometraggio dell’auto. Se non si specificherà l’unità di misura si prenderanno i Chilometri per difetto. Si può indicare l’unità di misura con l’attributo “unit”:
    <mileage unit="kilometers"><![CDATA[...]]></mileage>

    I valori di ‘unit’ disponibili sono: “kilometers” o “miles”.

  • doors: numero di porte
  • seats: numero di posti
  • warranty: se l’auto è ancora in garanzia e in che condizioni
  • engine_size: Cilindrata dell’ auto. Se non si specificherà l’unità di misura si prenderanno i Centimerti Cubici per difetto. Si può indicare l’unità di misura con l’attributo “unit”:
    <engine_size unit="cc"><![CDATA[...]]></engine_size>

    I valori di ‘unit’ disponibili sono: “cc” o “liters”.

  • cylinders: Numero di cilindri dell’auto.
  • fuel: combustible dell’auto (per esempio diésel, super, etc)
  • transmission: tipo di cambio dell’auto (manuale/automatico)
  • gears: numero di marce
  • power: Potenza dell’ auto. Se non si specificherà l’unità di misura si prenderanno i CV come unità di default. Si può indicare l’unità di misura con l’attributo “unit”:
    <power unit="cv"><![CDATA[...]]></power>

    I valori di ‘unit’ disponibili sono: “kw”, “cv”, “ch”, “km”, “hp”, “ps”, “pk”, “cp”.

  • fuel_consumption: Consumo a ciclo combinato dell’auto. Se non si specifica l’unità di misura verrà assegnata di default l’unità l/100km. Si può specificare l’unità di misura con l’attributo ‘unit’:
    <fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>

    I valori di ‘unit’ disponibili sono: “l/100km”, “km/l”, “mpg”, “gal/mi”.

  • co2_emissions: Emissioni di CO2 dell’auto. Se non si specifica la misura, si verrà assegnata di default g/km. Si può specificare l’unità di misura con l’attributo ‘unit’:
    <co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>

    I valori di ‘unit’ disponibili sono: “g/km”, “g/mi”.

  • eco_score: Informazioni testuali in merito all’ECO-score dell’auto.
  • pictures: Questo tag racchiude le diverse immagini dell’ auto.
    Il campo che definisce un’ immagine in particolare è <picture>:

    • picture: Questa etichetta racchiude i campi per specificare la URL e il titolo dell’ immagine (quest’ultimo opzionale).
      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>
            <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.
    Scegli l’ immagine più adeguata visto che questa ha una grande influenza sui clicks degli utenti.

    Trovit non permette l’ inclusione di foto corporative con il messaggio “Immagine non disponiblie”.
    Se si verificasse ciò, Trovit si riserva il diritto di bloccare i tuoi annunci.

    Una volta inseriti i tuoi annunci in Trovit, le immagini associate agli annunci non si potranno modificare, neanche alla seguente lettura del feed.
    Assicurati che i nuovi annunci che aggiungi al tuo feed abbiano l’ immagine corretta. 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 y 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 y AAAA/MM/GG o AAAA/MM/GG OO:MM:SS.

I prossimi campi devono essere riempiti solo come veri o falsi. Vedi specifiche técniche per sapere che valori sono veri o falsi.

  • is_new: Se la macchina è nuova o no.

Il feed XML risulterà così:

<?xml version="1.0" encoding="utf-8"?>
<trovit>

<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <content><![CDATA[...]]></content>

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

    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <region><![CDATA[...]]></region>
    <postcode><![CDATA[...]]></postcode>

    <make><![CDATA[...]]></make>
    <model><![CDATA[...]]></model>
    <color><![CDATA[...]]></color>
    <year><![CDATA[...]]></year>
    <mileage><![CDATA[...]]></mileage>
    <doors><![CDATA[...]]></doors>
    <seats><![CDATA[...]]></seats>

    <engine_size><![CDATA[...]]></engine_size>
    <cylinders><![CDATA[...]]></>
    <fuel><![CDATA[...]]></fuel>
    <transmission><![CDATA[...]]></transmission>
    <gears><![CDATA[...]]></gears>
    <power><![CDATA[...]]></power>

    <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.iltudominio.com/ad/7004578]]></url>
    <title><![CDATA[Audi A3 in vendita, quasi nuova]]></title>
    <content><![CDATA[[Audi A3 in vendita, quasi nuova, la vendo perché mi trasferisco]]></content>

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

    <city_area><![CDATA[Trastevere]]></city_area>
    <city><![CDATA[Roma]]></city>
    <region><![CDATA[Roma]]></region>
    <postcode><![CDATA[]]></postcode>

    <make><![CDATA[Audi]]></make>
    <model><![CDATA[A3]]></model>
    <color><![CDATA[Nero]]></color>
    <year><![CDATA[2004]]></year>
    <mileage><![CDATA[5000]]></mileage>
    <doors><![CDATA[5]]></doors>
    <seats><![CDATA[5]]></seats>

    <engine_size><![CDATA[1781]]></engine_size>
    <cylinders><![CDATA[6]]></>
    <fuel><![CDATA[diesel]]></fuel>
    <transmission><![CDATA[manual]]></transmission>
    <gears><![CDATA[5]]></gears>
    <power><![CDATA[75]]></power>

    <pictures>
        <picture>
            <picture_url><![CDATA[http://www.iltudominio.com/image1.jpg]]></picture_url>
            <picture_title><![CDATA[front]]></picture_title>
        </picture>
        <picture>
            <picture_url><![CDATA[http://www.iltudominio.com./image2.jpg]]></picture_url>
            <picture_title><![CDATA[back]]></picture_title>
        </picture>
    </pictures>

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

 

Specifiche Tecniche

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

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