NovitàProduct Score, 4T Segmentation, Price War e Broken Size sono disponibili.Scopri le novità
Feedance
Logo di Grupo ZapGrupo ZapCanale · Marketplace e app
Integrazione con Grupo Zap

Invia a Grupo Zap i prodotti
che vale la pena mostrare

Feedance crea il tuo feed per Grupo Zap e aggiunge a ogni prodotto etichette per punteggio, segmento 4T, posizione di prezzo e taglie mancanti, così ogni prodotto porta con sé il proprio segnale di performance.

Feed di prodotto Grupo Zap
Generato da Feedance
Export XML, CSV o JSONAggiornato a ogni sincronizzazione
<item>
  <id>TS-1042</id>
  <title>T-shirt girocollo</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>
Etichette Feedance, scritte come etichette personalizzate
Cosa invia Feedance a Grupo Zap

Un catalogo con un segnale di performance su ogni prodotto

Grupo Zap legge i tuoi prodotti dal feed. Feedance invia un feed completo e valido, più i segnali che Grupo Zap da solo non ha.

Product Scorecustom_label_0Un punteggio da 0 a 100 basato su visualizzazioni, aggiunte al carrello e acquisti a 1, 7 e 30 giorni.
Segmento 4Tcustom_label_1Top, Tolerable, Tranquil o Toxic, in base al traffico e al ritorno di ciascun prodotto.
Price Warcustom_label_2Più economico, allo stesso prezzo o più caro rispetto a concorrenti specifici.
Broken Sizecustom_label_3Segnala i modelli con la maggior parte delle taglie esaurite.
Creativitàimage_linkImmagini brandizzate da Creative Suite, con prezzo e dettagli della campagna presi dal feed.
Come usarlo: suddividi campagne, gruppi di prodotti o set di prodotti in base a queste etichette, ad esempio solo i prodotti Top, oppure tutto tranne i Toxic e i modelli con taglie mancanti. Gli slot delle etichette sono configurabili. Feedance non modifica le tue offerte né i tuoi budget.

Che cos'è Grupo ZAP?

Grupo ZAP è la divisione immobiliare di OLX Group in Brasile e gestisce i due maggiori portali di annunci immobiliari del paese: ZAP Imóveis e Viva Real. Agenzie immobiliari, mediatori e fornitori di CRM collegano il proprio inventario di immobili a Grupo ZAP, così gli annunci di vendita e affitto compaiono su entrambi i portali (e, a seconda del piano sottoscritto, anche sugli annunci OLX) a partire da un unico feed di dati, anziché con un inserimento manuale per ciascun portale.

Perché collegare il tuo feed di annunci immobiliari a Grupo ZAP?

Invece di far ridigitare a un mediatore o a un agente lo stesso annuncio separatamente su ZAP Imóveis, Viva Real e OLX, il sistema di gestione degli immobili genera un unico file XML standardizzato che i crawler di Grupo ZAP prelevano a intervalli fissi. Qualsiasi modifica fatta una sola volta nel sistema di origine (un nuovo prezzo, un set di foto aggiornato, un annuncio segnato come venduto o affittato) si propaga automaticamente a tutti i portali collegati alla scansione successiva: è questo il motivo principale per cui le agenzie automatizzano il processo invece di gestire a mano il back office di ogni portale.

VRSync sostituisce il formato XML ZAP legacy

La documentazione per sviluppatori di Grupo ZAP indica due schemi XML supportati: il formato "ZAP" legacy, descritto esplicitamente come in modalità di manutenzione, e VRSync, lo standard attuale che "integra tutte le nuove funzionalità". La documentazione afferma che i feed non VRSync sono in fase di dismissione, e lo strumento di validazione XML di Grupo ZAP accetta solo file in formato VRSync. Qualsiasi nuova integrazione, compresa una realizzata con uno strumento di gestione dei feed, dovrebbe puntare a VRSync anziché al formato precedente.

Quale formato di feed richiede Grupo ZAP?

Grupo ZAP acquisisce gli annunci con un'architettura di polling: non accetta caricamenti inviati attivamente, ma scarica periodicamente un file XML VRSync da un URL che fornisci tu. Secondo la Guia de Conexão ufficiale (linee guida per il collegamento), il server che ospita il feed deve soddisfare diversi requisiti tecnici concreti:

  1. Consentire lo User-Agent del crawler (indicato nella documentazione come VivaRealBot/1.0), altrimenti le richieste falliranno con un errore HTTP 403
  2. Servire il feed via HTTPS con un certificato valido e non autofirmato, con supporto a TLS 1.0–1.2
  3. Rispondere entro un timeout di connessione di 60 secondi e completare il trasferimento del file entro una finestra di download di 20 minuti
  4. Mantenere l'URL del feed sotto i 255 caratteri, con una corretta codifica URL e senza spazi non codificati
  5. Supportare fino a 100 reindirizzamenti con lo stesso protocollo, se la catena dell'URL prevede dei redirect

