Costa Rica - Feed Autos – Thribee

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

Crea un archivo XML siguiendo el formato especificado más abajo.
Envía la URL donde se aloja (Ejemplo: http://www.tudominio.com/wp_feed.xml) a través de nuestro formulario de contacto.

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

Tus avisos 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 avisos 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 avisos 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 avisos en Trovit.

id: Identificador del aviso en tu página web (puede ser numérico o alfanumérico, pero debe ser único, ya que lo utilizamos para evitar avisos duplicados)
url: URL del aviso en tu página web.
title: Título del aviso (debe ser completamente relacionado con el aviso, no puede contener ni el nombre ni la URL de tu web).
content: Descripción del aviso (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 aviso, ¡mejor será tu posicionamiento!

mobile_url: URL del aviso 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 auto en Peso Argentino
Cuando el precio esté especificado en una moneda que no es la divisa oficial del país, se deberá usar el atributo currency. 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 auto en dólares. No se debe incluir el símbolo de la moneda junto al precio.
car_type: Información textual sobre el tipo de auto (por ejemplo: berlina, 4×4, descapotable, sedán, monovolumen, furgoneta, familiar, etc.).
dealer: Concesionario donde se encuentra el auto.
neighborhood: Barrio donde se encuentra el auto.
city_area: Área de la ciudad donde se encuentra el auto.
city: Ciudad donde se encuentra el auto.
region: Nombre de la región / provincia donde se encuentra el auto.
postcode: Código postal.
vin_database: Número de identificador del auto. Identificador único.
make: Marca del auto.
model: Modelo del auto.
color: Color del auto.
year: Año de fabricación del auto. El formato aceptado es AAAA.
mileage: Kilometraje del auto. 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.
warranty: Información textual sobre si el auto aún tiene garantía o no, y en que condiciones.
engine_size: Cilindrada del auto. 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 auto.
fuel: Información textual sobre el combustible que usa el auto (por ejemplo: diésel, gasolina, etc.).
transmission: Información textual sobre el tipo de cambio del auto (por ejemplo: manual, automático, secuencial, etc.).
gears: Número de marchas.
power: Potencia del auto. Si no se especifica la unidad de medidad se tomarán CV como unidad por defecto. Se puede especificar la unidad de medidad 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 auto. 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 auto. 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”
eco_score: Información textual acerca del ECO-score del auto.
pictures: Esta etiqueta engloba las distintas imágenes del auto.
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">...</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 aviso en particular será la primera del conjunto de imágenes del aviso. Las imágenes deben ser de 160x160px como mínimo, con un peso máximo de 5MB.

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

Una vez se inserten tus avisos en Trovit, las imágenes asociadas a los avisos no se podrán modificar ni tan siquiera en la siguiente lectura de tu feed.

Asegúrate que los nuevos avisos que añadas a tu feed incluyen las imágenes correctas.
date: Fecha de publicación del aviso. 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 aviso. 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.

is_new: Si el auto es nuevo o no.

FORMATO XML

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

<?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[Palermo]]></city_area>
    <city><![CDATA[Buenos Aires]]></city>
    <region><![CDATA[Capital Federal]]></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[01/01/2011 18:30:25]]></date>
</ad>
</trovit>

Articles in this section

Costa Rica - Feed Autos

Formato del feed XML

CAMPOS OBLIGATORIOS

CAMPOS OPCIONALES

FORMATO XML

EJEMPLO

Comments