Een catalogus met een performancesignaal op elk product
Grupo Zap leest je producten uit de feed. Feedance verstuurt een complete, geldige feed plus de signalen die Grupo Zap zelf niet heeft.
Grupo ZapKanaal · Marktplaatsen en appsFeedance bouwt je Grupo Zap-feed en voegt labels op productniveau toe voor score, 4T-segment, prijspositie en gebroken maatreeksen, zodat elk product zijn eigen performancesignaal meekrijgt.
Grupo Zap leest je producten uit de feed. Feedance verstuurt een complete, geldige feed plus de signalen die Grupo Zap zelf niet heeft.
Grupo ZAP is de vastgoedtak van OLX Group in Brazilië en beheert de twee grootste vastgoedportals van het land: ZAP Imóveis en Viva Real. Makelaarskantoren, makelaars en CRM-aanbieders koppelen hun vastgoedaanbod aan Grupo ZAP, zodat koop- en huurlistings op beide portals verschijnen (en, afhankelijk van het afgesloten abonnement, ook op de advertentiesite van OLX) vanuit één datafeed in plaats van handmatige invoer per portal.
In plaats van dat een makelaar dezelfde listing apart invoert in ZAP Imóveis, Viva Real en OLX, genereert het vastgoedbeheersysteem één gestandaardiseerd XML-bestand dat de crawlers van Grupo ZAP volgens een vast schema ophalen. Elke wijziging die je één keer in het bronsysteem doorvoert, zoals een nieuwe prijs, een bijgewerkte fotoset of een listing die als verkocht of verhuurd is gemarkeerd, wordt bij de volgende crawl automatisch doorgevoerd op alle gekoppelde portals. Dat is de belangrijkste reden waarom kantoren dit automatiseren in plaats van de backoffice van elk portal handmatig te beheren.
De ontwikkelaarsdocumentatie van Grupo ZAP noemt twee ondersteunde XML-schema's: het oude "ZAP"-formaat, dat expliciet wordt omschreven als in onderhoudsmodus, en VRSync, de huidige standaard die "incorporates all new functionality". Volgens de documentatie werden feeds die niet in VRSync zijn uitgefaseerd, en de eigen XML-validator van Grupo ZAP accepteert alleen bestanden in VRSync-formaat. Elke nieuwe integratie, ook een die met een feedmanagementtool wordt gebouwd, moet dus VRSync gebruiken in plaats van het oudere formaat.
Grupo ZAP neemt listings op via een polling-architectuur: het accepteert geen gepushte uploads, maar downloadt periodiek een VRSync-XML-bestand van een URL die jij opgeeft. Volgens de officiële Guia de Conexão (koppelingsrichtlijn) moet de ontvangende server aan een aantal concrete technische eisen voldoen:
VivaRealBot/1.0), anders mislukken verzoeken met een HTTP 403De officiële XML-validator accepteert bovendien bestanden van maximaal 30 MB en weigert alles wat niet in VRSync-formaat is.
Het VRSync-schema is opgebouwd uit een Listing-blok met daarin een Details-blok. Op basis van de eigen elementreferentie van Grupo ZAP zijn de volgende elementen gedocumenteerd als verplicht (of verplicht afhankelijk van het type vastgoed):
| Attribuut | Element | Vereiste |
|---|---|---|
| Listing-ID | ListingID | Verplicht, 1–50 tekens, uniek per object |
| Titel | Title | Verplicht, 10–100 tekens, geen HTML-tags |
| Transactietype | TransactionType | Verplicht: For Sale, For Rent of Sale/Rent |
| Adres / locatie | Location (Country, State, City, Neighborhood, PostalCode) | Verplicht; PostalCode verplicht bij alle listings |
| Foto's | Media / Item | Verplicht, minimaal 5 afbeeldingen per listing |
| Contactgegevens makelaar | ContactInfo (Name, Email) | Verplicht |
| Type vastgoed | PropertyType | Verplicht, moet gestandaardiseerde waarden gebruiken |
| Beschrijving | Description | Verplicht, 50–3.000 tekens, CDATA, geen HTML-tags |
| Woonoppervlak | LivingArea | Verplicht voor de meeste typen vastgoed, unit="square metres" |
| Slaapkamers / badkamers | Bedrooms, Bathrooms | Verplicht voor woningtypen; niet verplicht voor grond of bedrijfshallen |
| Koop- of huurprijs | ListPrice / RentalPrice | ListPrice verplicht voor kooplistings; RentalPrice verplicht voor huurlistings; attribuut currency="BRL" verplicht |
| Perceeloppervlak | LotArea | Verplicht in plaats van LivingArea voor grond, boerderijen en ranches |
Feedance kan het VRSync-XML-bestand genereren en hosten dat de crawler van Grupo ZAP ophaalt, waarbij vastgoedrecords uit je bronsysteem (CRM, ERP of spreadsheet) worden omgezet naar de structuur van Header, Listing en Details die de standaard vereist.
Omdat dit een gespecialiseerd, diep genest vastgoedschema is en geen platte productcatalogus, moet je rekening houden met meer koppelwerk vooraf dan bij een standaard shoppingfeed voor e-commerce.
Volgens de eigen documentatie van Grupo ZAP worden XML-bestanden twee keer per dag verwerkt, met tussenpozen van ongeveer 12 uur. Het gaat om ophalen via een crawl, niet om pushen, dus het heeft geen zin de feed vaker te genereren dan die cyclus. Waar het om gaat, is dat de feed vóór elk crawlvenster de actuele situatie weergeeft (prijs, beschikbaarheid, status verkocht/verhuurd), want een verouderde feed houdt een niet-beschikbaar object online of laat een bijgewerkte prijs ongesynchroniseerd tot de volgende ophaalronde 12 uur later.
De documentatie en de XML-validator van Grupo ZAP signaleren een aantal terugkerende oorzaken van afgewezen listings:
currency="BRL" op prijselementen of het attribuut unit="square metres" op oppervlakte-elementen<Description/>), of beschrijvingen buiten het bereik van 50–3.000 tekensAlgemene praktijken voor feedkwaliteit (geen specifieke claims van Grupo ZAP) die de prestaties van listings op vastgoedportals meestal verbeteren:
Ondersteunt Feedance specifiek het VRSync-formaat? Feedance kan XML-feeds genereren die zijn gekoppeld aan de VRSync-elementstructuur die in de documentatie van Grupo ZAP is gedefinieerd; het oude ZAP-formaat is verouderd en hoort niet te worden gebruikt voor nieuwe integraties.
Kan ik dezelfde feed naar ZAP Imóveis, Viva Real en OLX sturen? Het eigen materiaal van Grupo ZAP beschrijft één XML-feed die wordt verspreid naar de portals die in je afgesloten abonnement zijn opgenomen, in plaats van aparte feeds per portal.
Hoe weet ik of een listing is afgewezen? Grupo ZAP geeft aan dat het integratierapporten verstuurt en, bij fouten die langer dan drie dagen aanhouden, directe e-mailmeldingen met details over wat er misging.
Is dit hetzelfde soort feed als een productfeed voor Google Merchant Center of Meta? Nee. VRSync is een vastgoedspecifiek schema met geneste structuren voor Location, Media, ContactInfo en Details en verplichte velden die afhangen van het type vastgoed. Dat is structureel anders dan een platte productfeed voor e-commerce, ook al is het onderliggende doel (één bronfeed, meerdere bestemmingen) vergelijkbaar.
Grupo ZAP is het vastgoedbedrijf van OLX Group in Brazilië. Het exploiteert twee van de grootste vastgoedportalen van het land, ZAP Imóveis en Viva Real, waar mensen zoeken naar huizen, appartementen en bedrijfspanden om te kopen of te huren.
Makelaarskantoren, makelaars en aanbieders van vastgoedsoftware sturen hun aanbod naar Grupo ZAP, zodat panden op beide portalen verschijnen en, afhankelijk van het afgesloten abonnement, ook in de advertenties van OLX. Eén databron vervangt het handmatig invoeren van hetzelfde aanbod in de backoffice van elk portaal.
Het aanbod wordt aangeleverd als XML-feed in het VRSync-formaat, dat Grupo ZAP als zijn huidige standaard noemt; het oudere ZAP XML-formaat staat in onderhoudsmodus. Grupo ZAP accepteert geen gepushte uploads. De crawler downloadt de feed volgens een vast schema vanaf een HTTPS-URL, dus de server moet de crawler toelaten, snel reageren en het bestand betrouwbaar leveren.
Voor makelaarskantoren beïnvloedt de feedkwaliteit hoe het aanbod presteert. Juiste prijzen, adressen, woningtypen, oppervlakten, aantallen kamers en kenmerken helpen panden in de juiste zoekopdrachten te laten verschijnen, goede foto's leveren meer aanvragen op, en verkochte of verhuurde panden snel verwijderen houdt de portefeuille betrouwbaar en voorkomt verspilde leads.
Koppel je feed en GA4. We tonen Product Score, 4T, Price War en Broken Size op je eigen catalogus.