NeuProduct Score, 4T Segmentation, Price War und Broken Size sind live.Neuigkeiten ansehen
Feedance
Grupo Zap LogoGrupo ZapKanal · Marktplätze und Apps
Grupo Zap-Integration

Senden Sie Grupo Zap die Produkte,
die es wert sind

Feedance erstellt Ihren Grupo Zap-Feed und ergänzt Labels auf Produktebene für Score, 4T-Segment, Preisposition und unvollständige Größen, sodass jedes Produkt sein eigenes Performance-Signal trägt.

Grupo Zap-Produkt-Feed
Erstellt von Feedance
XML-, CSV- oder JSON-ExportBei jeder Synchronisierung aktualisiert
<item>
  <id>TS-1042</id>
  <title>T-Shirt mit Rundhalsausschnitt</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, als Custom Labels geschrieben
Was Feedance an Grupo Zap sendet

Ein Katalog mit einem Performance-Signal für jedes Produkt

Grupo Zap liest Ihre Produkte aus dem Feed. Feedance sendet einen vollständigen, gültigen Feed sowie die Signale, über die Grupo Zap selbst nicht verfügt.

Product Scorecustom_label_0Ein Score von 0 bis 100 aus Aufrufen, Warenkorbaktionen und Käufen über 1, 7 und 30 Tage.
4T-Segmentcustom_label_1Top, Tolerable, Tranquil oder Toxic, basierend auf Traffic und Ertrag jedes einzelnen Produkts.
Price Warcustom_label_2Günstigster, gleicher oder höherer Preis als bei benannten Wettbewerbern.
Broken Sizecustom_label_3Markiert Modelle, deren Größenlauf größtenteils ausverkauft ist.
Creativesimage_linkGebrandete Bilder aus der Creative Suite, mit Preis- und Kampagnendetails aus dem Feed.
So nutzen Sie es: Teilen Sie Kampagnen, Produktgruppen oder Produktsets nach diesen Labels auf, zum Beispiel nur Top-Produkte oder alles außer Toxic und unvollständigen Größenläufen. Label-Slots sind konfigurierbar. Feedance ändert weder Ihre Gebote noch Ihre Budgets.

Was ist Grupo ZAP?

Grupo ZAP ist die Immobiliensparte der OLX Group in Brasilien und betreibt die beiden größten Immobilienportale des Landes: ZAP Imóveis und Viva Real. Immobilienagenturen, Makler und CRM-Anbieter verbinden ihren Immobilienbestand mit Grupo ZAP, damit Kauf- und Mietangebote auf beiden Portalen erscheinen – und je nach vertraglich vereinbartem Tarif auch auf den OLX-Kleinanzeigen –, und zwar aus einem einzigen Daten-Feed statt durch manuelle Eingabe pro Portal.

Warum sollten Sie Ihren Immobilien-Feed mit Grupo ZAP verbinden?

Statt dass ein Makler dasselbe Angebot separat in ZAP Imóveis, Viva Real und OLX eintippt, erzeugt das Immobilienverwaltungssystem eine einzige standardisierte XML-Datei, die die Crawler von Grupo ZAP nach einem festen Zeitplan abrufen. Jede Änderung, die einmal im Quellsystem vorgenommen wird – ein neuer Preis, aktualisierte Fotos, ein als verkauft oder vermietet markiertes Objekt –, wird beim nächsten Crawl automatisch auf alle verbundenen Portale übertragen. Das ist der Hauptgrund, warum Agenturen diesen Prozess automatisieren, statt das Backoffice jedes Portals von Hand zu pflegen.

VRSync ersetzt das alte ZAP-XML-Format

