Implementácia kódu meranie konverzií

Informácie o implementácii kódu meranie konverzií [PDF] pre vášho programátora. Prípadne niekoľko shopsystémov už má predpripravené rozhranie pre implementáciu tejto služby a stačí iba vložiť unikátny kľúč, ktorý nájdete v administrácii obchodu pod záložkou Meranie konverzií pod názvom príslušného e-shopu.

Základný postup

Základným postupom pre správne sprevádzkovanie merania konverzií je použitie štyroch metód. Tieto metódy sú opísané v poradí, v akom by mali byť volané z vášho e-shopu.

Identifikácia vášho e-shopu
Použitím setKey()metódy identifikujete váš e-shop.
Vytvoríte novú objednávku (len plná implementácia)
Použitím setOrderId()metódy vytvoríte novú objednávku a nastavíte jej ID, ktoré jej priradil váš e-shop.
Pridáte produkt(y) do objednávky (len plná implementácia)
Použitím addProduct()metódy pridáte produkty k objednávke. Táto metóda bude volaná toľkokrát, koľko je v objednávke produktov. Prosím nepridávajte položky ako dopravné, balné, recyklačný poplatok atď.
Odošlete objednávku nášmu serveru (len plná implementácia)
Použitím trackOrder()potvrdíte celú objednávku a odošlete ju nášmu serveru.

Príklady kódu

Nasledujúce príklady kódov ukazujú umiestnenie kódov na stránke a popisujú jednotlivé metódy. Nasledujúce kódy slúžia len ako príklad. Pre vloženie na vašu stránku vždy použite kód, ktorý nájdete na stránke Meranie konverzií u vášho obchodu. Kód vždy vkladajte do tela HTML stránky, teda medzi <body> a </ body>. Umiestnením do inej časti by mohlo spôsobiť nefunkčnosť merania alebo aj zobrazovanej stránky.

Príklad kódu plnej implementácie

(Toto je len príklad pre vysvetlenie, pre vloženie na váš web použite kód, ktorý nájdete tu.)

<html>
<head>
    <title>Potvrzení vaší objednávky</title>
</head>
<body>
<script type="text/javascript">
var _hrq = _hrq || [];
// nastaví váš veřejný klíč, kterým je identifikován váš e-shop (klíč je automaticky vložen
  // do kódu, který najdete ve své administraci)                 
_hrq.push(['setKey',               

'ABCDEFGH12345NOPQRS1111123456789' // veřejný klíč vašeho e-shopu
]); 

// vytvoří objednávku a nastaví ji ID, které vygeneroval váš e-shop                
_hrq.push(['setOrderId',

'123'                              // číselné ID objednávky
]);

// přidá jeden produkt k objednávce (metoda je volána tolikrát, kolik je v objednávce produktů)            
_hrq.push(['addProduct',           

'Nokia 5230',                      // název produktu (musí se shodovat s tím, který dáváte 
                                     // do klasického feedu) a pokud obsahuje apostrof ' 
  	                           // musíte ho escapovat zpětným lomítkem tedy \'

'3100.00',                         // cena produktu za jeden kus (musí být číslo bez Kč apod.)

'1'                                // počet kusů produktu (musí být číslo bez ks apod.)
]);

// odešle celou objednávku našemu serveru
_hrq.push(['trackOrder']);

(function() {
var ho = document.createElement('script');
ho.type = 'text/javascript'; ho.async = true;
ho.src = 'https://im9.cz/sk/js/ext/2-roi-async.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ho, s);
})();
</script>

<p>Děkujeme Vám za provedenou objednávku. Za chvíli obdržíte email 
s informacemi o právě provedené objednávce.</p>
</body>
</html>

Príklad kódu obmedzenej implementácie

(Toto je len príklad pre vysvetlenie, pre vloženie na váš web použite kód, ktorý nájdete tu.)

<html>
<head>
    <title>Potvrzení vaší objednávky</title>
</head>
<body>
<script type="text/javascript">
var _hrq = _hrq || [];                

// nastaví váš veřejný klíč, kterým je identifikován váš e-shop (klíč je automaticky vložen 
  // do kódu, který najdete ve své administraci)
_hrq.push(['setKey',        

'ABCDEFGH12345NOPQRS1111123456789' // veřejný klíč vašeho e-shopu
]);

// odešle celou objednávku našemu serveru
_hrq.push(['trackOrder']);   
                         
(function() {
var ho = document.createElement('script');
ho.type = 'text/javascript'; ho.async = true;
ho.src = 'https://im9.cz/sk/js/ext/2-roi-async.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ho, s);
})();
</script>

<p>Děkujeme Vám za provedenou objednávku. Za chvíli obdržíte email 
s informacemi o právě provedené objednávce.</p>
</body>
</html>

Dodatočné informácie

Obe implementácie využívajú asynchrónne JavaScriptové API rozhranie. Nemusíte sa tak obávať, že nedostupnosť nášho servera bude negatívne ovplyvňovať chod e-shopu.
Objednávky od jedného užívateľa v priebehu 5 minút sa považujú za podvodné.