Co je konverzní kód?

Konverzní kód v inzertním systému Můj.Skrz.cz funguje podobně jako např. konverzní kódy v Google Ads a Sklik - na stránce, kde je jisté, že zákazník dokončil objednávku (bez ohledu na její zdroj), vložíte krátký Javascriptový kód, který odešle informace o uskutečněné objednávce (vaše ID položek, jejich počet, cenu) do rozhraní Muj.Skrz.cz.

Díky tomu na Muj.Skrz.cz uvidíte přesně, které nabídky zákazníky zajímají, a přinesly Vám objednávky (obrat).

Systém Skrzu bere v potaz, které nabídky pro vás mají nejvyšší prospěch, které vám přivedou nejvíce platících zákazníků. Takové nabídky samozřejmě bude zobrazovat více. A naopak, nabídky, které přínos nemají, upozadí, aby nevytvářely zbytečné náklady.



Kam a kdy umístit?

Kód níže je nutné umístit na stránku, kde je jisté, že došlo k dokončení objednávky.

V případě platby kreditní kartou, pomocí PayPal apod. to bude stránka, kde zobrazíte, že platba byla úspěšně zpracována. Pokud bude zákazník platit převodem, kód by měl být na stránce s platebními údaji.

Je nezbytné, aby kód byl na dané stránce vložen vždy. Pokud si nejste jisti správností nasazení konverzního kódu, kontaktuje podporu na muj@skrz.cz.



Implementace

Konverzní kód Muj.Skrz.cz je asynchronní, aby nezdržoval načítání stránky. Rozhraní pro implementace není nepodobné Google Analytics - pokud tedy již máte implementované měření konverzí do Google Analytics, nebude vám implementace cizí.



Ukázka košíku

Zápis konverzního kódu hodně odpovídá tomu, jak vypadá klasický košík při nákupu na internetu. Řekněme, že zákazník koupil pobyt pro 2 dospělé a 1 dítě. Košík bude vypadat následovně.

ID položky/objednávky Název položky Cena za položku Počet položek Celková cena
POBYT-0125-DOSPELY Týdenní pobyt v Chorvatsku s all inclusive 2800 Kč 2 osoby 5600 Kč
POBYT-0126-DITE Týdenní pobyt v Chorvatsku varianta pro dítě 2000 Kč 1 osoba 2000 Kč
OBJ-23412 Celkem 7600 Kč

Zákazník s takovým košíkem dokončí objednávku. Řekněme, že objednávka dostala ID OBJ-23412. Na stránku dokončení objednávky ("thank you page") je pro takovou objednávku potřeba vložit následující Javascriptový kód, který bude vypadat následovně:

<script>
(function (m,u,j,s,k,r,z){m['SkrzAnalyticsObject']=k;m[k]=m[k]||function(){
(m[k].q=m[k].q||[]).push(arguments)},m[k].l=1*new Date();r=u.createElement(j),
z=u.getElementsByTagName(j)[0];r.async=1;r.src=s;z.parentNode.insertBefore(r, z)
})(window, document, 'script', '//muj.skrz.cz/analytics.js', 'sa');

sa("create",  "<IDENTIFIKÁTOR SERVERU>");

sa("addItem", {"itemId":"POBYT-0125-DOSPELY","unitPrice": "2800.00","quantity":"2","totalPrice":"5600.00"});
sa("addItem", {"itemId":"POBYT-0126-DITE","unitPrice":"2000.00","quantity": "1","totalPrice":"2000.00"});

sa("send", {"transactionId":"OBJ-23412","isPaid":"1","grandTotal":"7600.00","currency":"CZK"});
</script>

Proberme si jednotlivé části kódu.



Hlavička

(function (m,u,j,s,k,r,z){m['SkrzAnalyticsObject']=k;m[k]=m[k]||function(){
(m[k].q=m[k].q||[]).push(arguments)},m[k].l=1*new Date();r=u.createElement(j),
z=u.getElementsByTagName(j)[0];r.async=1;r.src=s;z.parentNode.insertBefore(r, z)
})(window, document, 'script', '//muj.skrz.cz/analytics.js', 'sa');

