Promovări și boost

Acest capitol descrie conceptele publice pentru campanii, promovări și boost-uri. Regulile exacte disponibile pentru o agenție depind de configurarea contractuală și pot fi verificate cu echipa Imopedia.

Niveluri de vizibilitate

Ofertele publicate pot avea niveluri diferite de vizibilitate în site.

Nivel	Rol
STANDARD	Publicarea obișnuită a unei oferte în listing.
GOLD	Nivel de promovare superior, disponibil în limita configurată pentru agenție.

Nivelurile speciale sau pozițiile fixe pot necesita configurări separate și nu sunt recomandate ca presupuneri în integrarea API.

Boost

Un boost este o operație de promovare aplicată unei oferte existente. Boost-ul crește prioritatea ofertei în grupa ei de vizibilitate, fără să schimbe structura payload-ului principal al proprietății.

Pentru boost se folosește operația SOAP saveBoost. 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.

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

Î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, oferta poate fi trimisă și prin saveProperty cu GOLD = 1. Serverul verifică limita disponibilă pentru agenție și returnează eroare dacă limita este depășită.

Limite la nivel de agenție

Fiecare agenție poate avea limite configurate pentru publicare și promovare. În funcție de pachetul activ, aceste limite pot include:

• numărul maxim de anunțuri publicate;
• numărul de oferte care pot fi promovate ca GOLD;
• numărul de boost-uri disponibile într-o perioadă de utilizare.

Dacă o operație de promovare depășește limita disponibilă, API-ul poate refuza operația. Integratorul trebuie să trateze acest caz ca o regulă de business: oferta rămâne publicată, dar promovarea solicitată nu este aplicată.

Recomandări de integrare

• Creează sau actualizează oferta prin saveProperty înainte de a apela saveBoost.
• Folosește agencyId = AGENTIA și offerId = ID_LOCAL pentru saveBoost.
• Tratează răspunsurile de refuz la boost ca situații funcționale, nu ca erori de conectivitate.
• Nu presupune că toate agențiile au aceleași limite sau aceleași niveluri de promovare.

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