Um catálogo com um sinal de desempenho em cada produto
Grupo Zap lê seus produtos a partir do feed. A Feedance envia um feed completo e válido, além dos sinais que Grupo Zap não tem por conta própria.
Grupo ZapCanal · Marketplaces e appsA Feedance cria seu feed para Grupo Zap e adiciona labels por produto para score, segmento 4T, posição de preço e tamanhos quebrados, para que cada produto carregue seu próprio sinal de desempenho.
Grupo Zap lê seus produtos a partir do feed. A Feedance envia um feed completo e válido, além dos sinais que Grupo Zap não tem por conta própria.
O Grupo ZAP é o braço imobiliário do OLX Group no Brasil e opera os dois maiores portais de anúncios de imóveis do país: ZAP Imóveis e Viva Real. Imobiliárias, corretores e fornecedores de CRM conectam seu estoque de imóveis ao Grupo ZAP para que os anúncios de venda e locação apareçam nos dois portais — e, dependendo do plano contratado, também nos classificados da OLX — a partir de um único feed de dados, em vez de cadastro manual em cada portal.
Em vez de o corretor redigitar o mesmo anúncio no ZAP Imóveis, no Viva Real e na OLX separadamente, o sistema de gestão imobiliária gera um único arquivo XML padronizado, e os crawlers do Grupo ZAP o buscam em intervalos fixos. Qualquer alteração feita uma única vez no sistema de origem — um novo preço, um conjunto de fotos atualizado, um imóvel marcado como vendido ou alugado — é propagada automaticamente para todos os portais conectados na próxima varredura, e esse é o principal motivo pelo qual as imobiliárias automatizam esse processo em vez de gerenciar manualmente o painel de cada portal.
A documentação para desenvolvedores do Grupo ZAP cita dois esquemas XML suportados: o antigo formato "ZAP", descrito explicitamente como em modo de manutenção, e o VRSync, o padrão atual que "incorpora todas as novas funcionalidades". A documentação afirma que os feeds que não são VRSync estavam sendo descontinuados, e a própria ferramenta de validação de XML do Grupo ZAP só aceita arquivos no formato VRSync. Qualquer integração nova — inclusive uma criada com uma ferramenta de gestão de feeds — deve usar o VRSync, e não o formato antigo.
O Grupo ZAP importa os anúncios por meio de uma arquitetura de polling: ele não aceita envios ativos; ele baixa periodicamente um arquivo XML VRSync de uma URL que você informa. De acordo com o Guia de Conexão oficial, o servidor que hospeda o arquivo precisa atender a vários requisitos técnicos concretos:
VivaRealBot/1.0), caso contrário as requisições falharão com HTTP 403O XML Validator oficial também limita os arquivos aceitos a 30MB e rejeita qualquer arquivo que não esteja no formato VRSync.
O esquema VRSync é organizado em um bloco Listing e um bloco Details aninhado. Com base na referência de elementos do próprio Grupo ZAP, os itens a seguir estão documentados como obrigatórios (ou obrigatórios conforme o tipo de imóvel):
| Atributo | Elemento | Requisito |
|---|---|---|
| ID do anúncio | ListingID | Obrigatório, 1–50 caracteres, único por imóvel |
| Título | Title | Obrigatório, 10–100 caracteres, sem tags HTML |
| Tipo de transação | TransactionType | Obrigatório: For Sale, For Rent ou Sale/Rent |
| Endereço / localização | Location (Country, State, City, Neighborhood, PostalCode) | Obrigatório; PostalCode (CEP) obrigatório em todos os anúncios |
| Fotos | Media / Item | Obrigatório, mínimo de 5 imagens por anúncio |
| Contato do corretor | ContactInfo (Name, Email) | Obrigatório |
| Tipo de imóvel | PropertyType | Obrigatório, deve usar valores padronizados |
| Descrição | Description | Obrigatório, 50–3.000 caracteres, CDATA, sem tags HTML |
| Área útil | LivingArea | Obrigatório para a maioria dos tipos de imóvel, unit="square metres" |
| Quartos / banheiros | Bedrooms, Bathrooms | Obrigatório para tipos residenciais; não obrigatório para terrenos ou galpões |
| Preço de venda ou de aluguel | ListPrice / RentalPrice | ListPrice obrigatório para anúncios de venda; RentalPrice obrigatório para anúncios de locação; atributo currency="BRL" obrigatório |
| Área do terreno | LotArea | Obrigatório no lugar de LivingArea para terrenos, sítios e fazendas |
A Feedance pode gerar e hospedar o arquivo XML VRSync que o crawler do Grupo ZAP busca, mapeando os registros de imóveis do seu sistema de origem (CRM, ERP ou planilha) para a estrutura Header, Listing e Details exigida pelo padrão.
Como se trata de um esquema imobiliário especializado e profundamente aninhado, e não de um catálogo de produtos plano, conte com mais trabalho inicial de mapeamento de campos do que em um feed de compras de e-commerce padrão.
A própria documentação do Grupo ZAP informa que os arquivos XML são processados duas vezes por dia, em intervalos de aproximadamente 12 horas — trata-se de uma busca baseada em varredura, e não de um envio ativo, então não há vantagem em gerar o feed novamente com mais frequência do que esse ciclo. O que importa é que o feed reflita a realidade atual (preço, disponibilidade, status de vendido/alugado) antes de cada janela de varredura, já que um feed desatualizado manterá um imóvel indisponível anunciado, ou um preço atualizado sem sincronizar, até a próxima busca de 12 horas.
A documentação do Grupo ZAP e o seu XML Validator apontam várias causas recorrentes de rejeição de anúncios:
currency="BRL" nos elementos de preço, ou do atributo unit="square metres" nos elementos de área<Description/>), ou descrições fora da faixa de 50–3.000 caracteresBoas práticas gerais de qualidade de feed (e não afirmações específicas do Grupo ZAP) que costumam melhorar o desempenho dos anúncios em portais imobiliários:
A Feedance suporta especificamente o formato VRSync? A Feedance pode gerar feeds XML mapeados para a estrutura de elementos VRSync definida na documentação do Grupo ZAP; o antigo formato ZAP está descontinuado e não deve ser usado em novas integrações.
Posso enviar o mesmo feed para o ZAP Imóveis, o Viva Real e a OLX? Os materiais do próprio Grupo ZAP descrevem um único feed XML distribuído para os portais incluídos no seu plano contratado, sem exigir feeds separados para cada portal.
Como vou saber se um anúncio foi rejeitado? O Grupo ZAP afirma que envia relatórios de integração e, para erros que persistem por mais de três dias, notificações diretas por e-mail com detalhes sobre o que falhou.
Este é o mesmo tipo de feed que um feed de produtos do Google Merchant Center ou da Meta? Não — o VRSync é um esquema específico do setor imobiliário, com estruturas aninhadas de Location, Media, ContactInfo e Details e campos obrigatórios que dependem do tipo de imóvel, o que o torna estruturalmente diferente de um feed de produtos de e-commerce plano, embora o objetivo de fundo (um feed de origem, vários destinos) seja semelhante.
O Grupo ZAP é o negócio imobiliário do OLX Group no Brasil. Ele opera dois dos maiores portais imobiliários do país, o ZAP Imóveis e o Viva Real, onde as pessoas procuram casas, apartamentos e imóveis comerciais para comprar ou alugar.
Imobiliárias, corretores e fornecedores de software imobiliário enviam seus anúncios ao Grupo ZAP para que os imóveis apareçam nos dois portais e, dependendo do plano contratado, também nos classificados da OLX. Uma única fonte de dados substitui a digitação manual do mesmo anúncio no painel de cada portal.
Os anúncios são entregues como um feed XML no formato VRSync, que o Grupo ZAP aponta como seu padrão atual; o antigo formato ZAP XML está em modo de manutenção. O Grupo ZAP não aceita envios do tipo push. Seu crawler baixa o feed de uma URL HTTPS regularmente, então o servidor precisa permitir o acesso do crawler, responder rapidamente e disponibilizar o arquivo de forma confiável.
Para as imobiliárias, a qualidade do feed afeta o desempenho dos anúncios. Preços, endereços, tipos de imóvel, áreas, número de cômodos e características corretos ajudam os anúncios a aparecerem nas buscas certas, boas fotos atraem mais contatos, e remover prontamente os imóveis vendidos ou alugados mantém a carteira confiável e evita leads desperdiçados.
Conecte seu feed e o GA4. Mostramos Product Score, 4T, Price War e Broken Size no seu próprio catálogo.