Feed Manager: udostępnianie niestandardowych feedów

Oprócz stałych 14 połączeń portalowych może Pan/Pani tworzyć własne feedy. Filtr + jedno lub więcej biur partnerskich = unikalny adres URL dla każdego biura. Przydatne dla współpracujących biur, powiązanych oddziałów lub integracji, które mogą odczytywać feed XML przez adres URL.

Kliknij, aby powiększyć

Feed Manager, wszystkie niestandardowe feedy.

Znajduje się on w Settings → Feed Manager.

Kiedy to stosować?

• Udostępnia Pan/Pani swoją ofertę współpracującemu biuru.
• Dostarcza Pan/Pani feed do zewnętrznej strony internetowej lub integracji.
• Chce Pan/Pani wyświetlić inną selekcję dla każdego biura, na przykład tylko określone lokalizacje, przedziały cenowe lub tagi.

MLS-portale vs Feed Manager

Cecha	Połączenie portalowe MLS	Feed Manager
Cel	Publikowanie na ustalonym portalu nieruchomości	Udostępnianie biurom partnerskim lub niestandardowym systemom
Konfiguracja	Przełącznik na portal	Samodzielne tworzenie feedów z filtrami
Wybór nieruchomości	Wybór portali dla każdej nieruchomości	Poprzez kryteria filtrów
Odbiorcy	Stałe portale	Każde biuro lub system przez URL
URL feeda	Automatycznie na portal	Automatycznie na biuro partnerskie

Notatka

Uzupełnienie bezpośrednich połączeń portalowych, nie zastępuje ich. Proszę używać połączeń portalowych dla Kyero/Idealista/itd., a Feed Manager dla partnerstw i niestandardowych integracji.

---

Tworzenie feeda

1. Proszę otworzyć Feed Manager → kliknąć Add feed.

2. Podstawowe informacje:

   Pole	Wymagane	Opis
   Feed name	Tak	3, 100 znaków, unikalne w ramach Pana/Pani firmy
   Description	Nie	3, 8.000 znaków

3. Kryteria filtrów (sekcja 2. Property filters), panele rozwijane, proszę wypełnić to, co istotne:

   Filtr	Opis
   Relation	Filtr na właściciela/kontakt (multi-select z wyszukiwaniem)
   Location	Wybór miast
   Property type	Multi-select typów nieruchomości
   Bedrooms	Pasek przycisków 1, 6+
   Bathrooms	Pasek przycisków 1, 6+
   Price range	Cena minimalna / maksymalna
   Tags	Wybór hashtagów (multi-select z wyszukiwaniem)

   System zapisuje automatycznie jako filtr dynamiczny.

   Nie trzeba wypełniać wszystkiego

   Brak filtrów = wszystkie nieruchomości w feedzie. Proszę ustawić tylko to, co jest istotne dla biura partnerskiego.

4. Łączenie biur (sekcja 3. Agencies): proszę kliknąć plus-kafelek, wyszukać biuro partnerskie za pomocą Search agencies i kliknąć Attach Agencies. Każde powiązane biuro pojawia się jako własna karta z przełącznikiem Active.

5. Save (Ctrl+S / Cmd+S). Automatyczny status Active.

Link XML istnieje dopiero po Save

Nowo powiązane biuro nie ma jeszcze tokena, a tym samym linka. Tesoro tworzy token dopiero podczas zapisywania. Jeśli nie widzi Pan/Pani jeszcze przycisku Copy XML link, proszę najpierw zapisać, a następnie otworzyć feed ponownie.

---

URL feeda i tokeny

Dla każdego powiązanego biura:

https://[Państwa-domena]/feedmanager/feedmanager/fetch-feed/[feed-id]?token=[unikalny-token]

• URL dostarcza dane nieruchomości jako XML
• Każde biuro ma własny token = śledzenie na biuro
• System rejestruje: request_count (ile razy pobrano) + last_access (ostatni dostęp)

Proszę udostępniać tylko zaufanym partnerom

Za pomocą adresu URL i tokenu każdy może odczytać feed bez logowania.

Link kopiuje Pan/Pani dla każdego biura za pomocą przycisku Copy XML link na karcie tego biura. Przycisk na chwilę zmienia się na Copied!.

---

Wstrzymanie lub zakończenie współpracy

Każde powiązane biuro ma własny przełącznik Active na swojej karcie w sekcji 3. Agencies. Jest to narzędzie do tymczasowego lub definitywnego zakończenia współpracy i prawie zawsze lepszy wybór niż usunięcie biura.

Akcja	Co zauważa biuro	Co dzieje się z linkiem
Wyłączenie Active	Feed działa nadal, ale zawiera zero nieruchomości	Link pozostaje ważny, token istnieje nadal
Usunięcie biura	Link zwraca błąd, że token jest nieprawidłowy	Token znika na stałe