Tato hlavička se musí v konverzním kódu vyskytovat vždy. Asynchronně načte skript pro konverzní kód z našeho serveru.



Identifikace serveru

sa("create",  "<IDENTIFIKÁTOR SERVERU>");

Metoda create nastavuje váš identifikátor. Řetězec <IDENTIFIKÁTOR SERVERU> nahraďte vaším reálným identifikátorem. Ten najdete v menu v sekci Nastavení > Nastavení analytiky.

Váš identifikátor uvidíte vpravo v boxu Nastavení analytiky.



Přidávání položek

sa("addItem", {"itemId":"POBYT-0125-DOSPELY","unitPrice": "2800.00","quantity":"2","totalPrice":"5600.00"});

Metoda addItem přidá položku do objednávky. Jako argument bere JSON objekt s následujícími klíči:

Klíč Příklad hodnoty Popis
itemId POBYT-0125-DOSPELY ID položky. Musí se shodovat s ID položky, které posíláte v XML feedu (jinak nedokážeme napárovat správně položky objednávek na položky z XML feedů a nebudou sedět statistiky po položkách). ID položky může být libovolný řetězec z písmen, čísel, pomlček apod.

Vždy dávejte kolem ID položky uvozovky ("). Předejdete tak problémům s funkčností.
unitPrice 2800.00 Cena za kus.
quantity 2 Počet osob, které zákazník při objednávce zvolil.
totalPrice 5600.00 Celková cena položky objednávky. Mělo by platit, že unitPrice * quantity == totalPrice.

Všechny hodnoty (i číselné) doporučujeme vždy dávat do uvozovek. Předejdete tak problémům s nefunkčností konverzního kódu.

sa("addItem", {"itemId":"POBYT-0126-DITE","unitPrice":"2000.00","quantity":"1","totalPrice":"2000.00"});

Každou položku uvádějte na nový řádek. Položek můžete přidat kolik chcete. Tzn. pokud bude v košíku pouze jedna položky, řádek s addItem bude přítomen pouze jednou. Jestliže jich bude v košíku 10, bude 10 řádek s addItem.

sa("addItem", {"itemId":"POZNAVACI-ZAJEZD-VARSAVA",      "unitPrice":"490.00","quantity": "1","totalPrice":"490.00"});

Přes addItem je třeba přidat všechny položky objednávky, které tvoří kompletní částku objednávky, aby grandTotal reflektoval konečnou cenu, kterou zákazník zaplatí.



Odeslání objednávky

sa("send", {"transactionId":"OBJ-23412","isPaid":"1","grandTotal":"7649.00","currency":"CZK"});

Metoda send odešle celou objednávku na servery Muj.Skrz.cz. Jako argument příjímá JSON objekt s následujícími klíči:

Klíč Příklad hodnoty Popis
transactionId OBJ-23412 ID objednávky. Může být libovolný řetězec z písmen, čísel, pomlček apod.

Vždy dávejte kolem ID objednávky uvozovky ("). Předejdete tak problémům s funkčností.
isPaid 1, nebo 0 Určuje jestli byla objednávka zaplacena - např. při platbě kartou online. 1 znamená, že byla zaplacena. 0 znamená, že zaplacena nebyla.

1 použijte tehdy, když je již jisté, že byla objednávka zaplacena. Bude to tehdy, když zákazník použil nějakou online platební metodu (kreditní/debitní kartou online, Paypal, Paysec, PayU apod.).
grandTotal 7649.00 Celkový součet objednávky. Mělo by platit, že součet všech totalPrice z addItem volání dá dohromady grandTotal. Tato hodnota slouží hlavně k ověření, že je kód implementován správně.
currency CZK Třípísmený ISO kód měny, ve které jsou všechny ceny uvedené v objednávky. Pro Českou korunu použijte CZK.

Skrz.cz s.r.o. (2019) Všeobecné obchodní podmínky | Pravidla pro zveřejňování nabídek