Tus avisos en Trovit Colombia

Feed Casas

Si tienes un portal con avisos publicados, ¡puedes incluir tus avisos en Trovit! Es muy sencillo:

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

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

En Trovit Casas sólo aceptamos feeds con avisos de casas en venta o alquiler.

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 la Wikipedia.

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

El archivo XML contendrá un tag ‘trovit’ y elementos ‘ad’. Cada uno de los ‘ad’ posee los campos:

CAMPOS OBLIGATORIOS

  • id: id 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: la URL del aviso en tu página web
  • title: el título del aviso (debe ser completamente relacionado con el aviso, no puede contener ni el nombre ni la URL de tu web).
  • type: tipo de aviso, el contenido de este campo debe ser uno de los siguientes :
    • “For Rent”: Arriendo de inmueble
    • “For Sale”: Venta de inmueble
    • “Roommate”: Compartir apartamento
    • “Office For Rent”: Arriendo de oficina/consultorio
    • “Office For Sale”: Venta de oficina/consultorio
    • “Land For Sale”: Venta de terreno/lote
    • “For Rent Local”: Arriendo de local
    • “For Sale Local”: Venta de local
    • “Warehouse For Rent”: Arriendo de bodega
    • “Warehouse For Sale”: Venta de bodega
  • content: descripción del aviso (mínimo de 30 caracteres). Recuerda que cuanto más rica sea la descripción, máyor será tu audiencia!

CAMPOS OPCIONALES

Los campos opcionales son justamente eso: opcionales!. Pero si dispones de estos campos en tu site, no dudes en incuirlos en tu feed! El algoritmo de ordenación de Trovit prioriza la calidad, y cuanto más rico sea el aviso, mayor 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 aviso. Por defecto el precio se considera mensual pero se puede indicar explícitamente el periodo (monthly, daily o weekly) como atributo dentro de esta etiqueta.
      <price period="weekly"><![CDATA[...]]></price>

      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.

      La sintaxis para un ejemplo completo sería la siguiente:

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

      Esto especificaría el precio semanal, en dólares. No se debe incluir el símbolo de la moneda junto al precio.

    • property_type: Tipo de propiedad (por ejemplo: apartamento, casa, estudio, chalé, penthouse, etc.). Sólo aplicable si el aviso es de tipo “For Rent”, “For Sale”.

 

    • address: Dirección donde se encuentra el bien inmobiliario.
    • floor_number: Información textual con el número de piso del bien inmobiliario.
    • neighborhood: Barrio donde se encuentra el bien inmobiliario.
    • city_area: Área de la ciudad donde se encuentra el bien inmobiliario (localidad en Bogota por ejemplo).
    • city: Ciudad donde se encuentra el bien inmobiliario.
    • region: Nombre del departamento / provincia donde se encuentra el bien inmobiliario.
    • postcode: Código postal.
    • latitude: Latitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
    • longitude: Longitud donde se encuentra el bien inmobiliario. Ver especificaciones técnicas para más detalles.
    • orientation: Información textual sobre la orientación del alojamiento (norte, sur, este, oeste, etc.).
    • agency: Nombre de la agencia. Ver campo by_owner para más información.
    • mls_database: Identificador único asignado a cada bien inmobiliario de una base de datos MLS (Multiple Listing Service).

 

  • floor_area: Superficie del bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’:
    <floor_area unit="feet"><![CDATA[...]]></floor_area>

    Los valores de ‘unit’ disponibles son: “meters” o “feet”.

  • plot_area: Superficie del lote/terreno dónde se ubica el bien inmobiliario. Si no se especifica la unidad de medida se tomará la medida local por defecto. Podemos especificar la unidad de medida con el atributo ‘unit’:
    <plot_area unit="hectares"><![CDATA[...]]></plot_area>

    Los valores de ‘unit’ disponibles son: “meters”, “feet”, “acres” o “hectares”.

  • rooms: Número de habitaciones del bien inmobiliario.
  • bathrooms: Número de baños del bien inmobiliario.
  • condition: Información textual sobre el estado del bien inmobiliario (por ejemplo: reformado recientemente).
  • year: Año de construcción del bien inmobiliario. El formato aceptado es AAAA.
  • virtual_tour: URL dónde se puede encontrar un paseo virtual del bien inmobiliario.
  • eco_score: Información textual acerca de la eficiencia energética del bien inmobiliario.
  • pictures: Esta etiqueta engloba las distintas imágenes del bien inmobiliario.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, excepto si alguna de ellas es marcada como imagen destacada. Las imágenes deben ser de 186x186px como mínimo, con un peso máximo de 1MB.

    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.

Los siguientes campos deben rellenarse según si son ciertos o falsos. Ver especificaciones técnicas para saber que valores representan cierto y que valores falso.

  • by_owner: Si el bien inmobiliaro es ofrecido por un particular. En caso de ser falso se entenderá que es ofrecido por una agencia.
  • is_rent_to_own: Si es un bien inmobiliario en alquiler con opción a compra o no.
  • parking: Si el bien inmobiliario tiene parqueadero o no.
  • foreclosure: Si el bien inmobiliario está bajo subasta por embargo.
  • is_furnished: Si el bien inmobiliario está amueblado o no.
  • is_new: Si el bien inmobiliario es de nueva construcción 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>
    <type><![CDATA[...]]></type>

    <agency><![CDATA[...]]></agency>
    <content><![CDATA[...]]></content>

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

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

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

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

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

    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>

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

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

    <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.co/ad/7004578]]></url>
<title><![CDATA[Apartamento 2 habitaciones en Bogotá]]></title>
<type><![CDATA[For rent]]></type>

<agency><![CDATA[Agencia Inmobiliaria]]></agency>
<content><![CDATA[Apartamento en arriendo de 2 habitaciones en Quiroga, Bogotá]]></content>

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

<property_type><![CDATA[Apartamento]]></property_type>
<floor_area unit="meters"><![CDATA[100]]></floor_area>
<rooms><![CDATA[2]]></rooms>

<bathrooms><![CDATA[2]]></bathrooms>
<parking><![CDATA[1]]></parking>

<address><![CDATA[]]></address>
<city><![CDATA[Bogotá]]></city>

<city_area><![CDATA[Quiroga]]></city_area>
<postcode><![CDATA[]]></postcode>
<region><![CDATA[Bogotá D.C]]></region>

<latitude><![CDATA[]]></latitude>

<longitude><![CDATA[]]></longitude>

<pictures>
<picture>
<picture_url><![CDATA[http://www.tudominio.com.co/image.jpg]]></picture_url>
<picture_title><![CDATA[salón]]></picture_title>
</picture>
</pictures>

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



</ad>

Especificaciones Técnicas

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

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