Katalog i rekomendacje
Merchant używa OpenApp jako spersonalizowanego silnika rekomendacji. Integracja płatności ani checkoutu nie jest wymagana. Merchant udostępnia OpenApp swój katalog produktów i historię zamówień, a następnie pobiera z OpenApp spersonalizowane rekomendacje produktów do wyświetlania użytkownikom.
Wymagane endpointy
| Endpoint | Kierunek | Cel |
|---|---|---|
| Pobieranie katalogu | OpenApp → Merchant | OpenApp synchronizuje katalog produktów; id wariantów muszą być spójne we wszystkich API |
| Feed zamówień | Merchant → OpenApp | Przesyłanie historii zamówień (uzupełnienie co najmniej 12 miesięcy) i bieżących zamówień, aby silnik mógł nauczyć się wzorców zakupowych |
| Rekomendacje użytkownika | Merchant → OpenApp | Pobieranie spersonalizowanych rekomendacji produktów dla użytkownika; zwraca trzy listy: top picks, replenishment i discovery |
Opcjonalne endpointy
| Endpoint | Kierunek | Cel |
|---|---|---|
| Feed wishlisty | Merchant → OpenApp | Snapshot produktów zapisanych przez użytkownika; poprawia jakość rekomendacji dla użytkowników, którzy jeszcze nie kupili |
Uwagi
ID produktów - id wariantu z katalogu to klucz łączący wszystkie dane rekomendacji. Ten sam id wariantu musi pojawiać się w feedzie zamówień i feedzie wishlisty; OpenApp zwraca ten sam id w odpowiedziach z rekomendacjami, dzięki czemu merchant może dodać rekomendowane produkty do koszyka bez żadnego mapowania.
Identyfikatory użytkowników - pole loggedUser w feedzie zamówień i feedzie wishlisty to własny stabilny identyfikator użytkownika po stronie merchanta. OpenApp nie powiązuje go z żadnym kontem OpenApp.
Początkowe uzupełnienie danych - przed uruchomieniem prześlij co najmniej ostatnie 12 miesięcy historii zamówień przez feed zamówień, aby zapewnić silnikowi wystarczający sygnał. Uzupełnianie i bieżące przesyłanie używają tego samego endpointu. Ponowne wysłanie orderId zastępuje zapisane zamówienie, więc częściowo odrzucone zamówienia można wysłać ponownie bez efektów ubocznych.
Opóźnienie przetwarzania - po początkowym pobraniu katalogu OpenApp potrzebuje czasu na przetworzenie danych, zanim przesyłanie zamówień i pobieranie rekomendacji staną się dostępne. Do zakończenia przetwarzania oba endpointy odpowiadają 409 RecommendationsNotReadyException. Przed rozpoczęciem uzupełniania zamówień należy poczekać na potwierdzenie od OpenApp.
Anulowania - aby usunąć zamówienie z silnika, prześlij je ponownie z status: CANCELLED. Produkty nieznane z katalogu w momencie przesyłania są zwracane w ignoredProducts. Wyślij zamówienie ponownie po następnej synchronizacji katalogu, aby je uwzględnić.