INTEGRAÇÃO

Transcrição

1 INTEGRAÇÃO

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

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

4 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

5 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_ O agency_ (campo texto) refere-se ao 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.

6 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[ <urlimovel><![cdata[ <agency_name><![cdata[nome da imobiliária]]></agency_name> <agency_ ><![cdata[ @imobiliaria.com.br]]></agency_ > <logo><![cdata[

7 <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[ </ad> </roteirodoimovel> A equipe do Exibir Imóveis está à disposição, aguardamos seu contato: Telefones: (27) / (vivo / WhatsApp) parceiro@exibirimoveis.com.br