Postup krok za krokem
Co budete potřebovat
- Připojený zdroj recenzí a aspoň jeden vytvořený widget.
- Přístup do administrace e-shopu. Na Upgates do sekce Doplňky → Vlastní konverzní kódy.
- Otevřete v e-shopu Widgety. Pokud ještě žádný widget nemáte, vyberte typ v knihovně widgetů a uložte ho.
- Upgates: zkopírujte řádek instalačního skriptu a v administraci Upgates ho vložte do Doplňky → Vlastní konverzní kódy → pole „Kód před </body>“. Uložte. Na pořadí ani na okolním kódu nezáleží.
- Skript umístí widgety sám: hodnocení e-shopu na úvodní stránku, recenze na detail produktu (do záložky Recenze nebo pod popis) a plovoucí hodnocení či vyskakující recenze, pokud je máte vytvořené. Hvězdičky u ceny a krátkou recenzi u tlačítka Koupit umístí na místo, které u nich při založení vyberete.
- Ostatní platformy: na stránce Widgety u daného widgetu zkopírujte jeho kód (tlačítko „Zkopírovat embed kód“) a vložte ho do šablony nebo do HTML bloku na místo, kde se má zobrazit. Změny vzhledu z editoru se pak projeví samy.
- Ověřte instalaci: v kroku „Zbytek už je na nás“ zadejte adresu stránky a klikněte na „Zkontrolovat instalaci“. Recenzia řekne, jestli na ní skript vidí.
- Chcete widgety nejdřív doladit? V panelu „Zatím jen pro vás“ zapněte „Zobrazovat widgety jen na testovací doméně“, vyplňte testovací doménu (například vas-shop.s15.upgates.shop) a uložte. Widgety se pak zobrazí jen tam, na ostrém webu je zákazníci neuvidí.
- Přepnutí naostro: přepínač vypněte a uložte, nebo klikněte na „Vypnout“ v pruhu „Testovací režim je zapnutý“ nad stránkou Widgety. Změna se na e-shopu projeví zhruba do 10 minut.
- Po přepnutí otevřete ostrý web v anonymním okně a zkontrolujte úvodní stránku a detail produktu, který už recenze má.
Kde to v aplikaci najdete: Tok dat → Widgety Tok dat → Widgety → Knihovna widgetů
Časté chyby
- Skript je na ostrém webu, ale testovací režim zůstal zapnutý. Na webu se nic nezobrazí a vypadá to, že widgety nefungují. Zkontrolujte pruh nad stránkou Widgety.
- Změna domény e-shopu nebo jiná testovací adresa. V testovacím režimu se widgety zobrazí jen na vyplněných doménách. Víc domén oddělte čárkou, například když má každá jazyková verze vlastní doménu.
- Testovací režim se týká jen widgetů vkládaných instalačním skriptem. Widget vložený ručně kódem se zobrazí všude, kam kód vložíte.
- Netrpělivost po změně nastavení. Skript se drží v mezipaměti, změna režimu se projeví zhruba do 10 minut.
Kódy ke zkopírování
Upgates: jeden instalační skript
Pro e-shop na Upgates je nejjednodušší jeden společný skript. Widgety umístí sám (hodnocení e-shopu na úvodní stránku, recenze na detail produktu, plovoucí hodnocení i vyskakující recenze) a pozná i jazyk stránky. Vložte ho v administraci Upgates do Doplňky → Vlastní konverzní kódy → pole „Kód před </body>“. Přesný řádek se slugem vašeho e-shopu najdete na stránce Widgety.
<script src="https://app.recenzia.cz/embed/YOUR_PROJECT_SLUG.js"></script>Vložení widgetu na web
Základní kód widgetu. Hodnotu YOUR_WIDGET_TOKEN najdete na stránce Widgety u daného widgetu (tlačítko „Zkopírovat embed kód“).
<div data-rcz-widget="YOUR_WIDGET_TOKEN" data-rcz-base="https://app.recenzia.cz" data-rcz-slug="YOUR_PROJECT_SLUG"></div>
<script src="https://app.recenzia.cz/r/YOUR_PROJECT_SLUG/embed.js"></script>Widget na detailu produktu
Produktový widget z knihovny pozná produkt podle adresy stránky, na které je vložený: kód z tlačítka „Zkopírovat embed kód“ už nese atribut data-rcz-auto-context="1". Když adresa v katalogu Recenzie chybí, předejte kód produktu (SKU) přes data-rcz-item-id.
<div
data-rcz-widget="YOUR_WIDGET_TOKEN"
data-rcz-base="https://app.recenzia.cz"
data-rcz-slug="YOUR_PROJECT_SLUG"
data-rcz-auto-context="1"
></div>
<script src="https://app.recenzia.cz/r/YOUR_PROJECT_SLUG/embed.js"></script>Pravidla CSP (Content Security Policy)
Pokud používáte Content Security Policy, povolte tyto zdroje pro skript, rámec a data.
script-src 'self' https://app.recenzia.cz;
frame-src https://app.recenzia.cz;
connect-src https://app.recenzia.cz;Widget je prázdný nebo se nezobrazuje
Kód je na webu, ale recenze nejsou vidět.
-
Není zapnutý testovací režim?
Na Upgates se v testovacím režimu widgety zobrazují jen na testovací doméně. Když je zapnutý, uvidíte nad stránkou Widgety pruh „Testovací režim je zapnutý“.
Kde to v aplikaci najdete: Tok dat → Widgety
-
Sedí token widgetu?
Token v
data-rcz-widgetmusí odpovídat aktivnímu widgetu. Najdete ho na stránce Widgety u daného widgetu (tlačítko „Zkopírovat embed kód“).Kde to v aplikaci najdete: Tok dat → Widgety
-
Má widget vůbec recenze?
V editoru widgetu zkontrolujte zapnuté zdroje, minimální hodnocení a počet recenzí, které podmínkám vyhovují.
Kde to v aplikaci najdete: Tok dat → Widgety
-
U produktového widgetu: pozná widget produkt?
Adresa stránky nebo kód produktu v
data-rcz-item-idmusí odpovídat produktu v Katalog → Produkty. -
Neblokuje to CSP nebo blokování reklam?
Otevřete v prohlížeči nástroje pro vývojáře → Console a hledejte chyby CSP nebo sítě.