Přeskočit na obsah
Nápověda Zdroje recenzí Aktualizováno

Zdroje recenzí: jak připojit Heureku, Zboží.cz a Upgates

Recenzia stahuje recenze z Heureky, ze Zboží.cz a z Upgates, umí je nahrát z CSV a sbírá je vlastním formulářem. Tady je, co ke každému zdroji potřebujete a kde to najdete.

Postup krok za krokem

Co budete potřebovat

  • Vytvořený e-shop.
  • Přístupové údaje k externí službě podle zdroje (přehled níže).
  1. Otevřete v e-shopu Zdroje a publikace. Na kartě zdroje klikněte na „Připojit“. Otevře se okno s poli pro daný zdroj.
  2. Vyplňte údaje podle zdroje a uložte. Stručný přehled:
    • Heureka: tajný klíč služby Ověřeno zákazníky (32 znaků) z administrace Heureky. Pro Heureka.cz a Heureka.sk je klíč zvlášť, vyplňte ten, kde působíte. Import recenzí obchodu je zapnutý hned, import recenzí produktů zapnete zaškrtnutím v témže okně.
    • Zboží.cz (Seznam): ID provozovny z Centra prodejce a klíč API Fénix ze Skliku (Nastavení → Správa klíčů API Fénix). Pro čtení recenzí stačí oprávnění „r“, pro odesílání odpovědí na recenze zpět na Zboží.cz nastavte „rw“.
    • Upgates: adresa úplného exportu produktů (tvar …/export-full-products-….xml) a přístup k API (API URL, LOGIN a API KEY). Export naplní katalog produktů, API dodá recenze. Bez obou částí zůstane zdroj neaktivní. Nepoužívejte feed pro Heureku nebo Google, obsahuje jen část katalogu. Víc v tématu „Jak Recenzia páruje recenze s produkty“. Objednávky pro ověřený nákup a žádosti o recenzi stahuje přepínač Stahovat objednávky ve stejném okně. Ve výchozím stavu je zapnutý.
    • WooCommerce: URL e-shopu (https://…), Consumer key (ck_…) a Consumer secret (cs_…) z WP admin → WooCommerce → Nastavení → Pokročilé → REST API. Stačí oprávnění Read.
    • Shoptet: widget Recenzie vložíte do šablony e-shopu. Přímý import recenzí, katalogu a objednávek ze Shoptetu zatím není dostupný. Recenze z Heureky připojíte přes zdroj Heureka.
    • CSV: jednorázové nahrání vlastního souboru. Povinný je jediný sloupec rating (hodnocení 1–5, volitelně škála 1–10). Volitelné sloupce: author, email, text, order_id, review_type, product_item_id, product_name a date. Bez hlavičky musí být sloupce právě v tomto pořadí. S hlavičkou import přečte i product_url (adresa produktu), pros, cons a external_id. S číslem objednávky (order_id) se recenze spáruje s objednávkou, bez něj zůstane neověřená.
  3. Spusťte první import přímo z karty zdroje tlačítkem „Spustit hned“ a počkejte na dokončení. Stav najdete v sekci „Historie spuštění“ ve spodní části stránky.
  4. V seznamu recenzí (Denní práce → Recenze) ověřte počet, hodnocení a párování na produkty. Nespárované recenze najdete v sekci Diagnostika párování na konci stránky Zdroje a publikace.
  5. Další importy běží automaticky. Jak často, určuje tarif: Free jednou denně, Starter dvakrát denně, Růst šestkrát denně, Profi každou hodinu. Ručně import spustíte v okně zdroje: na kartě klikněte na „Nastavení“ a pak na „Spustit import“.

Kde to v aplikaci najdete: Tok dat → Zdroje a publikace Denní práce → Přehled e-shopu

Časté chyby

  • Klíč přestal platit a nikdo si toho nevšiml. Sledujte chybové stavy v Historii spuštění a zapněte si upozornění (Nastavení → Notifikace).
  • Heureka: do pole patří tajný klíč Ověřeno zákazníky, ne adresa XML feedu. Adresu exportu si Recenzia sestaví z klíče sama.
  • Zboží.cz: klíč vytvořený v účtu Skliku, do kterého jste jen přepnutí z jiného profilu. Správa klíčů API Fénix se v takovém režimu nezobrazí. Přihlaste se přímo svým účtem.
  • WooCommerce: klíč s oprávněním Write nebo Admin. Pro import recenzí stačí Read.
  • Shoptet: čekání na přímý import. Dnes recenze z Heureky připojíte přes zdroj Heureka.
  • Nespárované produktové recenze zůstávají bez produktu. Jednou týdně je projděte v sekci Diagnostika párování.

Import nefunguje nebo se nespustil

Úloha nezačala, neimportovala očekávaná data, nebo vrátila chybu.

  1. Je zdroj v e-shopu aktivní?

    Otevřete detail zdroje. Neaktivní zdroje se samy neimportují.

    Kde to v aplikaci najdete: Tok dat → Zdroje a publikace

  2. Vrátil poslední běh chybu?

    Historie spuštění ukazuje stav a chybovou hlášku. Nejčastěji přestal platit klíč, nebo se změnila adresa feedu.

    Kde to v aplikaci najdete: Tok dat → Zdroje a publikace

  3. Sedí přístupové údaje?

    Heureka: tajný klíč Ověřeno zákazníky. Zboží.cz: ID provozovny a klíč API Fénix. Upgates: adresu exportu produktů otevřete v prohlížeči, musí se načíst XML.

    Kde to v aplikaci najdete: Tok dat → Zdroje a publikace

Časté otázky

Na co se k tomuhle tématu ptáte

Jaký klíč z Heureky Recenzia potřebuje?

Tajný klíč služby Ověřeno zákazníky, má 32 znaků. Najdete ho v administraci Heureky v části Ověřeno zákazníky. Pro Heureka.cz a Heureka.sk je klíč zvlášť.

Kde vznikne klíč pro Zboží.cz?

Ve Skliku, ne v Centru prodejce: Nastavení → Správa klíčů API Fénix. Pro stahování recenzí stačí oprávnění „r“, pro odesílání odpovědí na recenze nastavte „rw“. K tomu potřebujete ID provozovny z Centra prodejce.

Které sloupce má mít CSV s recenzemi?

Povinný je jen sloupec rating. Volitelné jsou author, email, text, order_id, review_type, product_item_id, product_name a date. Bez hlavičky musí být sloupce právě v tomto pořadí. S hlavičkou import přečte i product_url (adresa produktu), pros, cons a external_id (ID recenze ve starém nástroji, opakovaný import ji pak aktualizuje).