Die Entwicklerdokumentation von Grupo ZAP nennt zwei unterstützte XML-Schemata: das alte „ZAP“-Format, das ausdrücklich als im Wartungsmodus befindlich beschrieben wird, und VRSync, den aktuellen Standard, der „alle neuen Funktionen enthält“. Laut Dokumentation werden Feeds, die nicht im VRSync-Format vorliegen, schrittweise abgeschafft, und das XML-Validierungstool von Grupo ZAP akzeptiert nur Dateien im VRSync-Format. Jede neue Integration – auch eine mit einem Feed-Management-Tool – sollte daher VRSync statt des älteren Formats verwenden.

Welches Feed-Format verlangt Grupo ZAP?

Grupo ZAP übernimmt Angebote über eine Polling-Architektur: Es akzeptiert keine aktiv übertragenen Uploads, sondern lädt regelmäßig eine VRSync-XML-Datei von einer von Ihnen angegebenen URL herunter. Laut dem offiziellen Guia de Conexão (Verbindungsleitfaden) muss der bereitstellende Server mehrere konkrete technische Anforderungen erfüllen:

  1. Den User Agent des Crawlers zulassen (in der Dokumentation als VivaRealBot/1.0 angegeben), da Anfragen sonst mit HTTP 403 fehlschlagen
  2. Den Feed über HTTPS mit einem gültigen, nicht selbst signierten Zertifikat bereitstellen und TLS 1.0–1.2 unterstützen
  3. Innerhalb eines Verbindungs-Timeouts von 60 Sekunden antworten und die Dateiübertragung innerhalb eines Download-Fensters von 20 Minuten abschließen
  4. Die Feed-URL selbst unter 255 Zeichen halten, korrekt URL-kodiert und ohne unkodierte Leerzeichen
  5. Bis zu 100 Weiterleitungen mit demselben Protokoll unterstützen, falls die URL-Kette weiterleitet

Der offizielle XML Validator begrenzt akzeptierte Dateien zusätzlich auf 30 MB und lehnt alles ab, was nicht im VRSync-Format vorliegt.

Welche Attribute für Immobilienangebote verlangt VRSync?

Das VRSync-Schema ist in einen Listing-Block und einen darin verschachtelten Details-Block gegliedert. Laut der Elementreferenz von Grupo ZAP sind die folgenden Elemente als erforderlich (oder je nach Objektart bedingt erforderlich) dokumentiert:

AttributElementAnforderung
Angebots-IDListingIDPflicht, 1–50 Zeichen, eindeutig pro Objekt
TitelTitlePflicht, 10–100 Zeichen, keine HTML-Tags
TransaktionsartTransactionTypePflicht: For Sale, For Rent oder Sale/Rent
Adresse / LageLocation (Country, State, City, Neighborhood, PostalCode)Pflicht; PostalCode ist bei allen Angeboten verpflichtend
FotosMedia / ItemPflicht, mindestens 5 Bilder pro Angebot
Kontakt des MaklersContactInfo (Name, Email)Pflicht
ObjektartPropertyTypePflicht, muss standardisierte Werte verwenden
BeschreibungDescriptionPflicht, 50–3.000 Zeichen, CDATA, keine HTML-Tags
WohnflächeLivingAreaPflicht für die meisten Objektarten, unit="square metres"
Schlafzimmer / BadezimmerBedrooms, BathroomsPflicht für Wohnimmobilien; nicht erforderlich für Grundstücke oder Lagerhallen
Kauf- oder MietpreisListPrice / RentalPriceListPrice ist für Verkaufsangebote Pflicht, RentalPrice für Mietangebote; das Attribut currency="BRL" ist erforderlich
GrundstücksflächeLotAreaPflicht anstelle von LivingArea bei Grundstücken, Höfen und Farmen

So verbinden Sie Grupo ZAP mit Feedance

