Promovări și boost

Acest capitol descrie integrarea tehnică pentru promovări și boost-uri prin API.

Pentru explicația business despre campanii, ordinea de afișare, limite și consumul de boost, vezi Cum funcționează promovarea pe IMOPEDIA.

Operații și câmpuri

Boost-ul se aplică unei oferte existente prin operația SOAP saveBoost. Operația crește prioritatea ofertei conform regulilor de promovare disponibile pentru agenție, fără să schimbe structura payload-ului principal al proprietății.

Operația identifică agenția și oferta prin:

Câmp Rol
agencyId ID-ul agenției pentru care se face promovarea.
offerId ID_LOCAL al ofertei care trebuie promovată.

Oferta trebuie să existe înainte de a fi boostată. Publicarea sau actualizarea ofertei se face separat, prin saveProperty.

Identificarea ofertei

offerId nu este property_id intern returnat de saveProperty. Pentru saveBoost, trimite întotdeauna ID_LOCAL ca offerId. Serverul caută oferta după combinația agencyId + offerId, echivalentă cu identificatorul public de tip {AGENTIA}RUN{ID_LOCAL}.

Exemplu: dacă oferta a fost trimisă prin saveProperty cu AGENTIA = 123 și ID_LOCAL = 67654, apelul de boost folosește agencyId = 123 și offerId = 67654, chiar dacă răspunsul saveProperty conține și un property_id intern diferit.

Verificarea limitelor

Înainte de saveBoost, poți folosi viewAgency pentru a verifica valorile boostAllocated, boostConsumed și boostAvailable. Dacă boostAvailable este 0, saveBoost poate returna _isValid = false cu eroare de business de tipul Agency does not have enough boosts.

Pentru promovarea GOLD, cererea se trimite prin saveProperty cu GOLD = 1. saveBoost nu schimbă nivelul campaniei; el ridică prioritatea ofertei în nivelul în care se află deja.

Serverul verifică limitele disponibile pentru agenție și returnează eroare dacă limita este depășită. Tratează acest răspuns ca refuz funcțional al promovării, nu ca eroare de conectivitate. Din punct de vedere business, trecerea în Gold consumă atât o poziție Gold, cât și un boost; vezi explicația despre campanii și limite.

Recomandări de integrare

Pentru lista operațiilor disponibile, vezi Operații API.