Dokumentacja API

Pytania i odpowiedzi

Cross-selling i up-selling w e-commerce: najczęstsze pytania

Krótko o tym, czym jest crosello.io, jak działają rekomendacje cross-sell i up-sell oraz jak podłączyć sklep.

crosello.io w skrócie

Czym jest
Silnik rekomendacji produktowych cross-sell i up-sell dostępny przez API.
Dla kogo
Dla dostawców platform marketing automation i ich klientów — sklepów internetowych.
Dane wejściowe
Feed produktowy sklepu w formacie CSV (wymagane: ID i nazwa produktu).
Wynik
Dla każdego produktu dwie listy: cross-sell (akcesoria i materiały eksploatacyjne) oraz up-sell (droższe zamienniki i produkty używane razem).
Integracja
API HTTP/JSON z kluczem API, bez limitu zapytań.
Czas przygotowania list
Zwykle 10–40 minut od wgrania feedu; potem odpowiedzi API są serwowane bez opóźnienia.
Cena
Już od 1 zł miesięcznie za 1000 produktów; ostateczna cena zależy od wielkości katalogu i długości umowy.
Koszt na tle agenta AI
Ok. 19× taniej niż dopasowanie tych samych 5000 produktów przez agenta AI (zmierzony koszt tokenów).
Dostępność
Usługa dostępna przez API; wtyczki dla WooCommerce, PrestaShop, Shopify i IdoSell są planowane.

Czym jest crosello.io?

crosello.io to silnik rekomendacji produktowych dostępny przez API. Na podstawie feedu produktowego sklepu dobiera do każdego produktu dwie listy: cross-sell (akcesoria i materiały eksploatacyjne, które do niego pasują) oraz up-sell (droższe zamienniki i produkty używane razem). Dopasowania wynikają z analizy relacji między produktami w asortymencie sklepu, a nie z ręcznie ustawianych reguł.

Czym różni się cross-selling od up-sellingu w e-commerce?

Cross-selling (sprzedaż krzyżowa) to proponowanie produktów uzupełniających do tego, co klient ogląda lub kupuje, np. tonera do drukarki, filtra do ekspresu albo etui do smartfona. Up-selling to proponowanie droższej wersji tego samego rodzaju produktu lub produktu używanego razem z nim. Oba działania zwiększają wartość zamówienia: cross-sell dokłada do koszyka coś nowego, a up-sell podnosi poziom tego, co klient już rozważa.

W crosello.io odpowiadają im listy cross_sell i upsell. Lista up-sell zawiera droższe zamienniki (cena ×1,1–1,8 względem produktu) oraz produkty używane razem.

Jak działa silnik rekomendacji crosello.io?

Wgrywasz feed produktowy (CSV). crosello.io analizuje asortyment: buduje macierz relacji między kategoriami, odczytuje karty produktów (marka, seria, model, system) i dla każdego produktu liczy listy cross-sell i up-sell. Modele językowe pracują jednorazowo przy analizie feedu, a listy są liczone raz na przebieg i serwowane przez API bez opóźnienia — odpowiedź nie wymaga wywołania modelu przy każdym zapytaniu.

Jakich danych potrzebuje crosello.io i jak długo trwa przetwarzanie feedu?

Wystarczy plik CSV z katalogiem produktów. Wymagane są ID i nazwa produktu; zalecane: kategorie, marka, opis, specyfikacja, cena i stan magazynowy. Kolumny są rozpoznawane automatycznie. Przetwarzanie feedu trwa zwykle od 10 do 40 minut, po czym listy są dostępne przez API.

Jak pobrać rekomendacje cross-sell i up-sell przez API?

Wysyłasz ID produktu albo kilku produktów (np. ostatnich zakupów klienta) i dostajesz listy cross_sell oraz upsell. Każda pozycja ma relację (np. accessory_for, consumable_for, substitute_of) i dowód dopasowania (evidence). Żądania uwierzytelnia klucz API; zapytania nie są limitowane.

POST /v1/feeds/{feed_id}/recommendations
{"product_ids": ["4411", "4418", "2203"]}

Z jakimi platformami marketing automation i sklepami działa crosello.io?

crosello.io jest przeznaczony dla dostawców usług marketing automation i ich klientów — sklepów internetowych. Integracja polega na wywołaniu API (HTTP, JSON) z ID produktów oglądanych lub kupionych przez klienta; zwrócone produkty platforma wstawia do e-maila lub newslettera. Wtyczki dla WooCommerce, PrestaShop, Shopify i IdoSell są planowane, ale jeszcze niedostępne.

Ile kosztuje crosello.io?

Cena zależy od wielkości katalogu i długości umowy. Już od 1 zł miesięcznie za 1000 produktów (zwykle 1–2 zł), bez limitu zapytań do API. Dla sklepu z 5000 produktów to od 5 zł miesięcznie.

Czym crosello.io różni się od dopasowywania produktów przez agenta AI?

Agent AI, który analizuje tysiące opisów produktów, zużywa ogromną liczbę tokenów. Dla katalogu 5000 produktów zmierzony koszt tokenów agenta AI (Claude Opus 5.5 przez API, ustawienie medium) wyniósł 97 zł, a crosello.io kosztuje od 5 zł miesięcznie — ok. 19× taniej — i nie limituje zapytań do API.