Feedance kann die VRSync-XML-Datei erzeugen und hosten, die der Crawler von Grupo ZAP abruft, und dabei die Objektdatensätze aus Ihrem Quellsystem (CRM, ERP oder Tabelle) in die vom Standard geforderte Struktur aus Header, Listing und Details überführen.

  1. Ordnen Sie Ihre Objektdatenfelder (Adresse, Preis, Schlafzimmer, Badezimmer, Fläche, Fotos, Transaktionsart) den entsprechenden VRSync-Elementen zu
  2. Konfigurieren Sie die erforderliche Bedingungslogik – zum Beispiel LotArea nur bei Grundstücksangeboten zu befüllen oder RentalPrice nur bei Miet- bzw. Kauf-/Miet-Angeboten –, da die Pflichtfelder von VRSync je nach Objektart variieren
  3. Veröffentlichen Sie den Feed unter einer stabilen HTTPS-URL, die die Verbindungsanforderungen von Grupo ZAP erfüllt (gültiges Zertifikat, zugelassener User Agent, URL unter 255 Zeichen)
  4. Registrieren Sie diese Feed-URL über Canal Pro oder Ihren Ansprechpartner bei Grupo ZAP, damit deren Crawler mit dem Abruf beginnt
  5. Überwachen Sie die Integrationsberichte, die Grupo ZAP zurücksendet (laut Dokumentation über Canal Pro, per E-Mail oder Webhook), und korrigieren Sie abgelehnte Angebote an der Quelle

Da es sich um ein spezialisiertes, tief verschachteltes Immobilienschema handelt und nicht um einen flachen Produktkatalog, sollten Sie mit mehr Aufwand für die anfängliche Feldzuordnung rechnen als bei einem üblichen E-Commerce-Shopping-Feed.

Wie oft sollte der Feed aktualisiert werden?

Laut der Dokumentation von Grupo ZAP werden XML-Dateien zweimal täglich verarbeitet, im Abstand von etwa 12 Stunden – es handelt sich um einen crawlbasierten Abruf und keine aktive Übertragung, daher bringt es nichts, den Feed häufiger als in diesem Zyklus neu zu erzeugen. Entscheidend ist, dass der Feed vor jedem Crawl-Fenster den aktuellen Stand (Preis, Verfügbarkeit, Status verkauft/vermietet) widerspiegelt, denn ein veralteter Feed hält ein nicht mehr verfügbares Objekt gelistet oder lässt einen aktualisierten Preis bis zum nächsten 12-Stunden-Abruf unsynchronisiert.

Häufige Feed-Fehler

Die Dokumentation von Grupo ZAP und der XML Validator nennen mehrere wiederkehrende Ursachen für abgelehnte Angebote:

  1. Geld- und Flächenwerte mit Währungssymbolen, Tausendertrennzeichen oder Dezimalstellen – z. B. „R$560.000,00“ oder „32,20“ – statt einfacher Ganzzahlen
  2. Fehlendes Pflichtattribut currency="BRL" bei Preiselementen oder fehlendes Attribut unit="square metres" bei Flächenelementen
  3. Leere oder fehlende Description-Elemente (<Description/>) oder Beschreibungen außerhalb des Bereichs von 50–3.000 Zeichen
  4. Fehlende LivingArea (bzw. LotArea bei Grundstücks- oder Hofangeboten), die der Validator als schwerwiegenden Fehler behandelt
  5. HTTP-403-Antworten, weil der Hosting-Server den User Agent des Crawlers blockiert
  6. Feed-URLs, die länger als 255 Zeichen sind oder unkodierte Zeichen bzw. Leerzeichen enthalten
  7. Dateien, die kein gültiges VRSync-XML sind oder die Validator-Grenze von 30 MB überschreiten

Tipps zur Optimierung