Różnica jest większa niż się wydaje. Jeśli ustawi Pan/Pani biuro na nieaktywne, ich system nadal otrzymuje prawidłowy plik XML, tyle że bez nieruchomości. Ich import nie blokuje się na błędzie, ogłoszenia po prostu znikają. Jeśli usunie Pan/Pani biuro, ich połączenie się zrywa.

Reaktywacja przywraca ten sam link

Jeśli później ponownie ustawi Pan/Pani biuro na Active, oryginalny token pozostaje zachowany, podobnie jak liczniki request_count i last_access. Biuro nie musi nic zmieniać, ich istniejący URL znów działa. Dlatego przy wznowieniu współpracy nie musi Pan/Pani wysyłać nowego linka.

Tesoro nadal zlicza dostęp, dopóki link jest wywoływany, nawet jeśli biuro jest nieaktywne. Po last_access może Pan/Pani sprawdzić, czy zdezaktywowane biuro nadal odpyta Pana/Pani feed.

---

Zarządzanie feedami

Tabela przeglądowa

Kolumna	Opis
Feed name	Nazwa feeda
Properties	Liczba nieruchomości spełniających kryteria filtrów
Agencies	Liczba powiązanych biur partnerskich
Last update	Data ostatniej modyfikacji
Status	Active lub Offline

Stronicowanie: 10, 20, 30, 40 lub 50 na stronę.

Edytowanie

W kolumnie Actions znajdują się dwie ikony: ołówek i kosz. Proszę kliknąć ołówek → panel boczny otworzy się z bieżącymi wartościami → zmienić → Save.

Usuwanie

Proszę kliknąć kosz → potwierdzenie. URL-e przestają natychmiast działać.

Najpierw odłącz biura

Nie można usunąć feeda, który ma powiązane biura. Tesoro zgłosi wtedy: “Remove all agencies from the feed before deleting it”. Proszę najpierw odłączyć biura lub ustawić je na nieaktywne, jeśli chce Pan/Pani tylko wstrzymać współpracę.

Definitywnie

Biura partnerskie korzystające z tego feeda nie otrzymają już danych. Proszę skomunikować się z nimi przed usunięciem.

---

Status: Active lub Offline

Status	Opis
Active	Dostarcza dane przez URL
Offline	Dezaktywowany, nie dostarcza nic

Proszę zmienić przez Edit. Offline zachowuje feed, ale nic nie dostarcza, przydatne do tymczasowej pauzy bez usuwania.

---

Kryteria filtrów są dynamiczne

Filtry są zapisywane jako filtr dynamiczny i ponownie stosowane przy każdym żądaniu URL feeda.

Oznacza to automatyczne aktualizacje, gdy:

• Nowa nieruchomość spełnia kryteria
• Istniejąca nieruchomość zmienia się, przez co jest/nie jest w zakresie
• Nieruchomość zostanie usunięta

Nie trzeba ręcznie odświeżać

Portfel zmienia się → feed dostosowuje się automatycznie przy następnym odczycie.

---

Kwalifikujące się statusy

Nieruchomość pojawia się w feedzie Feed Managera, jeśli:

1. Spełnia filtr
2. Display on Website włączone
3. Display on Feed włączone (domyślnie wyłączone, należy jawnie włączyć)
4. Status na liście: Pending Approval, Active, Sold, Rented, Under Offer, Off Market, Negotiating, Under Contract, Open House, Key Ready, Under Construction, Removed by Feed
5. Walidacja zgodna z Kyero zakończona sukcesem

---

Częste błędy

Feed pokazuje 0 nieruchomości

1. Filtr zbyt wąski?
2. Display on Website i Display on Feed włączone?
3. Status na liście kwalifikujących się statusów?
4. Walidacja Kyero zakończona sukcesem (referencja, cena, typ, miasto, prowincja, sypialnie, łazienki, opis, ≥1 zdjęcie)?

Biuro skarży się, że nie otrzymuje danych

1. Czy biuro samo jest jeszcze ustawione na Active w sekcji 3. Agencies? To najczęstsza przyczyna. Biuro na nieaktywne otrzymuje prawidłowy feed bez nieruchomości, więc nie widzi komunikatu błędu, tylko pusty plik.
2. Status feeda = Active?
3. URL + token nadal ważne (biuro nie usunięte)?
4. Wynik filtru = niepusty?

---

Powiązane

Przegląd portali MLSRóżnica między połączeniami portalowymi a Feed Managerem.

Łączenie portaliPodłączanie Kyero, Idealista, Fotocasa i 12 innych portali.

Publikowanie ofertPrzypisywanie portali do nieruchomości + Kyero Prime.