Listy są wyliczane raz i serwowane z gotowych danych, więc odpowiedzi API nie zależą od czasu pracy modelu.

Czy rekomendacje opierają się na zachowaniu klientów?

O dopasowaniu decyduje relacja między produktami: zgodność, funkcja i potrzeba, a nie to, co kupili inni klienci. Historia zakupów i przeglądania jest dodatkowym sygnałem: zapytanie może zawierać przeglądane kategorie (viewed_categories), które podnoszą pozycje z tych kategorii (wynik ×1,5), a ID kupionych produktów (product_ids) są źródłem rekomendacji.

Dla jakich sklepów i branż nadaje się crosello.io?

Dla katalogów, w których produkty łączą relacje zgodności: akcesoria do urządzeń, materiały eksploatacyjne i produkty używane razem — np. elektronika użytkowa, AGD i RTV, akcesoria do smartfonów, sprzęt kawowy czy drukarki z tonerami. Silnik nie ma wbudowanej wiedzy o żadnej branży; kontekst sklepu powstaje z jego feedu.

Jak zacząć i sprawdzić crosello.io na własnym katalogu?

Użyj przycisku „Dodaj feed i sprawdź”: założysz konto w panelu, wgrasz plik CSV z katalogiem i zobaczysz listy cross-sell i up-sell dla swoich produktów. Dokumentacja API opisuje klucze, endpointy i przykłady zapytań. Pytania o integrację, cennik i współpracę inwestycyjną możesz wysłać przez formularz kontaktowy.

Nie znalazłeś odpowiedzi?

Sprawdź crosello.io na własnym katalogu albo napisz do nas — odpowiemy na pytania o integrację, cennik i współpracę.

Słownik: cross-selling, up-selling i rekomendacje produktowe

Pojęcia z e-commerce i marketing automation używane w crosello.io.

Cross-selling (sprzedaż krzyżowa)

Także: cross-sell, cross sell

Technika sprzedaży polegająca na proponowaniu klientowi dodatkowego produktu lub usługi, które uzupełniają to, co ogląda lub kupuje — np. etui do smartfona, filtr do ekspresu czy toner do drukarki. W e-commerce rekomendacje cross-sell pojawiają się w karcie produktu, w koszyku, w e-mailach po zakupie i w newsletterach. Wikipedia (EN)
Up-selling

Także: upselling, up-sell, upsell

Technika sprzedaży polegająca na proponowaniu droższej lub lepiej wyposażonej wersji produktu, który klient rozważa. W crosello.io lista up-sell zawiera droższe zamienniki tego samego rodzaju (cena ×1,1–1,8) oraz produkty używane razem. Wikipedia (EN)
Silnik rekomendacji produktowych

Także: system rekomendacyjny, recommendation engine, recommender system

Oprogramowanie, które dobiera produkty do pokazania klientowi na podstawie danych o produktach, klientach albo o obu. crosello.io opiera się na relacjach między produktami (zgodność, funkcja, potrzeba), a nie na zachowaniu innych klientów. Wikipedia (EN)
Feed produktowy

Także: product feed, plik z katalogiem produktów

Plik z katalogiem produktów sklepu: ID, nazwa, kategorie, marka, opis, specyfikacja, cena, stan magazynowy. crosello.io przyjmuje feed w formacie CSV i na jego podstawie analizuje asortyment. Wikipedia (EN)
Marketing automation

Także: automatyzacja marketingu

Automatyzacja działań marketingowych: wysyłka e-maili, SMS-ów i powiadomień wyzwalanych zachowaniem klienta, np. zakupem, porzuconym koszykiem albo obejrzanym produktem. Platforma marketing automation może pobierać z API crosello.io produkty do wstawienia w wiadomość. Wikipedia (EN)
API rekomendacji

Także: recommendation API

Interfejs (HTTP, JSON), przez który zewnętrzny system wysyła ID produktów i dostaje listy rekomendacji. W crosello.io: zapytanie GET dla jednego produktu albo POST dla zestawu produktów, np. ostatnich zakupów klienta. Wikipedia (EN)
Relacje między produktami

Także: accessory_for, consumable_for, complementary_to, substitute_of

crosello.io rozróżnia cztery relacje: accessory_for (akcesorium do urządzenia), consumable_for (materiał eksploatacyjny), complementary_to (produkty używane razem) i substitute_of (zamiennik tego samego rodzaju). Dwie pierwsze tworzą listę cross-sell, dwie ostatnie — listę up-sell.
Dowód dopasowania (evidence)

Także: evidence, pewność dopasowania

Pole przy każdej rekomendacji: confirmed (zgodność potwierdzona na kartach produktów), probable (prawdopodobna), category (z kategorii, bez deklaracji zgodności na karcie), similarity (podobieństwo opisu) albo weak (słaba).
Średnia wartość zamówienia (AOV)

Także: average order value

Przychód podzielony przez liczbę zamówień. Cross-selling i up-selling należą do najczęstszych sposobów jej zwiększania.
Model językowy (LLM)

Także: large language model, agent AI

Model sztucznej inteligencji rozumiejący i generujący tekst, używany m.in. do analizy opisów produktów. W crosello.io modele językowe pracują jednorazowo przy analizie feedu; odpowiedzi API nie wymagają wywołania modelu.