Tus anuncios en Trovit España

Feed Coches

Actualizado: Mar 1, 2013 @ 12:47

Si tienes una página web con anuncios publicados, ¡puedes incluir tus anuncios en Trovit!. Es muy sencillo:

Crea un archivo XML siguiendo el formato especificado más abajo.
Descarga nuestro Validador de XML y comprueba que el archivo está bien construido. Esta validación del XML es importante para que la indexación de tu contenido sea correcta.
Envía la URL donde se aloja (Ejemplo: http://www.tudominio.com/trovit_feed.xml) a través de nuestro formulario de contacto.

A partir de ese momento, leeremos el feed periódicamente para insertar anuncios nuevos, realizar las modificaciones pertinentes y caducar aquellos anuncios que ya no estén presentes en tu feed.

Tus anuncios serán introducidos en los resultados de búsqueda de Trovit lo antes posible.

Si tienes alguna consulta no dudes en ponerte en contacto con nosotros

Formato del feed XML

Estas son las instrucciones para generar un feed XML con el fin de incluir tus anuncios en Trovit. Si necesitas más información sobre el formato XML te aconsejamos que consultes Wikipedia.

La codificación del archivo debe ser en UTF-8

El archivo XML contendrá un etiqueta principal <trovit> que recogerá un conjunto de anuncios representado por bloques de etiquetas <ad></ad>. Cada bloque <ad></ad> contiene campos obligatorios y opcionales:

CAMPOS OBLIGATORIOS

Los campos obligatorios son el conjunto de etiquetas XML que proporcionan la cantidad mínima de información necesaria para que nuestros sistemas incluyan tus anuncios en Trovit.

id: Identificador del anuncio en tu página web (puede ser numérico o alfanumérico, pero debe ser único, ya que lo utilizamos para evitar anuncios duplicados)
url: URL del anuncio en tu página web.
title: Título del anuncio.
content: Descripción del anuncio (mínimo de 30 caracteres). Recuerda que cuanto más rica sea la descripción, ¡mayor será tu audiencia!.

CAMPOS OPCIONALES

Los campos opcionales no deben añadirse si no tienen contenido. Pero si dispones de estos campos en tu página web, no dudes en incluirlos en tu feed. El algoritmo de ordenación de Trovit prioriza la calidad, y cuanto más rico sea el anuncio, ¡mejor será tu posicionamiento!

mobile_url: URL del anuncio en tu página web cuando el usuario accede desde un dispositivo móvil. Útil cuando tu página web está preparada para dichos dispositivos.
price: Precio del coche.Cuando el precio esté especificado en una moneda que no es la divisa oficial del país, se deberá usar el atributo ‘currency’. Los valores vendrán determinados por la norma ISO-4217. De este modo, Trovit podrá realizar la conversión a la moneda oficial.
```
<price currency="USD"><![CDATA[...]]></price>
```
Esto especificaría el precio de un coche en dólares. No se debe incluir el símbolo de la moneda junto al precio. Ver especificaciones técnicas para más información.
car_type: Información textual sobre el tipo de coche (por ejemplo: berlina, 4×4, descapotable, sedán, monovolumen, furgoneta, familiar, etc.).
dealer: Concesionario donde se encuentra el coche.
neighborhood : Barrio donde se encuentra el coche.
city_area: Área de la ciudad donde se encuentra el coche.
city: Ciudad donde se encuentra el coche.
region: Nombre de la provincia donde se encuentra el coche.
postcode: Código postal.
vin_database: Número de identificador del coche. Identificador único.
make: Marca del coche.
model: Modelo del coche.
color: Color del coche.
year: Año de fabricación del coche. El formato aceptado es AAAA.
mileage: Kilometraje del coche. Si no se especifica la unidad de medidad se tomará kilómetros como unidad por defecto. Se puede especificar la unidad de medida con el atributo ‘unit’:
```
<mileage unit="kilometers"><![CDATA[...]]></mileage>
```
Los valores de ‘unit’ disponibles son: “kilometers” o “miles”.
doors: Número de puertas.
seats: Número de plazas.
transmission: Información textual sobre el tipo de cambio del coche (por ejemplo: manual, automático, secuencial, etc.).
gears: Número de marchas.
warranty: Información textual sobre si el coche aún tiene garantía o no, y en que condiciones.
engine_size: Cilindrada del coche. Si no se especifica la unidad de medida se tomará centímetros cúbicos como unidad por defecto. Se puede especificar la unidad de medida con el atributo ‘unit’:
```
<engine_size unit="cc"><![CDATA[...]]></engine_size>
```
Los valores de ‘unit’ disponibles son: “cc” o “liters”.
cylinders: Número de cilindros del coche.
fuel: Información textual sobre el combustible que usa el coche (por ejemplo: diésel, gasolina, etc.).
power: Potencia del coche. Si no se especifica la unidad de medida se tomarán CV como unidad por defecto. Se puede especificar la unidad de medida con el atributo ‘unit’:
```
<power unit="cv"><![CDATA[...]]></power>
```
Los valores de ‘unit’ disponibles son: “kw”, “cv”, “ch”, “km”, “hp”, “ps”, “pk”, “cp”.
fuel_consumption: Consumo combinado del coche. Si no se especifica la unidad de medida se tomarán l/100km como unidad por defecto. Se puede especificar la unidad de medida con el atributo ‘unit’:
```
<fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>
```
Los valores de ‘unit’ disponibles son: “l/100km”, “km/l”, “mpg”, “gal/mi”.
co2_emissions: Emisiones de CO2 del coche. Si no se especifica la unidad de medida se tomarán g/km como unidad por defecto. Se puede especificar la unidad de medida con el atributo ‘unit’:
```
<co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>
```
Los valores de ‘unit’ disponibles son: “g/km”, “g/mi”.
eco_score: Información textual acerca del ECO-score del coche.
pictures: Esta etiqueta engloba las distintas imágenes del vehículo.

El campo que define una imagen en particular es <picture>:
- picture: Esta etiqueta engloba los campos para especificar la URL y el título de la imagen (este último opcional). Se puede especificar si la imagen es la destacada con el atributo ‘featured’.
```
        <picture featured="true"><![CDATA[...]]></picture>
        
```
  Los valores de ‘featured’ disponibles son: “true” o “false”.
  
  Los campos a definir dentro del elemento <picture> son:
  - picture_url: URL de la imagen.
  - picture_title: Título de la imagen.
```
<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>
```
La imagen mostrada en Trovit de un anuncio en particular será la primera del conjunto de imágenes del anuncio.
Escoge la imagen más adecuada ya que ésta tiene una gran influencia sobre los clics del usuario.

Trovit no permite la inclusión de fotos corporativas con el mensaje “Imagen no disponible”.
Si se detectara este caso, Trovit se reserva el derecho de bloquear tus anuncios.

Una vez se inserten tus anuncios en Trovit, las imágenes asociadas a los anuncios no se podrán modificar ni tan siquiera en la siguiente lectura de tu feed.
Asegúrate que los nuevos anuncios que añadas a tu feed incluyen las imágenes correctas.
date: Fecha de publicación del anuncio. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.
expiration_date: Fecha en la que caducará el anuncio. Los formatos aceptados son DD/MM/AAAA o DD/MM/AAAA HH:MM:SS y AAAA/MM/DD o AAAA/MM/DD HH:MM:SS.

El siguiente campo deben rellenarse según si es cierto o falso. Ver especificaciones técnicas para saber que valores representan cierto y que valores falso.

is_new: Si el coche es nuevo o no.

El feed XML quedará así:

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

Ejemplo de feed XML

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

<ad>
    <id><![CDATA[7004578]]></id>
    <url><![CDATA[http://www.tudominio.com/ad/7004578]]></url>
    <title><![CDATA[Audi A3 en venta, casi nuevo]]></title>
    <content><![CDATA[[Audi A3 en venta, casi nuevo, lo vendo porque me mudo a otro país]]></content>

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

    <city_area><![CDATA[L'Hospitalet]]></city_area>
    <city><![CDATA[Barcelona]]></city>
    <region><![CDATA[Barcelona]]></region>
    <postcode><![CDATA[]]></postcode>

    <make><![CDATA[Audi]]></make>
    <model><![CDATA[A3]]></model>
    <color><![CDATA[Negro]]></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[diésel]]></fuel>
    <transmission><![CDATA[manual]]></transmission>
    <gears><![CDATA[5]]></gears>
    <power><![CDATA[75]]></power>

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

    <date><![CDATA[30/09/2006 18:30:00]]></date>
  </ad>
</trovit>

Especificaciones Técnicas

Para más información, haga click aquí: ver especificaciones técnicas.