Manual do Exibir Imóveis

Transcrição

Manual do Exibir Imóveis
INTEGRAÇÃO
www.exibirimoveis.com.br
Sobre o Exibir Imóveis
Somos um agregador de anúncios e nossos parceiros devem ter em consideração dois
pontos importantes para melhorar o resultado e a eficácia dos seus feeds. O
primeiro é o volume de anúncios. O Exibir Imóveis administra milhões de anúncios e
isso significa que quantos mais anúncios houver no feed, maiores são as
probabilidades de ter um bom posicionamento nas listas de resultados. Mas isto nós
não podemos garantir, é apenas uma probabilidade sistêmica.
O segundo é a qualidade do feed. Um bom feed sempre conseguirá melhores
resultados: mais visualizações, mais cliques e despertará o interesse de usuários mais
qualificados. Isso sim nós podemos assegurar, pois nosso algoritmo premia,
sobretudo, a qualidade do feed.
Temos algumas dicas e os principais critérios para desenvolver um bom feed e assim
conseguir ótimo funcionamento no Exibir Imóveis.
Feeds no Exibir Imóveis
Instruções para gerar um feed XML e incluir seus anúncios no Exibir Imóveis.
Tipo: Trabalhamos unicamente com arquivos XML
Codificação: UTF-8
Tipologia de carga: XML Snapshot. Também chamado Full feed ou carga total.
Envio: Por URL ou FTP.
Tamanho: Os feeds que superem os 50MB devem estar comprimidos: zip, gz, rar, etc.
Nº de anúncios: Só aceitamos feeds com um mínimo de 80 anúncios.
O Exibir Imóveis só aceita feeds de portais: Não publicamos diretamente conteúdo de
particulares ou outras webs de empresas ou profissionais que não sejam portais, webs
de classificados ou plataformas. Seus anúncios podem aparecer no Exibir Imóveis
indiretamente, publicando com algum dos nossos parceiros.
Informações adicionais
Campo Descrição (content): É obrigatório que o anúncio contenha uma descrição.
Quanto mais detalhes tiver o seu conteúdo, melhor será o feed.
Preencher campos separadamente: Muito importante é introduzir a informação
em cada um dos campos obrigatórios, preferentes e opcionais (nesta ordem de
relevância). Por exemplo, não é suficiente ter uma excelente descrição enquanto o
feed somente conta com os campos obrigatórios preenchidos. É aconselhável
separar e distribuir a informação em vários campos (obrigatórios e preferentes) em
vez de concentrá-la somente no campo descrição. O mais recomendável é ter o
maior número de campos preenchidos e uma excelente descrição, ainda que a
mesma repita a informação já descrita nos outros campos individuais.
CDATA: Indiscutivelmente essencial! Ainda que o código UTF-8 nos permita ler
praticamente todos os caracteres de uso comum, existem alguns, como trema, til e
ampersand (&), entre outros, que continuam causando problemas. Portanto, é
importante que todos os campos tenham uma seção CDATA. Exemplo:
<![CDATA[...texto...]]>
Fotos: Este campo é de extrema importância para que desperte o interesse do
usuário em visualizar o imóvel. Ter foto ou imagem nos feeds de imóveis aumenta o
número de cliques em mais de nove vezes. Importante! O Exibir Imóveis permite a
inserção de uma única foto por imóvel, uma vez que quando o imóvel recebe um
clique do usuário, o mesmo é redirecionado para a página do corretor de imóveis,
onde poderá ser visualizado o restante das fotos e as demais informações
pertinentes.
Mensagens/Imagens padrão: Não serão veiculados imóveis que possuir
mensagens ou imagens padrão. Por exemplo, “Não tem foto” com o seu próprio
desenho.
Valores padrão: Não colocar valores padrão. Por exemplo, quando o campo preço
não pode ser preenchido, alguns parceiros definem um valor padrão como R$1,00,
R$0,00, R$10,00. Isso impedirá que o feed seja publicado no Exibir Imóveis!
Critérios para feeds
O arquivo XML contém um tag 'exibirimoveis ' e elementos 'ad'. Cada um dos 'ad'
possui os campos:
CAMPOS OBRIGATÓRIOS
idimv: O IDIMV do anúncio da sua página web (pode ser numérico ou alfabético,
porém deve ser único, já que os utilizamos para evitar anúncios duplicados)
urlimovel: A URLIMOVEL do anúncio na sua página web. (Este link redirecionará o
usuário para o site da imobiliária e com isso visualizar mais informações sobre o
imóvel)
url: O url refere-se ao link do site da imobiliária.
title: O title refere-se ao título do anúncio
goal: O goal é um campo numérico e refere-se a finalidade do anúncio (1 –
Residencial; 2 – Comercial; 3 – Rural; 4 – Industrial), deve ser numerado de acordo
com a devida finalidade
type: O type é um campo numérico e refere-se ao que se pretende com o imóvel (1
– Comprar; 2 – Aluguel Anual; 3 – Aluguel Temporada; 4 – Lançamentos), deve ser
numerado de acordo.
property_type: O property_type é um campo numérico e refere-se ao tipo do
imóvel:
1 - Apartamento
2 - Casa de praia
3 - Casa Duplex
4 - Casa Triplex
5 - Casa
6 - Chácara
7 - Chalé
8 - Cobertura
9 - Condomínio Fechado
10 - Depósito
11 - Fazenda
12 - Flat
13 - Garagem
14 - Giardino
15 - Hotel
16 - Kitnet
17 - Loja
18 - Mansão
19 - Pousada
20 - Sala
21 - Salão
22 - Sítio
23 - Sobrado
24 - Studio
25 - Terreno
O campo property_type deve ser numerado de acordo com o tipo do imóvel
region: O region é um campo texto e refere-se a UF (Unidade da Federação):
Acre - AC
Alagoas - AL
Amapá - AP
Amazonas - AM
Bahia - BA
Ceará - CE
Distrito Federal - DF
Espírito Santo - ES
Goiás - GO
Maranhão - MA
Mato Grosso - MT
Mato Grosso do Sul - MS
Minas Gerais - MG
Pará - PA
Paraíba - PB
Paraná - PR
Pernambuco - PE
Piauí - PI
Rio de Janeiro - RJ
Rio Grande do Norte - RN
Rio Grande do Sul - RS
Rondônia - RO
Roraima - RR
Santa Catarina - SC
São Paulo - SP
Sergipe - SE
Tocantins - TO
O campo region deve ser preenchido com o Estado Brasileiro em que o imóvel está
localizado. Importante! Pode ser preenchido com a SIGLA, exemplo: RJ, ou o
nome completo, exemplo: Rio de Janeiro. Não serão aceitos region com
preenchimento, exemplo: Rio de Janeiro – RJ
city: O city refere-se a cidade em que o imóvel está localizado. Importante! O nome
da cidade deve estar corretamente digitado, caso contrário os feeds serão
impedidos de serem publicados, mesmo se a falha estiver em um único imóvel.
content: O content refere-se a descrição do anúncio. Importante lembrar que
quanto mais completa e atrativa seja a descrição, maior será o número de cliques!
Vale lembrar que só mostramos os 200 primeiros caracteres, mas o conteúdo
completo desse campo está no nosso sistema que, a sua vez, serve como base
para as pesquisas semânticas dos usuários.
CAMPOS PREFERENTES (Importantes para facilitar a busca e deixar mais
completo os dados do imóvel)
Os campos preferentes são quase tão importantes quanto os obrigatórios e
deveriam ser incluídos. O algoritmo de ordenação do Exibir Imóveis prioriza a
qualidade e quanto melhor for o anúncio, melhor será o seu posicionamento!
agency_name: O agency_name (campo texto) refere-se ao nome da imobiliária.
agency_email: O agency_email (campo texto) refere-se ao e-mail da imobiliária.
logo: O logo (campo texto) refere-se a URL da logomarca da imobiliária.
rooms: O rooms (campo numérico) refere-se ao número de quartos do imóvel.
bathrooms: O bathrooms (campo numérico) refere-se ao número de banheiros do
imóvel.
floor_area: O floor_area (campo texto) refere-se a área total do imóvel.
parking: O parking (campo numérico) refere-se ao número de vagas de garagem
do imóvel.
price: O price (campo numérico) refere-se ao valor do imóvel.
country: O country (campo texto) refere-se ao país em que o imóvel se localiza.
neighborhood: O neighborhood (campo texto) refere-se ao bairro em que o imóvel
está localizado.
address: O address (campo texto) refere-se ao endereço em que o imóvel está
localizado.
longitude: O longitude (campo texto) refere-se a coordenada longitude do imóvel.
latitude: O latitude (campo texto) refere-se a coordenada latitude do imóvel.
img1: O img1 (campo texto) refere-se ao link da imagem que deseja exibir do
imóvel.
Exemplo de uma estrutura do feed XML para o Exibir Imóveis
<?xml version='1.0' encoding='utf-8'?>
<roteirodoimovel>
<ad>
<idimv><![CDATA[1000]]></id>
<goal><![CDATA[1]]></goal>
<idimv><![CDATA[10]]></idimv>
<url><![CDATA[http://www.minhaimobiliaria.com.br]]></url>
<urlimovel><![CDATA[http://www.minhaimobiliaria.com.br/imovel/]]></urlimovel>
<agency_name><![CDATA[nome da imobiliária]]></agency_name>
<agency_email><![CDATA[[email protected]]]></agency_email>
<logo><![CDATA[http://www.minhaimobiliaria.com.br/logo.jpg]]></logo>
<type><![CDATA[1]]></type>
<property_type><![CDATA[5]]></property_type>
<title><![CDATA[Oportunidade de ter seu imóvel]]></title>
<content><![CDATA[Casa com cômodos amplos, área de lazer,
etc...]]></content>
<rooms><![CDATA[3]]></rooms>
<bathrooms><![CDATA[2]]></bathrooms>
<parking><![CDATA[1]]></parking>
<floor_area><![CDATA[360 m2]]></floor_area>
<price><![CDATA[450000]]></price>
<region><![CDATA[ES]]></region>
<city><![CDATA[Guarapari]]></city>
<country><![CDATA[Brasil]]></country>
<neighborhood><![CDATA[Praia do Morro]]></neighborhood>
<address><![CDATA[Av. Oceânica, 35]]></address>
<img1><![CDATA[http://www.minhaimobiliaria.com.br/img/foto.jpg]]></img1>
</ad>
</roteirodoimovel>
A equipe do Exibir Imóveis está à disposição, aguardamos seu contato:
Telefones: (27) 99991-5549
E-mail: [email protected]
www.exibirimoveis.com.br