NieuwProduct Score, 4T Segmentation, Price War en Broken Size zijn live.Bekijk wat er nieuw is
Feedance
Logo van Grupo ZapGrupo ZapKanaal · Marktplaatsen en apps
Grupo Zap-integratie

Stuur Grupo Zap de producten
die het tonen waard zijn

Feedance 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-productfeed
Gegenereerd door Feedance
XML-, CSV- of JSON-exportBijgewerkt bij elke synchronisatie
<item>
  <id>TS-1042</id>
  <title>T-shirt met ronde hals</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>
Feedance-labels, geschreven als custom labels
Wat Feedance naar Grupo Zap verstuurt

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.

Product Scorecustom_label_0Een score van 0 tot 100 op basis van weergaven, toevoegingen aan winkelwagen en aankopen over 1, 7 en 30 dagen.
4T-segmentcustom_label_1Top, Tolerable, Tranquil of Toxic, op basis van het eigen verkeer en rendement van elk product.
Price Warcustom_label_2Goedkoopst, gelijk of duurder dan specifieke concurrenten.
Broken Sizecustom_label_3Markeert modellen waarvan de maatreeks grotendeels is uitverkocht.
Creativesimage_linkAfbeeldingen in je huisstijl uit Creative Suite, met prijs- en campagnegegevens uit de feed.
Zo gebruik je het: splits campagnes, productgroepen of productsets op deze labels, bijvoorbeeld alleen Top-producten, of alles behalve Toxic en gebroken maatreeksen. Labelslots zijn configureerbaar. Feedance wijzigt je biedingen en budgetten niet.

Wat is Grupo ZAP?

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.

Waarom je feed met vastgoedaanbod koppelen aan Grupo ZAP?

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.

VRSync vervangt het oude ZAP-XML-formaat

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.

Welk feedformaat vereist Grupo ZAP?

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:

  1. De user-agent van de crawler toestaan (in de documentatie aangeduid als VivaRealBot/1.0), anders mislukken verzoeken met een HTTP 403
  2. De feed aanbieden via HTTPS met een geldig certificaat dat niet zelfondertekend is, met ondersteuning voor TLS 1.0–1.2
  3. Binnen een verbindingstime-out van 60 seconden reageren en de bestandsoverdracht binnen een downloadvenster van 20 minuten afronden
  4. De feed-URL zelf onder de 255 tekens houden, met correcte URL-encoding en zonder spaties
  5. Tot 100 redirects met hetzelfde protocol ondersteunen als de URL-keten doorverwijst

De officiële XML-validator accepteert bovendien bestanden van maximaal 30 MB en weigert alles wat niet in VRSync-formaat is.

Welke attributen voor vastgoedlistings vereist VRSync?

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

AttribuutElementVereiste
Listing-IDListingIDVerplicht, 1–50 tekens, uniek per object
TitelTitleVerplicht, 10–100 tekens, geen HTML-tags
TransactietypeTransactionTypeVerplicht: For Sale, For Rent of Sale/Rent
Adres / locatieLocation (Country, State, City, Neighborhood, PostalCode)Verplicht; PostalCode verplicht bij alle listings
Foto'sMedia / ItemVerplicht, minimaal 5 afbeeldingen per listing
Contactgegevens makelaarContactInfo (Name, Email)Verplicht
Type vastgoedPropertyTypeVerplicht, moet gestandaardiseerde waarden gebruiken
BeschrijvingDescriptionVerplicht, 50–3.000 tekens, CDATA, geen HTML-tags
WoonoppervlakLivingAreaVerplicht voor de meeste typen vastgoed, unit="square metres"
Slaapkamers / badkamersBedrooms, BathroomsVerplicht voor woningtypen; niet verplicht voor grond of bedrijfshallen
Koop- of huurprijsListPrice / RentalPriceListPrice verplicht voor kooplistings; RentalPrice verplicht voor huurlistings; attribuut currency="BRL" verplicht
PerceeloppervlakLotAreaVerplicht in plaats van LivingArea voor grond, boerderijen en ranches

Zo koppel je Grupo ZAP aan Feedance

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.

  1. Koppel je vastgoedvelden (adres, prijs, slaapkamers, badkamers, oppervlakte, foto's, transactietype) aan de bijbehorende VRSync-elementen
  2. Configureer de vereiste voorwaardelijke logica, bijvoorbeeld LotArea alleen invullen voor grondlistings of RentalPrice alleen voor Rent/Sale-Rent-listings, omdat de verplichte velden van VRSync per type vastgoed verschillen
  3. Publiceer de feed op een stabiele HTTPS-URL die voldoet aan de koppelingseisen van Grupo ZAP (geldig certificaat, user-agent toegestaan, URL onder de 255 tekens)
  4. Registreer die feed-URL bij Grupo ZAP via Canal Pro of je accountvertegenwoordiger, zodat hun crawler hem gaat ophalen
  5. Volg de integratierapporten die Grupo ZAP terugstuurt (volgens de documentatie via Canal Pro, e-mail of webhook) en corrigeer afgewezen listings bij de bron

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.

Hoe vaak moet de feed worden bijgewerkt?

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.

Veelvoorkomende feedfouten

De documentatie en de XML-validator van Grupo ZAP signaleren een aantal terugkerende oorzaken van afgewezen listings:

  1. Bedragen en oppervlaktes opgemaakt met valutasymbolen, scheidingstekens voor duizendtallen of decimalen, bijv. "R$560.000,00" of "32,20", in plaats van gewone gehele getallen
  2. Het ontbreken van het verplichte attribuut currency="BRL" op prijselementen of het attribuut unit="square metres" op oppervlakte-elementen
  3. Lege of ontbrekende Description-elementen (<Description/>), of beschrijvingen buiten het bereik van 50–3.000 tekens
  4. Ontbrekende LivingArea (of LotArea voor grond-/boerderijlistings), wat de validator als harde fout behandelt
  5. HTTP 403-responses omdat de hostingserver de user-agent van de crawler blokkeert
  6. Feed-URL's van meer dan 255 tekens of met niet-gecodeerde tekens/spaties
  7. Bestanden die geen geldige VRSync-XML zijn of de limiet van 30 MB van de validator overschrijden

Optimalisatietips

Algemene praktijken voor feedkwaliteit (geen specifieke claims van Grupo ZAP) die de prestaties van listings op vastgoedportals meestal verbeteren:

  1. Ga verder dan het minimum van 5 afbeeldingen: meer foto's, in een logische volgorde met de buitenkant of de mooiste ruimte eerst, verbeteren doorgaans de betrokkenheid op vastgoedportals
  2. Schrijf volledige, nauwkeurige beschrijvingen die het beschikbare aantal tekens benutten in plaats van het minimum, want een magere beschrijving van 50 tekens converteert waarschijnlijk slecht, ook al komt die door de validatie
  3. Houd prijs- en statusvelden aan jouw kant realtime gesynchroniseerd met je bronsysteem, zodat de volgende crawl altijd actuele data ophaalt in plaats van een verouderde momentopname
  4. Vul waar mogelijk optionele onderscheidende gegevens in (links naar virtuele rondleidingen, exacte breedte- en lengtegraad, details over wijk/zone), zodat kopers de listing kunnen filteren en vinden

Veelgestelde vragen

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.

Over Grupo Zap

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.

Zie welke
producten opbrengen.

Koppel je feed en GA4. We tonen Product Score, 4T, Price War en Broken Size op je eigen catalogus.