Konverzní kódy
Definice pojmů
- Konverzní kód - je měřící kód vložený do stránky vašeho eshopu. Pomocí tohoto kódu můžete identifikovat konverze.
- Konverze - Konverze znamená může být vyhodnocena pro každého jinak. Nejběžnější konverzí je dokončená objednávka. Avšak pro někoho kdo sbírá kontakty, je konverzí dokončená registrace.
- dataLayer - Souhrn dat, které nástroje (Google Analytics, Google Tag Manager, atd.) používájí pro vyhodnocení konverze
Jak konverzní kód vypadá
Konverzní kódy bývají napsány v kódovacím jazyku JavaScript, případně s využitím také HTML.
Kompletně vytvořený kód obdržíte od poskytovatelů daných nástrojů.
dataLayeru, pokud již není vytvořen
<script>
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('event', 'purchase', {
transaction_id: 'ORDER-2026-0001',
value: 2499,
tax: 433,
shipping: 99,
currency: 'CZK',
items: [
{
item_id: 'SKU-123',
item_name: 'Tričko s potiskem',
price: 499,
quantity: 2
},
{
item_id: 'SKU-456',
item_name: 'Mikina',
price: 1501,
quantity: 1
}
]
});
</script>
Rozdělení konverzních kódů
Konverzní kódy s v Upgates dělí na dvě části:
- Klientské - Klientské konverzní kódy lze vkládat dvěma způsoby
- Vlastní konverzní kódy - Najdete v sekci Doplňky / Vlastní konverzní kódy
- Google Tag Manager - Doplněk Google
- Systémové
- Do systémových kódů spadají nejčastější analytické nástroje jako jsou Google Analytics, Tag Manager, Seznam, Facebook, atd.
Pro tyto nástroje není nutné scripty nastavovat. Jednoduše doplněk aktivujete, vložíte svůj identifikátor účtu a vše bude fungovat plně automaticky.
- Do systémových kódů spadají nejčastější analytické nástroje jako jsou Google Analytics, Tag Manager, Seznam, Facebook, atd.
Rozdíl mezi klientskými a systémovými konverzními kódy je v tom, že systémové kódy jsou definované systémem Upgates a nelze je ze strany klienta upravit.
Vložení konverzního kódu do stránky
Pokud nechcete využívat systémové konverzní kódy, můžete do stránek vkládat své vlastní. Konverzní kódy (popřípadě jiné JavaScripty) můžete vložit do stránek pomocí Vlastních konverzních kódů.
Vložené konverzní kódy musí zohlednit používání cookies podle zákona o elektronických komunikacích. V aktuálních grafických šablonách nabízíme možnost povolení nebo zamítnutí jednotlivých typů cookies.
Nastavení v administraci
- V menu administrace zvolte sekci Doplňky / Vlastní konverzní kódy.
- Podle toho, co doporučuje poskytovatel kódu, vyberte na jakých stránkách se bude kód vyskytovat.
- Všechny stránky e-shopu.
- Pouze na stránce po dokončení objednávky.
- Podle toho, co doporučuje poskytovatel kódu, vyberte vhodné umístění ve zdrojovém kódu stránky.

