RECENZIA / NOVÉ RECENZE
Čeká na schválení
„Vše proběhlo rychle a bez komplikací. Doporučuji.“
UKÁZKAPOZITIVNÍČEKÁ NA VÁS Schválit a publikovat →
Integrace
Jak připojit Upgates krok za krokem
Postup pro majitele e-shopu i kodéra. Co si připravit v Upgates, co Recenzia načte a jak widgety nasadit nejdřív na testovací verzi.
- Recenze a katalog z Upgates
- Objednávky pro žádosti o recenzi
- Jeden instalační skript
- Testovací režim před spuštěním
Tok recenzí
Aktivní napojení
Co zvládne Upgates sám a kdy se napojení vyplatí
Stav k 30. 9. 2026 podle nápovědy Upgates.
- Upgates má vlastní hodnocení a recenze produktů: zákazník, který nakoupil, ohodnotí produkt hvězdičkami a napíše krátkou recenzi.
- Hodnocení obchodu jako celku Upgates nemá a recenze jsou společné pro všechny jazykové mutace.
- Napojení Recenzie se vyplatí, když chcete u produktů i recenze z Heureky a Zboží.cz, hodnocení obchodu na webu nebo recenze přeložené pro každou mutaci.
- Recenze, které v Upgates už máte, Recenzia načte. Z Upgates jen čte, nic v něm nepřepisuje.
Než začnete: jeden recenzní modul, ne dva
Dva moduly vedle sebe ukazují různá čísla a zákazníka matou.
- Projděte, co recenze na e-shopu kreslí dnes: recenze Upgates, starší blok Heureky v šabloně nebo jiný doplněk.
- Blok, který čte uloženou kopii exportu z Heureky, se sám neaktualizuje. Po nasazení widgetu ho ze šablony odstraňte.
- Recenze u produktu z Recenzie nahradí na detailu původní sekci recenzí Upgates, takže se nezdvojí.
Krok 1: API přístup a úplný export produktů
Recenzia potřebuje z Upgates čtyři údaje. Recenze dodá API, katalog dodá export produktů.
- Vytvořte API přístup V administraci Upgates otevřete Doplňky, API a tlačítkem + Nový založte samostatný přístup, třeba s názvem Recenzia.cz. Recenzia z Upgates jen čte: recenze, produkty a objednávky. Přístupu proto nechte čtení, zápis není potřeba.
- Opište API URL, LOGIN a API KEY API URL najdete pod tabulkou přístupů, vložte ji celou včetně /api/v2. LOGIN a API KEY jsou v řádku vašeho přístupu. Nejde o e-mail a heslo do administrace.
- Zkopírujte adresu úplného exportu produktů V Upgates ji najdete v Doplňky, Upgates XML, Produktový XML export. Adresa má tvar …/export-full-products-….xml.
- Vložte údaje do Recenzie V administraci Recenzie otevřete Zdroje a publikace, na kartě Upgates klikněte na Připojit, vyplňte všechny čtyři údaje a uložte. První import spustíte na kartě zdroje tlačítkem Spustit hned, dál běží sám podle plánu.
Nepoužívejte feed pro Heureku, Zboží.cz ani Google. Nese jen část katalogu a widget pak na ostatních produktech nemá co ukázat. Feed pro Heureku Recenzia pozná a upozorní vás, feed pro Google Merchant odmítne.
Krok 2: objednávky a žádosti o recenzi
Objednávky slouží k ověření nákupu a k žádostem o recenzi.
- Ve stejném okně nechte zapnuté Stahovat objednávky. Recenzia jednou denně stáhne nové a změněné objednávky a použije z nich číslo, e-mail a stav.
- Žádosti o recenzi po objednávce jsou od tarifu Starter. Spouštěč je expedice objednávky (výchozí), její doručení, nebo vytvoření. Výchozí odeslání je 24 hodin po expedici. Stavy Doručeno, Vyřízeno a Převzato se berou jako doručení.
- Připomínka je od tarifu Růst. Ve výchozím nastavení jedna, 3 dny po žádosti.
- Objednávkám starším než 30 dní se žádost neposílá.
- Upgates posílá vlastní e-mail s hodnocením. Rozhodněte, kdo bude zákazníka žádat, ať nedostane žádost dvakrát.
- Od tarifu Starter umí Recenzia posílat dokončené objednávky i do Ověřeno zákazníky na Heurece. Podmínky Heureky najdete v postupu napojení Heureky.
Krok 3: jeden instalační skript
Widgety na Upgates nevkládáte po jednom. Stačí jeden řádek.
- Zkopírujte skript V administraci Recenzie otevřete Widgety, část Instalace, a zkopírujte řádek se skriptem.
- Vložte ho v Upgates V administraci Upgates otevřete Doplňky, Vlastní konverzní kódy a řádek vložte na konec pole „Kód před </body>“. Uložte.
- Počkejte na první návštěvu Jakmile na e-shop přijde první návštěvník, skript se ohlásí a instalace se v Recenzii přepne na „běží“. Obvykle do deseti minut.
Kde se widgety zobrazí samy
Skript pozná typ stránky a widgety umístí podle něj.
- Hodnocení e-shopu: nad patičkou na úvodní stránce.
- Recenze u produktu: na detailu produktu místo původní sekce recenzí Upgates.
- Plovoucí hodnocení a Vyskakující recenze: napříč webem, pokud je zapnete.
- Hvězdičky u ceny a Krátká recenze u tlačítka Koupit: na místě, které vyberete při založení widgetu.
Testovací režim a přepnutí naostro
Widgety si nejdřív prohlédnete jen vy.
- Zapněte testovací režim V části Instalace zapněte volbu Zobrazovat widgety jen na testovací doméně a vyplňte doménu testovací verze e-shopu, například vas-shop.s15.upgates.shop.
- Dolaďte vzhled Widgety uvidíte jen na testovací doméně. Na ostrém e-shopu se nezobrazí nic.
- Přepněte naostro Volbu vypněte a uložte. Widgety se na celém e-shopu objeví asi do 10 minut.
Testovací režim nezapomeňte vypnout. Dokud je zapnutý, zákazníci na ostrém e-shopu widgety nevidí. Máte-li vlastní doménu pro každou jazykovou verzi, vypište testovací domény oddělené čárkou. Po změně domény e-shopu zkontrolujte doménu v Nastavení e-shopu a testovací doménu.
Varianty, vzorky a jazykové mutace
Jak se recenze chovají u variant, vzorků a jazykových verzí.
- Varianty jedné karty v Upgates mají společné ID produktu. Recenzia ho čte z úplného exportu i ze stránky produktu, takže sdílejí recenze samy.
- Kde ID v katalogu chybí, páruje se podle kódu: varianta s číselnou příponou (P00072-1) k základnímu produktu (P00072), pokud je jednoznačný. Přípona s písmeny (P00072-XL) se takto nespáruje.
- Vzorek a plné balení jsou v katalogu dva produkty. V detailu produktu je propojíte ručně a pak sdílejí recenze.
- Skript pozná jazyk stránky a widget ukáže recenze v jazyce mutace. Překlady zapnete v sekci Překlady.
Kontrola po spuštění
Pět věcí, které si projděte první den.
- Skript je vložený na ostré doméně a testovací režim je vypnutý.
- Na detailu produktu, který recenze má, je widget ukazuje. Zkuste i variantu.
- V katalogu Recenzie jsou všechny produkty, ne jen část.
- Zdroj Upgates nemá v Historii spuštění chybu.
- V přehledu e-shopu není upozornění „Widget se ptá na produkty, které Recenzia nezná“.
Připojení Upgates: nejčastější dotazy
Export produktů, práva přístupu, objednávky a prázdný widget.
Proč úplný export produktů, a ne feed pro Heureku?
Podle exportu se recenze přiřazují ke konkrétním produktům přes kód produktu. Feed pro srovnávač obsahuje jen část katalogu, takže widget na ostatních produktech nemá co ukázat.
Jaká práva má mít API přístup?
Stačí čtení. Recenzia z Upgates čte recenze, produkty a objednávky a nic do něj nezapisuje.
Co dělá stahování objednávek?
Recenzia z objednávky použije číslo, e-mail a stav. Slouží k ověření nákupu a od tarifu Starter k žádostem o recenzi po objednávce.
Widget na detailu produktu je prázdný. Co s tím?
Nejčastěji produkt chybí v katalogu, protože je ve zdroji feed pro srovnávač místo úplného exportu. Druhá příčina je katalog bez ID produktu z Upgates: pak se nespáruje varianta s písmeny v příponě kódu.
Widgety nejsou na ostrém e-shopu vidět. Proč?
Zkontrolujte, že je skript vložený ve Vlastních konverzních kódech a že je vypnutý testovací režim. Změna se projeví asi do 10 minut.
Je dostupný i export recenzí do Upgates?
Ne, export recenzí zpět do Upgates zatím v administraci není dostupný. Recenze si můžete jednorázově stáhnout do CSV.
Z blogu