NowośćProduct Score, 4T Segmentation, Price War i Broken Size są już dostępne.Zobacz, co nowego
Feedance
Logo Grupo ZapGrupo ZapKanał · Marketplace’y i aplikacje
Integracja z Grupo Zap

Wyślij do Grupo Zap produkty
warte pokazania

Feedance tworzy twój feed dla Grupo Zap i dodaje etykiety na poziomie produktu: wynik, segment 4T, pozycję cenową i niepełną rozmiarówkę, dzięki czemu każdy produkt niesie własny sygnał efektywności.

Feed produktowy dla Grupo Zap
Wygenerowany przez Feedance
Eksport XML, CSV lub JSONAktualizowany przy każdej synchronizacji
<item>
  <id>TS-1042</id>
  <title>T-shirt z okrągłym dekoltem</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>
Etykiety Feedance zapisane jako custom labels
Co Feedance wysyła do Grupo Zap

Katalog z sygnałem efektywności przy każdym produkcie

Grupo Zap odczytuje twoje produkty z feedu. Feedance wysyła kompletny, poprawny feed oraz sygnały, do których Grupo Zap nie ma samodzielnie dostępu.

Product Scorecustom_label_0Wynik od 0 do 100 na podstawie wyświetleń, dodań do koszyka i zakupów z 1, 7 i 30 dni.
Segment 4Tcustom_label_1Top, Tolerable, Tranquil lub Toxic, na podstawie ruchu i zwrotu każdego produktu.
Price Warcustom_label_2Najlepsza cena, taka sama lub drożej niż wskazani konkurenci.
Broken Sizecustom_label_3Oznacza modele, których rozmiarówka jest w większości wyprzedana.
Kreacjeimage_linkBrandowane grafiki z Creative Suite, z ceną i szczegółami kampanii pobranymi z feedu.
Jak z tego korzystasz: dziel kampanie, grupy produktów lub zestawy produktów według tych etykiet, np. tylko produkty Top albo wszystko poza Toxic i niepełnymi rozmiarówkami. Sloty etykiet można konfigurować. Feedance nie zmienia twoich stawek ani budżetów.

Czym jest Grupo ZAP?

Grupo ZAP to dział nieruchomości OLX Group w Brazylii, który prowadzi dwa największe w kraju portale z ofertami nieruchomości: ZAP Imóveis i Viva Real. Agencje nieruchomości, pośrednicy i dostawcy systemów CRM podłączają swoją ofertę nieruchomości do Grupo ZAP, aby ogłoszenia sprzedaży i wynajmu pojawiały się na obu portalach – a w zależności od wykupionego planu także w ogłoszeniach OLX – na podstawie jednego feedu danych, zamiast ręcznego wprowadzania na każdym portalu.

Dlaczego warto połączyć feed z ofertami nieruchomości z Grupo ZAP?

Zamiast przepisywać tę samą ofertę osobno do ZAP Imóveis, Viva Real i OLX, pośrednik lub agent korzysta z systemu zarządzania nieruchomościami, który generuje jeden ustandaryzowany plik XML, a roboty Grupo ZAP pobierają go według stałego harmonogramu. Każda zmiana wprowadzona raz w systemie źródłowym – nowa cena, zaktualizowany zestaw zdjęć, oferta oznaczona jako sprzedana lub wynajęta – automatycznie trafia przy następnym pobraniu do wszystkich podłączonych portali. To główny powód, dla którego agencje automatyzują ten proces, zamiast ręcznie zarządzać panelem każdego portalu.

VRSync zastępuje starszy format ZAP XML

Dokumentacja dla deweloperów Grupo ZAP wymienia dwa obsługiwane schematy XML: starszy format „ZAP”, który wprost opisuje jako utrzymywany wyłącznie w trybie konserwacji, oraz VRSync – obecny standard, który „obejmuje wszystkie nowe funkcje”. Dokumentacja podaje, że feedy w formacie innym niż VRSync były wycofywane, a narzędzie Grupo ZAP do walidacji XML akceptuje wyłącznie pliki w formacie VRSync. Każda nowa integracja – w tym zbudowana za pomocą narzędzia do zarządzania feedami – powinna korzystać z VRSync, a nie ze starszego formatu.

Jakiego formatu feedu wymaga Grupo ZAP?

Grupo ZAP pobiera oferty w architekturze opartej na odpytywaniu: nie przyjmuje przesyłanych plików, tylko okresowo pobiera plik XML w formacie VRSync z podanego przez ciebie adresu URL. Zgodnie z oficjalnym Guia de Conexão (przewodnikiem po połączeniu) serwer udostępniający plik musi spełniać kilka konkretnych wymagań technicznych:

  1. Zezwalać na User-Agenta robota (w dokumentacji określonego jako VivaRealBot/1.0), w przeciwnym razie zapytania zakończą się błędem HTTP 403
  2. Udostępniać feed przez HTTPS z ważnym certyfikatem, który nie jest samopodpisany, z obsługą TLS 1.0–1.2
  3. Odpowiadać w ciągu 60 sekund (limit czasu połączenia) i kończyć transfer pliku w ciągu 20 minut (okno pobierania)
  4. Utrzymywać długość samego adresu URL feedu poniżej 255 znaków, z prawidłowym kodowaniem URL i bez niezakodowanych spacji
  5. Obsługiwać do 100 przekierowań w obrębie tego samego protokołu, jeśli adres URL przekierowuje