- Vložte kód do vybraného pole.
- Uložte.
Dynamičtí zástupci pro kódy
Systém umožňuje do konverzního kódu generovat pomocí dynamických zástupců hodnoty přímo z databáze e-shopu. Jejich možnosti naleznete v naší dokumentaci.
Ověření propsání do stránek
Konverzní kód máte vložený, avšak jak zjistit zda-li se skutečně propsal správně?
Ověření zda-li konverzní kód funguje lze provést několika způsoby:
- Kontrola scriptu přímo ve zdroji
- Přejděte na stránku vašeho eshopu tak, jak jí vidí váš zákazník po zadání vaší domény.
- Přejděte na správnou stránku
- Pokud jste vložili script na všechny stránky - můžete otevřít jakoukoli stránku
- Pokud jste vložili script na stránku dokončené objednávky - vytvořte a dokončete testovací objednávku
- Klikněte pravým tlačítkem myši kdekoli na stránce a zvolte Prozkoumat
- Otevře se vám konzole prohlížeče
- Vyhledejte správnou sekci, podle toho kam jste script vložili
- Mezi tagy
<head>a</head> - Na začátku tagu
<body> - Před tagem
</body>
Správnou sekci můžete v konzoli vyhledat kliknutím do konzole a pomocí klávesové zkratky CTRL+F5
- Mezi tagy
- Vyhledejte část vašeho kódu
Pokud je script správně napsán, bude vypsán v daném sekci
*Na obrázku vložen script<script>custom text</script>mezi tagy<head>a</head>
Výhody použití: Rychlá kontrola správnosti vytvořeného a umístěného scriptu.
Nevýhody použití: Neověříte, zda-li script skutečně funguje v daném nástroji.
- Kontrola za pomocí prohlížeče (vhodné pro kontrolu systémových scriptů)
- Prohlížeče jako například Google Chrome dokáží nainstalovat různé externí rozšířené (Google extensions). Pomocí těchto rozšíření se tak můžete zbavit nutnosti hledat ve zdrojovém kódu eshopu a vše si překontrolovat v přehledném rozhraní doplňku.
- Doporučené rozšíření:
- DataLayer Checker - Pro kontrolu dataLayeru stránky
- Tag Assistant - Pro kontrolu Google Tag Manageru, Google Analytics a Google Ads
Výhody použití: Není nutné složitě dohledávat ve zdrojovém kódu. Většinou jednoduché a přehledné rozhraní.
Nevýhody použití: Nemusí být vždy zcela přesné (závisí na správném vyhodnocení zdrojového kódu doplňkem). Neověříte, zda-li script skutečně funguje v daném nástroji.
- Kontrola v cílovém nástroji
- Zda-li kód funguje ověříte nejjednodušeji asi přímo v daném cílovém nástroji. Otevřete si tedy například Google Analytics, Tag Manager, nebo jiný nástroj pro který daný script je určený a podívejte se zda-li skutečně dělá to co má.
Pozor! Aby měřící kódy zachycující konverzi skutečně fungovaly, musí na eshopu být nějaký "pohyb". Aby například script určený pro otevření stránky mohl naměřit nějaký výsledek, musí se nějaká stránka na eshopu otevřít. Popřípadě script, který se má fungovat na stránce s dokončením objednávky potřebuje, aby nějaké objednávky byly dokončeny.
U Google či jiných měření, mohou být výsledky vidět až po uplynutí přibližně 24 Hodin.
Nastavení odesílaných cen konverzních kódů
U konverzních kódů integrovaných do systému Upgates je možné zvolit způsob odesílání cen položek v objednávkách - buď s DPH anebo bez DPH. Pro přesnější statistiky v externích systémech doporučujeme odesílat ceny bez DPH.
Nastavení v administraci
- V menu administrace zvolte sekci Nastavení / Základní / Nastavení obchodu.
- Na stránce se přesuňte do oddílu Konverzní kódy.
- V poli Měření cen objednávky vyberte požadovaný způsob odesílání cen do konverzních kódů:
- S DPH: odesílané ceny položek budou včetně DPH.
- Bez DPH: odesílané ceny položek budou bez DPH.

