Dziennik zmian ofert (offer-events) — co sprzedawca z tego ma
Co rejestruje Allegro w offer-events, jak SalesAmplifier zapisuje zdarzenia i jak łączyć je ze spadkami sprzedaży.
Gdy sprzedaż na ofercie spada, pierwsze pytanie brzmi: co się zmieniło? Raport XLSX pokazuje efekt (sprzedaż, wizyty), ale nie zawsze widać w nim moment edycji ceny, tytułu czy zakończenia oferty. Do tego służy endpoint Allegro GET /sale/offer-events — dziennik zdarzeń na ofertach Twojego konta.
Co rejestruje Allegro
Offer-events to strumień zdarzeń po stronie Allegro (m.in. edycje oferty, zmiany statusu, zakończenie sprzedaży). API zwraca zdarzenia z ostatnich około 24 godzin — to okno Allegro, nie ograniczenie SalesAmplifier. Dłuższą historię budujesz przez regularną synchronizację (co 3 h) i zachowanie wcześniejszych zdarzeń w bazie.
Co widzisz w aplikacji
Po połączeniu konta (read-only OAuth):
- Worker pobiera offer-events z kursorem — wznawia od ostatniego punktu.
- Zdarzenia trafiają do widoku Zdarzenia zmian ofert (
/offer-events). - Na szczegółach oferty widać historię zmian obok metryk sprzedaży i wizyt.
API nie podaje par „stara wartość → nowa wartość” w samym zdarzeniu. Gdy to możliwe, SalesAmplifier wnioskuje diff z wcześniejszych snapshotów oferty — na liście zdarzeń i w szczegółach oferty. Gdy brak punktu odniesienia, zamiast zgadywania pokazujemy —.
Jak to łączyć ze sprzedażą
Typowy workflow:
- Zauważ spadek wizyt lub sprzedaży w raporcie lub na wykresie Live (API).
- Otwórz offer-events w tym samym okresie — czy była zmiana ceny, statusu lub zakończenie?
- Jeśli liczby XLSX i API się rozjeżdżają, sprawdź uzgadnianie źródeł zamiast zakładać błąd synchronizacji.
Offer-events opisują skutek po stronie Allegro. Kto i dlaczego kliknął „zapisz” w Sales Center — to w przyszłości koreluje rozszerzenie przeglądarki (read-only); API nie zastępuje intencji sprzedawcy.
Zakres i bezpieczeństwo
- Integracja jest tylko do odczytu — nie edytujemy ofert ani kampanii.
- Dane dotyczą Twojego konta sprzedawcy po OAuth — nie scrapujemy cudzych listingów.
- Ads i wizyty nadal pochodzą głównie z XLSX — offer-events uzupełnia obraz o zmiany ofert.