NovoProduct Score, 4T Segmentation, Price War e Broken Size já estão disponíveis.Veja as novidades
Feedance
Logotipo Grupo ZapGrupo ZapCanal · Marketplaces e apps
Integração com Grupo Zap

Envie para Grupo Zap os produtos
que valem a pena mostrar

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

Feed de produtos para Grupo Zap
Gerado pela Feedance
Exportação em XML, CSV ou JSONAtualizado a cada sincronização
<item>
  <id>TS-1042</id>
  <title>Camiseta gola careca</title>
  <price>49.90 USD</price>
  <availability>in stock</availability>
  <custom_label_0>score_86</custom_label_0>
  <custom_label_1>top</custom_label_1>
  <custom_label_2>best_price</custom_label_2>
  <custom_label_3>size_ok</custom_label_3>
</item>
Labels da Feedance, gravados como custom labels
O que a Feedance envia para Grupo Zap

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.

Product Scorecustom_label_0Uma pontuação de 0 a 100 com base em visualizações, adições ao carrinho e compras em 1, 7 e 30 dias.
Segmento 4Tcustom_label_1Top, Tolerable, Tranquil ou Toxic, com base no tráfego e no retorno de cada produto.
Price Warcustom_label_2Mais barato, igual ou mais caro que concorrentes nomeados.
Broken Sizecustom_label_3Sinaliza modelos cuja grade de tamanhos está quase toda esgotada.
Criativosimage_linkImagens com a sua marca, do Creative Suite, com preço e detalhes de campanha vindos do feed.
Como usar: divida campanhas, grupos de produtos ou conjuntos de produtos por esses labels, por exemplo apenas produtos Top, ou tudo exceto Toxic e grades de tamanhos quebradas. Os slots de labels são configuráveis. A Feedance não altera seus lances nem seus orçamentos.

O que é o Grupo ZAP?

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.

Por que conectar seu feed de anúncios de imóveis ao Grupo ZAP?

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.

O VRSync substitui o antigo formato XML do ZAP

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.

Qual formato de feed o Grupo ZAP exige?

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:

  1. Permitir o User-Agent do crawler (identificado na documentação como VivaRealBot/1.0), caso contrário as requisições falharão com HTTP 403
  2. Servir o feed via HTTPS com um certificado válido e não autoassinado, com suporte a TLS 1.0–1.2
  3. Responder dentro de um tempo limite de conexão de 60 segundos e concluir a transferência do arquivo dentro de uma janela de download de 20 minutos
  4. Manter a própria URL do feed com menos de 255 caracteres, usando codificação de URL adequada e sem espaços
  5. Suportar até 100 redirecionamentos no mesmo protocolo, caso a URL passe por redirecionamentos

O XML Validator oficial também limita os arquivos aceitos a 30MB e rejeita qualquer arquivo que não esteja no formato VRSync.

Quais atributos de anúncios de imóveis o VRSync exige?

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

AtributoElementoRequisito
ID do anúncioListingIDObrigatório, 1–50 caracteres, único por imóvel
TítuloTitleObrigatório, 10–100 caracteres, sem tags HTML
Tipo de transaçãoTransactionTypeObrigatório: For Sale, For Rent ou Sale/Rent
Endereço / localizaçãoLocation (Country, State, City, Neighborhood, PostalCode)Obrigatório; PostalCode (CEP) obrigatório em todos os anúncios
FotosMedia / ItemObrigatório, mínimo de 5 imagens por anúncio
Contato do corretorContactInfo (Name, Email)Obrigatório
Tipo de imóvelPropertyTypeObrigatório, deve usar valores padronizados
DescriçãoDescriptionObrigatório, 50–3.000 caracteres, CDATA, sem tags HTML
Área útilLivingAreaObrigatório para a maioria dos tipos de imóvel, unit="square metres"
Quartos / banheirosBedrooms, BathroomsObrigatório para tipos residenciais; não obrigatório para terrenos ou galpões
Preço de venda ou de aluguelListPrice / RentalPriceListPrice obrigatório para anúncios de venda; RentalPrice obrigatório para anúncios de locação; atributo currency="BRL" obrigatório
Área do terrenoLotAreaObrigatório no lugar de LivingArea para terrenos, sítios e fazendas

Como conectar o Grupo ZAP à Feedance

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.

  1. Mapeie os campos de dados dos seus imóveis (endereço, preço, quartos, banheiros, área, fotos, tipo de transação) para os elementos VRSync correspondentes
  2. Configure a lógica condicional necessária — por exemplo, preencher LotArea apenas para anúncios de terrenos, ou RentalPrice apenas para anúncios de locação/venda e locação —, já que os campos obrigatórios do VRSync variam conforme o tipo de imóvel
  3. Publique o feed em uma URL HTTPS estável que atenda aos requisitos de conexão do Grupo ZAP (certificado válido, User-Agent permitido, URL com menos de 255 caracteres)
  4. Cadastre essa URL do feed no Grupo ZAP pelo Canal Pro ou com o seu representante de conta, para que o crawler comece a buscá-la
  5. Acompanhe os relatórios de integração que o Grupo ZAP envia (pelo Canal Pro, por e-mail ou por webhook, conforme a documentação) e corrija na origem os anúncios rejeitados

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.

Com que frequência o feed deve ser atualizado?

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.

Erros comuns no feed

A documentação do Grupo ZAP e o seu XML Validator apontam várias causas recorrentes de rejeição de anúncios:

  1. Valores monetários e de área formatados com símbolos de moeda, separadores de milhar ou decimais — por exemplo, "R$560.000,00" ou "32,20" — em vez de números inteiros simples
  2. Ausência do atributo obrigatório currency="BRL" nos elementos de preço, ou do atributo unit="square metres" nos elementos de área
  3. Elementos Description vazios ou ausentes (<Description/>), ou descrições fora da faixa de 50–3.000 caracteres
  4. Ausência de LivingArea (ou de LotArea para anúncios de terrenos/sítios), que o validador trata como erro grave
  5. Respostas HTTP 403 porque o servidor de hospedagem bloqueia o User-Agent do crawler
  6. URLs de feed com mais de 255 caracteres ou com caracteres/espaços não codificados
  7. Arquivos que não são XML VRSync válidos ou que ultrapassam o limite de 30MB do validador

Dicas de otimização

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

  1. Vá além do mínimo de 5 imagens — mais fotos, em uma ordem lógica, com a fachada ou o melhor cômodo primeiro, costumam aumentar o engajamento nos portais de anúncios
  2. Escreva descrições completas e precisas, aproveitando toda a faixa de caracteres disponível em vez do mínimo, já que uma descrição rasa de 50 caracteres dificilmente converte bem, mesmo que passe na validação
  3. Mantenha os campos de preço e status sincronizados em tempo real com o seu sistema de origem, do seu lado, para que a próxima varredura sempre busque dados atuais, e não um retrato desatualizado
  4. Preencha os diferenciais opcionais quando disponíveis (links de tour virtual, latitude/longitude precisas, detalhes de bairro/zona) para ajudar os compradores a filtrar e encontrar o anúncio

Perguntas frequentes

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.

Sobre Grupo Zap

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.

Descubra quais
produtos dão retorno.

Conecte seu feed e o GA4. Mostramos Product Score, 4T, Price War e Broken Size no seu próprio catálogo.