- Uložte.
Konverze po dokončení platby
Platbou přes platební bránu může dojít k ovlivnění statistik měřených konverzními kódy. Mohou nastat dvě situace:
- konverzní kód není zpracován,
- jako zdroj konverze je uvedena platební brána.
Konverzní kód není zpracován
Například po dokončení platby uživatel zavře stránku platební brány ještě dříve, než dojde k přesměrování zpět na e-shop. Tím pádem na stránce e-shopu není dokončeno zpracování konverzního kódu.
Následně v analytickém nástroji nesouhlasí počet konverzí se statistikami z jiných zdrojů (např. administrace e-shopu).
Platební brána jako zdroj konverze
U platby objednávky přes platební bránu se jako zdroj konverze může zaznamenat samotná platební brána.
Tím dojde k ovlivnění statistik konverzí v analytickém nástroji (např. Google Analytics). Abyste předešli tomuto problému, je nutné platební bránu vyloučit z odkazujících stránek v tomto nástroji.
Vyloučení odkazujících stránek v Google Analytics
Návod pro vyloučení v Google Analytics naleznete v nápovědě na stránkách Google. Více zde.
Připojení externího souboru
Potřebujete vložit do grafiky e-shopu vlastní JavaScript soubor nebo jakýkoli jiný, např. obrázkový nebo video soubor? Ale nechcete kvůli toho vypínat modul Designer? Lze to následujícím způsobem. Postup je určen pro technicky zdatné uživatele.
- Přejděte do modulu Grafika / Vlastní soubory a přidejte soubor na uložiště (FTP) podle nápovědy zde.
- Přejděte do modulu Doplňky / Vlastní konverzní kódy.
- Vyberte umístění vašeho souboru ve zdrojovém kód. Více zde.
- Do textového pole přidejte include na soubor umístěný ve složce /shop-data.
- Uložte provedené změny.
Propojení na externí služby pomocí JavaScritu
Sekce Doplňky / Vlastní konverzní kódy lze využít ne jen pro konverzní kódy, ale také pro vkládání kódů externích pluginů a služeb. Např. to mohou být chaty, reklamní štítky, bannery, vyskakovací okna, lišty, analýzy atd.
Téměř jakýkoli kus JavaScript kódu vložený do Vlastních konverzních kódů se na stránce vykoná.
Využívejte hotová propojení!
Pokud existuje již hotové propojení ze strany Upgates, doporučujeme jej využít. Automaticky se totiž aktualizuje dle nejnovější dokumentace externí služby. Také při samotné implementaci kódu by nemělo dojít k různým chybám, které mohou způsobit špatné zobrazení stránky.
Upgates neprovádí individuální úpravy skriptů ani individuální napojení na služby, které oficiálně nepodporujeme. Ohledně těchto záležitostí můžete oslovit externí agentury na našem Marketplace.
Ověření vlastnictví
Některé služby požadují ověření vaší domény, že jste jejím vlastníkem. To lze provést tak, že do obsahu, který je umístěn na doméně, přidáte část unikátního kódu. Tento úkon může provést pouze vlastník domény nebo někdo, kdo má přístup do obsahu na doméně.
Obvykle máte tyto možnosti ověření
- Přidání určitého souboru do hlavního adresáře stránek - Upgates tuto možnost neumožňuje.
- Přidání části HTML kódu do stránky - Upgates podporuje, viz. níže.
- Přidání DNS TXT záznamu k vaší doméně - Je to trochu komplikovaná možnost pro technicky zdatné uživatele.
Přidání části HTML kódu do stránky
Stačí vložit požadovaný kus HTML kódu následujícím způsobem:
- Přejděte do modulu Doplňky / Vlastní konverzní kódy.
- Najeďte do oddílu Kódy umístěné na všech stránkách.
- Vyberte pole Kód je umístěn mezi tagy <head> a </head>, případně jiné umístění doporučené poskytovatelem. Více zde.
- Uložte provedené změny.
Problémy s konverzními kódy
Fungování až po přesunu na ostrou doméně
Většina konverzních kódů začne plně fungovat až po přesunu e-shopu na ostrou doménu (více zde).
Duplicitní kódy na stránce
Před vložením vlastního kódu se ujistěte, zda nemáte již zapnuté hotové propojení na danou službu. Pokud potřebujete například vložit Facebook Pixel konverzní kód s vlastním nastavením, odstraňte v Doplňky / Facebook kód z pole Facebook Pixel ID. Tím hotové propojení zrušíte a ponecháte pouze propojení pomocí vlastního konverzního kódu.
Pokud používáte Google Tag Manager, ujistěte se, že přes něj nevkládáte skripty na jiné služby. Tímto způsobem si můžete např. vložit duplicitní Facebook Pixel kód.
Rozdílná data v měření konverzí
Data se do měřících systémů odesílají z internetového prohlížeče nakupujícího zákazníka pomocí konverzních kódů, napsaných v kódovacím jazyku JavaScript (JS). Prohlížeče mohou použití JS v různé míře blokovat přímo (např. Safari od Applu) nebo prostřednictvím nainstalovaného doplňku zákazníkem (Adblocker apod.).
Proto nemusí pokaždé dojít ke správnému odeslání dat přes konverzní kódy. Této situaci nelze předejít, a proto je potřeba počítat s určitým výpadkem v datech odesílaných do konkrétních služeb přes konverzní kódy.
Podle společnosti Google se data z konverzních kódů odešlou úspěšně přibližně v 80% případů. Naproti tomu v administraci e-shopu jsou statistiky prodejů odvozené přímo z dat v našem systému, a proto jsou přesnější.
Vložené konverzní kódy musí také zohledit používání cookies podle zákona o elektronických komunikacích. Pokud skript využívá cookies, pak by měl být připravený na možnost zamítnutí používání tohoto typu cookies ze strany zákazníka e-shopu. V opačném případě skript nemusí fungovat správně. Funkčnost skriptu v případě nepovolených cookies si ověřte u autora konkrétního skriptu.
V aktuálních grafických šablonách nabízíme možnost povolení nebo zamítnutí jednotlivých typů cookies. V konverzních kódech je pro tyto situace možné použít dynamické zástupce pro cookies. Více zde.
Doba načítání stránky
Je třeba mít na paměti, že každý konverzní kód musí být zpracován na straně prohlížeče a to může někdy i významně ovlivnit délku načítání stránky e-shopu. Obecně doporučujeme s různými externími kódy šetřit a vždy si dobře rozmyslet, který je pro vás důležitý.
Měření konverzí server-to-server
Měření konverzí server-to-server znamená, že se informace o konverzi neodesílá z prohlížeče zákazníka, ale přímo ze serveru e-shopu na servery analytických / reklamních systémů.
Toto měření prozatím Upgates neumožňuje. Používat lze pouze JavaScriptové měřící kódy použité v prohlížeči.