Allgemeine Praktiken für die Feed-Qualität (keine spezifischen Aussagen von Grupo ZAP), die die Leistung von Angeboten auf Immobilienportalen in der Regel verbessern:

  1. Gehen Sie über das Minimum von 5 Bildern hinaus – mehr Fotos in einer logischen Reihenfolge, beginnend mit der Außenansicht oder dem schönsten Raum, verbessern auf Immobilienportalen in der Regel das Engagement
  2. Verfassen Sie vollständige, korrekte Beschreibungen, die den verfügbaren Zeichenumfang ausschöpfen statt nur das Minimum, denn eine dünne Beschreibung mit 50 Zeichen konvertiert kaum gut, selbst wenn sie die Validierung besteht
  3. Halten Sie Preis- und Statusfelder auf Ihrer Seite in Echtzeit mit Ihrem Quellsystem synchron, damit der nächste Crawl immer aktuelle Daten abruft und keinen veralteten Stand
  4. Füllen Sie optionale Unterscheidungsmerkmale aus, sofern verfügbar (Links zu virtuellen Rundgängen, genaue Breiten-/Längengrade, Angaben zu Viertel oder Zone), damit Käufer das Angebot filtern und finden können

FAQ

Unterstützt Feedance speziell das VRSync-Format? Feedance kann XML-Feeds erzeugen, die der in der Dokumentation von Grupo ZAP definierten VRSync-Elementstruktur zugeordnet sind; das alte ZAP-Format ist veraltet und sollte für neue Integrationen nicht verwendet werden.

Kann ich denselben Feed an ZAP Imóveis, Viva Real und OLX senden? Laut den Materialien von Grupo ZAP wird ein einziger XML-Feed an die Portale verteilt, die in Ihrem vertraglich vereinbarten Tarif enthalten sind, statt separate Feeds pro Portal zu verlangen.

Woran erkenne ich, ob ein Angebot abgelehnt wurde? Laut Grupo ZAP werden Integrationsberichte versandt und bei Fehlern, die länger als drei Tage bestehen, direkte E-Mail-Benachrichtigungen mit Details zum Fehler.

Ist das die gleiche Art von Feed wie ein Produktfeed für Google Merchant Center oder Meta? Nein – VRSync ist ein immobilienspezifisches Schema mit verschachtelten Strukturen für Location, Media, ContactInfo und Details sowie Pflichtfeldern, die von der Objektart abhängen. Strukturell unterscheidet es sich damit von einem flachen E-Commerce-Produktfeed, auch wenn das zugrunde liegende Ziel (ein Quell-Feed, mehrere Ziele) ähnlich ist.

Über Grupo Zap

Grupo ZAP ist das Immobiliengeschäft der OLX Group in Brasilien. Das Unternehmen betreibt zwei der größten Immobilienportale des Landes, ZAP Imóveis und Viva Real, auf denen Menschen nach Häusern, Wohnungen und Gewerbeimmobilien zum Kauf oder zur Miete suchen.

Immobilienagenturen, Makler und Anbieter von Immobiliensoftware senden ihre Angebote an Grupo ZAP, damit die Objekte auf beiden Portalen und, je nach gebuchtem Paket, auch in den Kleinanzeigen von OLX erscheinen. Eine einzige Datenquelle ersetzt die manuelle Eingabe desselben Angebots im Backoffice jedes Portals.

Angebote werden als XML-Feed im VRSync-Format geliefert, das Grupo ZAP als aktuellen Standard nennt; das ältere ZAP-XML-Format befindet sich im Wartungsmodus. Grupo ZAP akzeptiert keine aktiv übertragenen Uploads. Der Crawler lädt den Feed regelmäßig von einer HTTPS-URL herunter, daher muss der Server den Crawler zulassen, schnell antworten und die Datei zuverlässig ausliefern.

Für Agenturen beeinflusst die Feed-Qualität, wie gut die Angebote abschneiden. Korrekte Preise, Adressen, Objektarten, Flächen, Zimmeranzahlen und Ausstattungsmerkmale helfen dabei, dass Angebote in den richtigen Suchen erscheinen, gute Fotos sorgen für mehr Anfragen, und das zeitnahe Entfernen verkaufter oder vermieteter Objekte hält das Portfolio vertrauenswürdig und vermeidet verschwendete Leads.

Sehen Sie, welche
Produkte Umsatz bringen.

Verbinden Sie Ihren Feed und GA4. Wir zeigen Product Score, 4T, Price War und Broken Size für Ihren eigenen Katalog.