Il validatore XML ufficiale limita inoltre i file accettati a 30 MB e rifiuta qualsiasi file non formattato secondo VRSync.

Quali attributi degli annunci immobiliari richiede VRSync?

Lo schema VRSync è organizzato in un blocco Listing e in un blocco Details annidato. In base al riferimento degli elementi di Grupo ZAP, i seguenti risultano obbligatori (o obbligatori a seconda del tipo di immobile):

AttributoElementoRequisito
ID annuncioListingIDObbligatorio, 1–50 caratteri, univoco per immobile
TitoloTitleObbligatorio, 10–100 caratteri, senza tag HTML
Tipo di transazioneTransactionTypeObbligatorio: For Sale, For Rent o Sale/Rent
Indirizzo / localitàLocation (Country, State, City, Neighborhood, PostalCode)Obbligatorio; PostalCode obbligatorio in tutti gli annunci
FotoMedia / ItemObbligatorio, minimo 5 immagini per annuncio
Contatto del mediatoreContactInfo (Name, Email)Obbligatorio
Tipo di immobilePropertyTypeObbligatorio, deve usare valori standardizzati
DescrizioneDescriptionObbligatorio, 50–3.000 caratteri, CDATA, senza tag HTML
Superficie abitabileLivingAreaObbligatorio per la maggior parte dei tipi di immobile, unit="square metres"
Camere da letto / bagniBedrooms, BathroomsObbligatori per le tipologie residenziali; non obbligatori per terreni o magazzini
Prezzo di vendita o di affittoListPrice / RentalPriceListPrice obbligatorio per gli annunci di vendita; RentalPrice obbligatorio per gli annunci di affitto; attributo currency="BRL" obbligatorio
Superficie del lottoLotAreaObbligatorio al posto di LivingArea per terreni, aziende agricole e ranch

Come collegare Grupo ZAP a Feedance

Feedance può generare e ospitare il file XML VRSync che il crawler di Grupo ZAP preleva, mappando i record degli immobili del tuo sistema di origine (CRM, ERP o foglio di calcolo) nella struttura Header, Listing e Details richiesta dallo standard.

  1. Mappa i campi dei dati degli immobili (indirizzo, prezzo, camere da letto, bagni, superficie, foto, tipo di transazione) sui corrispondenti elementi VRSync
  2. Configura la logica condizionale necessaria (per esempio, compilare LotArea solo per gli annunci di terreni, o RentalPrice solo per gli annunci Rent/Sale-Rent), perché i campi obbligatori di VRSync variano in base al tipo di immobile
  3. Pubblica il feed a un URL HTTPS stabile che soddisfi i requisiti di collegamento di Grupo ZAP (certificato valido, User-Agent consentito, URL sotto i 255 caratteri)
  4. Registra l'URL del feed presso Grupo ZAP tramite Canal Pro o il tuo referente commerciale, così il loro crawler inizia a prelevarlo
  5. Monitora i report di integrazione che Grupo ZAP invia (tramite Canal Pro, email o webhook, secondo la loro documentazione) e correggi alla fonte gli annunci rifiutati

Poiché si tratta di uno schema immobiliare specializzato e profondamente annidato, e non di un catalogo prodotti piatto, preparati a un lavoro iniziale di mappatura dei campi maggiore rispetto a un normale feed di shopping per l'e-commerce.

Con quale frequenza dovrebbe aggiornarsi il feed?

La documentazione di Grupo ZAP indica che i file XML vengono elaborati due volte al giorno, a intervalli di circa 12 ore: si tratta di un prelievo basato sulla scansione, non di un invio attivo, quindi non c'è alcun vantaggio nel rigenerare il feed più spesso di questo ciclo. Ciò che conta è che il feed rifletta la situazione reale (prezzo, disponibilità, stato di venduto/affittato) prima di ogni finestra di scansione, perché un feed non aggiornato manterrà online un immobile non disponibile, o un prezzo aggiornato non sincronizzato, fino al prelievo successivo dopo 12 ore.

Errori frequenti del feed

