Feed Veículos

Se você tem uma pagina web com anúncios publicados, pode incluir seus anúncios no Wiju!. É muito fácil:

  1. Faça um arquivo XML seguindo o formato especificado abaixo.
  2. Envíe a URL na qual se hospeda (Exemplo: http://www.seudominio.com/wiju_feed.xml) através do nosso formulário de contato.

A partir desse momento, leremos o feed periodicamente para inserir anúncios novos, realizar as modificações necessárias e exlcuir aqueles anúncios que já não estão presentes em seu feed.

Seus anúncios serão introduzidos nos resultados de busca do Wiju o quanto antes possível.

Se você tem alguma dúvida não hesite em entrar em contato conosco

Formato do feed XML

Estas são as instruções para gerar um feed XML com o propósito de incluir seus anúncios no Wiju. Também poderá utilizar nosso XSD Schema no qual é descrita a estrutura do feed. Se precisar mais informação sobre o formato XML te aconselhamos a consultar Wikipedia.

A codificação do arquivo deve ser em UTF-8

O arquivo XML conterá uma etiqueta principal <wiju> que recolherá um conjunto de anúncios representado por blocos de etiquetas <ad></ad>. Cada bloco <ad></ad> contém campos obrigatórios e opcionais:

CAMPOS OBRIGATÓRIOS

Os campos obrigatórios são o conjunto de etiquetas XML que proporcionam a quantidade mínima de informações necessárias para que nossos sistemas incluam seus anúncios no Wiju.

  • id: Identificador do anúncio na sua página web (pode ser numérico ou alfa-numérico, mas deve ser único, já que o utilizamos para evitar anúncios duplicados).
  • url: URL do anúncio na sua página web.
  • title: Título do anúncio.
  • content: Descrição do anúncio (mínimo de 30 caracteres). Lembre que quanto mais detalhada a descrição, maior será seu público!.

CAMPOS OPCIONAIS

Os campos opcionais não devem ser inseridos se não tem conteúdo. Mas se você possui estes campos em sua página web, não hesite em incluí-los em seu feed. O algoritmo de ordenação do Wiju prioriza a qualidade, e quanto mais detalhado seja o anúncio, melhor será seu posicionamento!

  • price: Preço do veículo.

    Quando o preço estiver especificado em uma moeda que não é a moeda oficial do país, deverá utilizar o atributo ‘currency’. Os valores estarão determinados pela norma ISO-4217. Deste modo, Wiju poderá realizar a conversão para a moeda oficial.

    <price currency="BRL"><![CDATA[...]]></price>

    Isto especificaria o preço do veículo em reais. Não deve colocar o símbolo da moeda junto ao preço. Ver especificações técnicas para obter mais informações.

  • car_type: Informação textual do tipo de veículo (por exemplo: 4×4,compactos,esportivos, familiar, etc.).
  • city: Cidade onde encontra-se o veículo.
  • region: Nome da região / estado onde encontra-se o veículo.
  • postcode: Código postal.
  • brand: Marca do veículo.
  • model: Modelo do veículo.
  • year: Ano de fabricação do veículo. O formato aceito é AAAA.
  • mileage: Quilometragem do veículo.Se não é especificada a unidade de medida, será utilizada quilômetros como unidade de medida. Podemos especificar a unidade de medida com o atributo ‘unit’:
    <mileage unit="kilometers"><![CDATA[...]]></mileage>
    

    Os valores de ‘unit’ disponíveis são: “kilometers” o “miles”.

  • doors: Número de portas.
  • fuel: Informação textual sobre o combustível que o veículo utiliza (por exemplo: gasolina,diesel, etc.). * Diesel * Gasolina * Elétrico * Híbrido * Gas
  • transmission: Informação textual sobre o tipo de câmbio do veículo (por exemplo: manual, automático,etc.). *Manual * Automatico
  • latitude: Latitude onde encontra-se o veículo. Ver especificações técnicas para mais detalhes.
  • longitude:Longitude onde encontra-se o veículo. Ver especificações técnicas para mais detalhes.
  • pictures: Esta etiqueta inclui as diferentes imagens do veículo.

    O campo que define uma imagem em particular é <picture>:

    • picture: Esta etiqueta inclui os campos para especificar a URL e o título da imagem (este último opcional).

      Os campos para definir dentro do elemento <picture> são:

      • picture_url: URL da imagem.
      • picture_title: Título de la imagen.
    <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>
    

    A imagen mostrada no Wiju de um anúncio em particular será a primeira do conjunto de imagens do anúncio.
    Escolha a imagem mais adequada já que esta tem uma grande influência sobre os clicks do usuário.

    Wiju não permite incluir fotos corporativas com a mensagem “Imagen não disponível”.
    Se fosse detectado este caso, Wiju reserva-se o direito de bloquear seus anúncios.

    Uma vez inseridos seus anúncios no Wiju, as imagens associadas aos anúncios não poderão ser modificadas nem se quer na seguinte leitura do seu feed.
    Verifique que os novos anúncios que serão inseridos no seu feed incluam as imagens corretas.

  • date: Data da publicação do anúncio. O formato aceito é DD/MM/AAAA.
  • time: Hora da publicação do anúncio. O formato aceito é HH:MM o HH:MM:SS.
  • expiration_date: Data que expira o anúncio. O formato aceito é DD/MM/AAAA.

O seguinte campo deve ser preenchido conforme se a informação é correta ou falsa. Ver especificações técnicas para saber que valores representam o correto e que valores representam o falso.

  • is_new: Se o veículo é novo ou não.

O feed XML ficará assim:

<?xml version="1.0" encoding="utf-8"?>
<wiju>
	<ad>
        <id><![CDATA[...]]></id>
        <url><![CDATA[...]]></url>
        <title><![CDATA[...]]></title>
        <content><![CDATA[...]]></content>
        <type><![CDATA[...]]></type>
        
        <price><![CDATA[...]]></price>
        
        <date><![CDATA[...]]></date>
        <time><![CDATA[...]]></time>
        
        <city><![CDATA[...]]></city>
        <region><![CDATA[...]]></region>
        <postcode><![CDATA[...]]></postcode>
        
        <year unit="meters"><![CDATA[...]]></year>
        <kilometers><![CDATA[...]]></kilometers>
        <doors><![CDATA[...]]></doors>
        
        <pictures>
        	<pictures><![CDATA[...]]></pictures>
        	<pictures><![CDATA[...]]></pictures>
        </pictures>
	</ad>
	<ad>
        ....
	</ad>
	<ad>
        ....
	</ad>
	...
</wiju>
  

Exemplo de feed XML

<?xml version="1.0" encoding="utf-8"?>
<wiju>
  <ad>
    <id><![CDATA[16677402]]></id>
    <url><![CDATA[http://www.seudominio.com/oferta-carro-peugeot-206-iid-309105610]]></url>
    <title><![CDATA[Carro oferta peugeot 206]]></title>
    <content><![CDATA[Oferta imperdível de carro marca peugeot modelo 206, estado de novo, com 50.000 km, consulte o preço, barbada!]]></content>
    <type><![CDATA[Venda]]></type>
    <price><![CDATA[19000]]></price>
    <date><![CDATA[2012-01-30]]></date>
    <time><![CDATA[17:52]]></time>
        
    <city><![CDATA[São Paulo]]></city>
    <region><![CDATA[São Paulo]]></region>
    <postcode><![CDATA[01000-000]></postcode>
    
    <pictures>
      <pictures><![CDATA[http://www.seudominio.com/imagen_1.jpg]]></pictures>
      <pictures><![CDATA[http://www.seudominio.com/imagen_2.jpg]]></pictures>
    </pictures>
  </ad>
</wiju>
    

Versão do about: 13/05/2011