Oficjalny XML Validator dodatkowo ogranicza rozmiar akceptowanych plików do 30 MB i odrzuca wszystko, co nie jest sformatowane jako VRSync.

Jakich atrybutów ofert nieruchomości wymaga VRSync?

Schemat VRSync jest podzielony na blok Listing i zagnieżdżony blok Details. Na podstawie dokumentacji elementów Grupo ZAP następujące elementy są wymagane (lub warunkowo wymagane w zależności od typu nieruchomości):

AtrybutElementWymaganie
Identyfikator ofertyListingIDWymagany, 1–50 znaków, unikalny dla każdej nieruchomości
TytułTitleWymagany, 10–100 znaków, bez tagów HTML
Typ transakcjiTransactionTypeWymagany: For Sale, For Rent lub Sale/Rent
Adres / lokalizacjaLocation (Country, State, City, Neighborhood, PostalCode)Wymagany; PostalCode obowiązkowy we wszystkich ofertach
ZdjęciaMedia / ItemWymagane, co najmniej 5 zdjęć na ofertę
Kontakt do pośrednikaContactInfo (Name, Email)Wymagany
Typ nieruchomościPropertyTypeWymagany, należy używać ustandaryzowanych wartości
OpisDescriptionWymagany, 50–3000 znaków, CDATA, bez tagów HTML
Powierzchnia użytkowaLivingAreaWymagana dla większości typów nieruchomości, unit="square metres"
Sypialnie / łazienkiBedrooms, BathroomsWymagane dla typów mieszkalnych; niewymagane dla działek i magazynów
Cena sprzedaży lub najmuListPrice / RentalPriceListPrice wymagana w ofertach sprzedaży; RentalPrice wymagana w ofertach najmu; wymagany atrybut currency="BRL"
Powierzchnia działkiLotAreaWymagana zamiast LivingArea dla działek, gospodarstw rolnych i rancz

Jak połączyć Grupo ZAP z Feedance

Feedance może generować i hostować plik XML w formacie VRSync, który pobiera robot Grupo ZAP, mapując rekordy nieruchomości z twojego systemu źródłowego (CRM, ERP lub arkusza kalkulacyjnego) na strukturę Header, Listing i Details wymaganą przez standard.

  1. Zmapuj pola danych nieruchomości (adres, cena, sypialnie, łazienki, powierzchnia, zdjęcia, typ transakcji) na odpowiadające im elementy VRSync
  2. Skonfiguruj wymaganą logikę warunkową – np. uzupełniaj LotArea tylko dla ofert działek, a RentalPrice tylko dla ofert najmu/sprzedaży i najmu – ponieważ pola wymagane w VRSync zależą od typu nieruchomości
  3. Opublikuj feed pod stałym adresem URL HTTPS, który spełnia wymagania połączenia Grupo ZAP (ważny certyfikat, dozwolony User-Agent, adres URL krótszy niż 255 znaków)
  4. Zarejestruj ten adres URL feedu w Grupo ZAP przez Canal Pro lub u swojego opiekuna konta, aby robot zaczął go odpytywać
  5. Monitoruj raporty integracji, które Grupo ZAP odsyła (według dokumentacji przez Canal Pro, e-mail lub webhook), i poprawiaj odrzucone oferty u źródła

Ponieważ jest to wyspecjalizowany, mocno zagnieżdżony schemat dla rynku nieruchomości, a nie płaski katalog produktów, przygotuj się na więcej pracy przy początkowym mapowaniu pól niż w przypadku standardowego feedu zakupowego e-commerce.

Jak często powinien aktualizować się feed?

Dokumentacja Grupo ZAP podaje, że pliki XML są przetwarzane dwa razy dziennie, w odstępach mniej więcej 12-godzinnych – to pobieranie przez robota, a nie przesyłanie, więc generowanie feedu częściej niż ten cykl nie przynosi korzyści. Liczy się to, by feed odzwierciedlał aktualny stan (cenę, dostępność, status sprzedanej/wynajętej nieruchomości) przed każdym oknem pobierania, ponieważ nieaktualny feed będzie utrzymywał w ofercie niedostępną nieruchomość lub niezsynchronizowaną zmianę ceny aż do kolejnego pobrania po 12 godzinach.

Typowe błędy feedu