La documentazione di Grupo ZAP e il suo validatore XML segnalano diverse cause ricorrenti di rifiuto degli annunci:

  1. Valori monetari e di superficie formattati con simboli di valuta, separatori delle migliaia o decimali (per esempio "R$560.000,00" o "32,20") anziché come semplici numeri interi
  2. Mancanza dell'attributo obbligatorio currency="BRL" negli elementi di prezzo, o dell'attributo unit="square metres" negli elementi di superficie
  3. Elementi Description vuoti o mancanti (<Description/>), oppure descrizioni al di fuori dell'intervallo di 50–3.000 caratteri
  4. Mancanza di LivingArea (o di LotArea per gli annunci di terreni/aziende agricole), che il validatore considera un errore bloccante
  5. Risposte HTTP 403 perché il server di hosting blocca lo User-Agent del crawler
  6. URL del feed oltre i 255 caratteri o contenenti caratteri/spazi non codificati
  7. File che non sono XML VRSync validi o che superano il limite di 30 MB del validatore

Consigli di ottimizzazione

Best practice generali sulla qualità dei feed (non indicazioni specifiche di Grupo ZAP) che tendono a migliorare le performance degli annunci sui portali immobiliari:

  1. Vai oltre il minimo di 5 immagini: più foto, in un ordine logico con l'esterno o la stanza migliore per prima, migliorano in genere il coinvolgimento sui portali di annunci
  2. Scrivi descrizioni complete e accurate che sfruttino tutto lo spazio disponibile anziché il minimo, perché una descrizione scarna di 50 caratteri difficilmente converte bene, anche se supera la validazione
  3. Mantieni dalla tua parte i campi di prezzo e stato sincronizzati in tempo reale con il sistema di origine, così la scansione successiva preleva sempre dati aggiornati e non un'istantanea superata
  4. Compila, dove disponibili, gli elementi facoltativi che fanno la differenza (link ai tour virtuali, latitudine/longitudine precise, dettagli su quartiere/zona) per aiutare gli acquirenti a filtrare e trovare l'annuncio

FAQ

Feedance supporta in modo specifico il formato VRSync? Feedance può generare feed XML mappati sulla struttura di elementi VRSync definita dalla documentazione di Grupo ZAP; il formato ZAP legacy è deprecato e non dovrebbe essere usato per nuove integrazioni.

Posso inviare lo stesso feed a ZAP Imóveis, Viva Real e OLX? Il materiale di Grupo ZAP descrive un unico feed XML distribuito ai portali inclusi nel piano sottoscritto, senza bisogno di feed separati per ciascun portale.

Come faccio a sapere se un annuncio è stato rifiutato? Grupo ZAP dichiara di inviare report di integrazione e, per gli errori che persistono per più di tre giorni, notifiche email dirette con i dettagli di ciò che non è andato a buon fine.

È lo stesso tipo di feed di un feed di prodotto per Google Merchant Center o Meta? No: VRSync è uno schema specifico per il settore immobiliare, con strutture annidate Location, Media, ContactInfo e Details e campi obbligatori che dipendono dal tipo di immobile, quindi strutturalmente diverso da un feed di prodotto e-commerce piatto, anche se l'obiettivo di fondo (un unico feed di origine, più destinazioni) è simile.

Informazioni su Grupo Zap

Grupo ZAP è il business immobiliare di OLX Group in Brasile. Gestisce due dei più grandi portali immobiliari del paese, ZAP Imóveis e Viva Real, dove le persone cercano case, appartamenti e immobili commerciali da acquistare o affittare.

Agenzie immobiliari, broker e fornitori di software immobiliare inviano i propri annunci a Grupo ZAP affinché gli immobili compaiano su entrambi i portali e, a seconda del piano sottoscritto, anche sugli annunci classificati di OLX. Un'unica fonte di dati sostituisce l'inserimento manuale dello stesso annuncio nel back office di ciascun portale.

Gli annunci vengono forniti come feed XML nel formato VRSync, che Grupo ZAP indica come proprio standard attuale; il vecchio formato ZAP XML è in modalità manutenzione. Grupo ZAP non accetta caricamenti inviati attivamente. Il suo crawler scarica il feed da un URL HTTPS secondo una pianificazione regolare, quindi il server deve consentire l'accesso al crawler, rispondere rapidamente e fornire il file in modo affidabile.

Per le agenzie, la qualità del feed incide sul rendimento degli annunci. Prezzi, indirizzi, tipologie di immobile, superfici, numero di locali e caratteristiche corretti aiutano gli annunci a comparire nelle ricerche giuste, buone foto attirano più richieste e rimuovere rapidamente gli immobili venduti o affittati mantiene affidabile il portafoglio ed evita lead sprecati.

Scopri quali
prodotti rendono.

Collega il tuo feed e GA4. Mostriamo Product Score, 4T, Price War e Broken Size sul tuo catalogo.