Oblíbené produkty a porovnávání zboží na e-shopu — jak se stav ukládá přihlášenému i nepřihlášenému zákazníkovi, jak souvisí se souhlasy a jak data dostat do e-mailingu.

Zákazník, který si produkt uloží mezi oblíbené nebo ho zařadí do porovnání, o sobě řekl víc než libovolný proklik. Revelor tyhle signály nejen ukládá — dává je k dispozici doporučování i vašemu e-mailingu.

Dvě samostatné funkce

Oblíbené (wishlist) — zákazník si odkládá produkty, ke kterým se chce vrátit.

Porovnání — zákazník staví vedle sebe zboží, mezi kterým se rozhoduje.

Obě funkce se zapínají samostatně pro každý e-shop. Dokud nejsou zapnuté, na e-shopu se nijak neprojeví a rozhraní na ně nereaguje.

Jak to vypadá na e-shopu

Oblíbené se zákazníkovi nabízejí všude, kde se s produktem potkává: srdíčko na kartě produktu ve výsledcích vyhledávání, v našeptávači i v doporučovacích blocích, tlačítko na detailu produktu a badge s počtem uložených položek v hlavičce e-shopu. Kompletní přehled má zákazník na samostatné stránce /oblibene/.

Porovnání funguje obdobně: tlačítko na kartách produktů, lišta s vybranými produkty přichycená u spodní hrany obrazovky a stránka /porovnani/ s porovnávací tabulkou seskupenou podle kategorií.

Ikony patří vaší šabloně. Srdce i symbol porovnání se při instalaci kreslí na míru podle nativních ikon vašeho e-shopu — sedí tloušťka linky, zaoblení i barva. Obě funkce dědí CSS šablony, takže působí jako její přirozená součást, ne jako doplněk třetí strany.

Kde se stav ukládá

Situace zákazníka	Kde stav žije	Co z toho plyne
Přihlášený	Na straně Reveloru, navázaný na účet zákazníka v e-shopu	Seznam mu zůstává mezi návštěvami a je dostupný odkudkoli, kde se přihlásí
Nepřihlášený	Vázáno na identitu návštěvníka v prohlížeči (technická cookie)	Seznam přežije zavření prohlížeče, ale je vázaný na dané zařízení

Zákazník je vždy identifikovaný jen svým identifikátorem účtu v e-shopu. Žádné osobní údaje — jméno, e-mail, adresa — se v oblíbených ani v porovnání neukládají.

Souhlasy

Akce na e-shopu se řídí souhlasem návštěvníka. Bez uděleného souhlasu Revelor trvalou identitu nezakládá, takže se stav neváže na návštěvníka napříč návštěvami. Do exportů pro externí nástroje (viz níže) vstupují výhradně záznamy s plným souhlasem.

Jak se chová porovnání

Porovnání se drží po kategoriích. Pro jednoho zákazníka tedy nevzniká jeden slepenec všeho, ale samostatné skupiny — sluchátka vedle sluchátek, židle vedle židlí. Kategorie se u produktu určuje z produktového feedu e-shopu.

Kolik produktů se v jedné kategorii vedle sebe zobrazí, je nastavitelné.

Limity

Funkce	Limit na jednoho zákazníka
Oblíbené	500 produktů
Porovnání	200 produktů

Při dosažení limitu se další produkt už nepřidá.

Co se s daty dál děje

Doporučování. Oblíbené a porovnávané produkty jsou plnohodnotný signál o zájmu zákazníka a vstupují do jeho profilu — projeví se tedy v tom, co mu Revelor doporučí. Viz kapitola Doporučování produktů.

Události pro analytiku. Každé přidání i odebrání se zaznamenává jako událost, u které je rozlišené, jestli vznikla přímo na e-shopu, nebo přes napojený externí nástroj.

Export dat pro e-mailing a další nástroje

Oblíbené a porovnání se dají číst přes veřejné API Reveloru — typicky proto, aby na ně navázala e-mailingová kampaň. Připravená je integrace s partnerskou platformou Boldem.

Co export umí:

Oblíbené vrací dvojice zákazník + produkt včetně základních dat o produktu (název, cena, měna, kategorie, odkaz) a času uložení.
Porovnání vrací skupiny zákazník + kategorie se seznamem porovnávaných produktů — tedy „kdo co zvažuje".
Přírůstkové čtení. Parametr času a stránkovací kurzor umožňují stahovat jen to, co přibylo od posledního běhu.
Bez třicetidenního omezení. Na rozdíl od záznamů vyhledávání jde o stav, ne o log — export tedy není omezený retencí dat.
Souhlas a opt-in. Export musí být pro daný e-shop výslovně povolený a vstupují do něj jen záznamy s plným souhlasem zákazníka. Jinak API export odmítne.
Bez osobních údajů. Vrací se identifikátor zákaznického účtu, ne kontaktní údaje — jejich spárování je na straně vašeho e-mailingového nástroje.

curl -H "Authorization: Bearer rvlr_xxx…" \
  "https://<vas-server>/v1/favorites?since=2026-07-01T00:00:00Z&limit=500"

{
  "items": [
    {
      "customer_id": "<id-zakaznika>",
      "product_guid": "<guid-produktu>",
      "product": {
        "name": "Název produktu",
        "price": 4990.0,
        "currency": "CZK",
        "category": "Židle",
        "url": "https://…"
      },
      "created_at": "2026-07-03T10:00:00+00:00"
    }
  ],
  "next_cursor": "…",
  "count": 500
}

Přístup je řízený oprávněními (scopes) přiděleným API klíčem — zvlášť pro čtení oblíbených a zvlášť pro čtení porovnání. Na všechny klíče platí limit 60 požadavků za minutu.

Zápis zpět: uzavřený okruh s e-mailingem

Veřejné API umí oblíbené a porovnání nejen číst, ale i zapisovat. Tím se okruh uzavírá:

Zákazník si na e-shopu uloží produkt mezi oblíbené.
Partnerský nástroj si data přečte a odešle kampaň.
Zákazník si přímo z e-mailu přidá další produkt — a ten se zapíše zpátky do Reveloru.
Nově zapsaná data znovu vstoupí do doporučování.

Zápisy jsou idempotentní — opakované přidání už uloženého produktu nic nerozbije, stejně jako odebrání něčeho, co v seznamu není. U každé zapsané položky zůstává zaznamenané, že vznikla přes partnera, ne přímo na e-shopu.

Pro zápis stačí, aby byla funkce na e-shopu zapnutá; povolení exportu se u zápisu nevyžaduje (to řídí pouze čtení dat ven). Právním základem zápisu z kampaně je souhlas, který drží partnerská platforma.

Kompletní popis endpointů, oprávnění a chybových stavů najdete v kapitole o veřejném API.