Dokumentacja Grupo ZAP i jej XML Validator wskazują kilka powtarzających się przyczyn odrzucania ofert:

  1. Wartości pieniężne i powierzchnie zapisane z symbolami walut, separatorami tysięcy lub częściami dziesiętnymi – np. „R$560.000,00” lub „32,20” – zamiast zwykłych liczb całkowitych
  2. Brak wymaganego atrybutu currency="BRL" w elementach cen lub atrybutu unit="square metres" w elementach powierzchni
  3. Puste lub brakujące elementy Description (<Description/>) albo opisy spoza zakresu 50–3000 znaków
  4. Brak LivingArea (lub LotArea w ofertach działek/gospodarstw rolnych), który walidator traktuje jako błąd krytyczny
  5. Odpowiedzi HTTP 403, ponieważ serwer hostingowy blokuje User-Agenta robota
  6. Adresy URL feedu dłuższe niż 255 znaków lub zawierające niezakodowane znaki/spacje
  7. Pliki, które nie są prawidłowym XML w formacie VRSync lub przekraczają limit walidatora wynoszący 30 MB

Wskazówki dotyczące optymalizacji

Ogólne praktyki dotyczące jakości feedu (a nie twierdzenia specyficzne dla Grupo ZAP), które zwykle poprawiają skuteczność ofert na portalach nieruchomości:

  1. Wychodź poza minimum 5 zdjęć – więcej zdjęć, ułożonych w logicznej kolejności, z widokiem z zewnątrz lub najlepszym pomieszczeniem na początku, zwykle zwiększa zaangażowanie na portalach ogłoszeniowych
  2. Pisz kompletne, dokładne opisy, wykorzystujące pełny dostępny limit znaków, a nie minimum, ponieważ ubogi, 50-znakowy opis raczej nie będzie dobrze konwertował, nawet jeśli przejdzie walidację
  3. Synchronizuj po swojej stronie pola ceny i statusu z systemem źródłowym w czasie rzeczywistym, aby przy kolejnym pobraniu robot zawsze otrzymywał aktualne dane, a nie nieaktualny stan
  4. Uzupełniaj opcjonalne elementy wyróżniające, jeśli są dostępne (linki do wirtualnych spacerów, dokładna szerokość/długość geograficzna, szczegóły dzielnicy/strefy), aby pomóc kupującym w filtrowaniu i znalezieniu oferty

FAQ

Czy Feedance obsługuje właśnie format VRSync? Feedance może generować feedy XML zmapowane na strukturę elementów VRSync zdefiniowaną w dokumentacji Grupo ZAP; starszy format ZAP jest przestarzały i nie należy go używać w nowych integracjach.

Czy mogę wysyłać ten sam feed do ZAP Imóveis, Viva Real i OLX? Materiały Grupo ZAP opisują jeden feed XML dystrybuowany do portali objętych wykupionym planem, bez konieczności tworzenia osobnych feedów dla każdego portalu.

Skąd będę wiedzieć, że oferta została odrzucona? Grupo ZAP podaje, że wysyła raporty integracji, a w przypadku błędów utrzymujących się dłużej niż trzy dni – bezpośrednie powiadomienia e-mail ze szczegółami tego, co się nie powiodło.

Czy to ten sam rodzaj feedu co feed produktowy Google Merchant Center lub Meta? Nie – VRSync to schemat przeznaczony dla rynku nieruchomości, z zagnieżdżonymi strukturami Location, Media, ContactInfo i Details oraz polami wymaganymi zależnymi od typu nieruchomości, co strukturalnie różni się od płaskiego feedu produktowego e-commerce, choć cel (jeden feed źródłowy, wiele miejsc docelowych) jest podobny.

O Grupo Zap

Grupo ZAP to biznes nieruchomościowy OLX Group w Brazylii. Prowadzi dwa z największych portali nieruchomości w kraju, ZAP Imóveis i Viva Real, na których ludzie szukają domów, mieszkań i nieruchomości komercyjnych do kupna lub wynajmu.

Agencje nieruchomości, pośrednicy i dostawcy oprogramowania dla branży nieruchomości wysyłają swoje oferty do Grupo ZAP, aby nieruchomości pojawiały się na obu portalach, a w zależności od wykupionego planu także w ogłoszeniach OLX. Jedno źródło danych zastępuje ręczne wprowadzanie tej samej oferty w panelu każdego portalu.

Oferty są dostarczane jako feed XML w formacie VRSync, który Grupo ZAP wskazuje jako swój obecny standard; starszy format ZAP XML jest w trybie utrzymania. Grupo ZAP nie przyjmuje przesyłanych plików. Jego crawler regularnie pobiera feed z adresu URL HTTPS, więc serwer musi dopuszczać crawlera, szybko odpowiadać i niezawodnie udostępniać plik.

Dla agencji jakość feedu wpływa na skuteczność ofert. Poprawne ceny, adresy, typy nieruchomości, powierzchnie, liczba pokoi i udogodnienia pomagają ofertom pojawiać się we właściwych wyszukiwaniach, dobre zdjęcia przyciągają więcej zapytań, a szybkie usuwanie sprzedanych lub wynajętych nieruchomości utrzymuje wiarygodność portfela ofert i zapobiega marnowaniu leadów.

Zobacz, które
produkty zarabiają.

Połącz swój feed i GA4. Pokażemy Product Score, 4T, Price War i Broken Size na twoim własnym katalogu.