Technická dokumentácia služby meranie konverzií

Obsah

• 2 scripty na meranie konverzií
• Implementácia cez HTML
• Nastavenia merania konverzií
• Cookies
• Popis metód JavaScriptového kódu
• Implementácia cez GTM
• Problémy s implementáciou

Pokiaľ máte e-shop cez Shoprenter, konzultujte prosím dokumentáciu Shoprenteru.

2 scripty na meranie konverzií

Na rozdiel od starého merania konverzií, ktoré obsahovalo iba jeden meriaci script na thank_you page, prechádzame na používanie dvoch scriptov:

1. Kód pre produktovú stránku
2. Kód pre stránku potvrdenia objednávky

Nájdete ich v administrácii Heureky. Odporúčame scripty z administrácie skopírovať a iba zmeniť hodnoty relevantných argumentov.

Implementácia cez HTML

Základným postupom na správne sprevádzkovanie meranie konverzií je použitie dvoch meriacich scriptov. Kód pre košík využíva funkciu heureka() s niekoľkými argumentmi. Poradie volania tejto funkcie nie je dôležité, ale send musí byť zavolané až na konci po všetkých ostatných funkciách.

Kód pre produktovú stránku

V tomto scripte nemusíte nič meniť.

Kód pre stránku potvrdenia objednávky

1. Identifikácia vášho e-shopu

   Použitím authenticate metódy identifikujete váš e-shop.

2. Vytvoríte novú objednávku

   Použitím set_order_id metódy vytvoríte novú objednávku a nastavíte jej ID, ktoré jej priradil váš e-shop.

3. Pridáte produkt(y) do objednávky

   Použitím add_product metódy pridáte produkty ku 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 doprava, dobierka, balné, recyklačný poplatok, atd.!

4. (voliteľne) Pridáte ďalšie neproduktové položky do objednávky

   Použitím add_additional_item metódy pridáte ďalšie neproduktové položky ako je napríklad doprava, dobierka, balné, recyklačný poplatok, vouchery, zľavy, atp. do objednávky. Môžete ju zavolať jedenkrát pre súčet všetkých položiek, alebo pre každú jednotlivú položku zvlášť.

5. Nastavenie hodnoty objednávky

   Použitím set_total_vat nastavíte celkovú cenu objednávky (vrátane DPH alebo bez nej, podľa vašich nastavení).

6. Nastavenie meny

   Použitím set_currency nastavíte menu objednávky.
   
   Odporúčame posielať objednávky už prepočítané do meny portálu ( 'EUR' pre heureka.sk, 'CZK' pre heureka.cz). V opačnom prípade môže pri väčšom objeme dát dôjsť ku skresleniu štatistík v dôsledku konverzie mien. Pokiaľ sa aj tak rozhodnete posielať objednávky v rôznych menách, musí to byť niektorá z tých nami podporovaných (aktuálne 40 mien podľa Európskej centrálnej banky). Ich zoznam nájdete na tejto stránke. Kurzy aktualizujeme každý deň o polnoci.
   
   Mena musí byť vo formáte ISO 4217 (napr. CZK, EUR, USD).
   
   Pokiaľ použijete nepodporovanú menu alebo neplatnú hodnotu, objednávka bude uložená vo východzej mene portálu, čo môže skresliť štatistiky.

7. Odošlete objednávku nášmu serveru

   Použitím send potvrdíte celú objednávku a odošlete ju nášmu serveru. Toto volanie musí byť posledné v scripte.

Testovanie predávky identifikátora prekliku pri vytvorení objednávky

Ak chcete lokálne otestovať, či bude objednávka správne spárovaná s preklikom používateľa (tj. bude konverzná), postupujte podľa nasledujících krokov:

1. Pridanie parametru do URL

   • Do URL adresy na stránke, kde je implementovaný niektorý z meriacich scriptov, pridajte parameter hgtid=test (napríklad: https://localhost:4001/order_summary?hgtid=test).
   • Skontrolujte, či sa vytvorila cookie hg_ocm_id s hodnotou test.

2. Vytvorenie objednávky

   • Dokončite proces vytvorenia objednávky.

3. Overenie na stránke potvrdenia objednávky

   • Na stránke potvrdenia objednávky ("thank you page") skontrolujte, či bola hodnota tejto cookie predaná v payloade požiadavku.

Tento postup vám pomôže zaistiť správne fungovanie predávania identifikátora prekliku a jeho správne spracovanie v systéme.

Nastavenia merania konverzií

Zobrazovanie nákladov a DPH

Toto nastavenie určuje, či sa vaše náklady budú zobrazovať s DPH alebo bez nej. V predvolenom nastavení predpokladáme, že hodnoty posielate vrátane DPH. Chovanie je ale možné upraviť na stránke "Meranie konverzií (nové)" (ku nastaveniam sa dostanete aj kliknutím na tlačidlo „Nastavenia“ na stránke štatistík). Pokiaľ túto možnosť zmeníte, náklady sa budú zobrazovať bez DPH.

Nastavenie by malo odpovedať formátu, v ktorom nám hodnotu objednávky posielate (s DPH alebo bez nej).

Cookies

Služba meranie konverzií pracuje s cookie hg_ocm_id, ktorej účel je analytický, a ktorá zaisťuje uloženie identifikátora exitu z Heureka produktového detailu.

Popis metód JavaScriptového kódu

Implementácia cez GTM

Implementáciu cez Google Tag Manager (GTM) neodporúčame, pretože býva často blokovaný adblockermi, čo môže spôsobiť nepresnosti v meraní konverzií.

Príklad implementácie merania cez GTM uvádzame pre prípad štandardnej implementácie dátovej vrstvy (dataLayer), podľa definície pre Google Analytics 4. Pokiaľ máte implementáciu dátovej vrstvy odlišnú, je treba tejto implementácii prispôsobiť príslušné premenné v tagu “Heureka - Purchase”.

Existujú dva spôsoby, ako implementovať meranie cez GTM:

• Postup uvedený v tejto dokumentácii.
• Použitie šablóny GTM - Heureka, ktorá bola vytvorená treťou stranou. Upozorňujeme, že za používanie tejto šablóny nenesieme žiadnu zodpovednosť.

Pre implementáciu cez GTM neposkytujeme technickú podporu, pretože sa na túto oblasť nezameriavame. Odporúčame preto implementáciu priamo cez kód.

Pre správne meranie podľa tohto návodu je nutné vložiť dva “Custom HTML” tagy s príslušnými JavaScriptovými kódmi.

Tag na stránku produktového detailu

1. Založte nový tag “Custom HTML”

   

2. Prejdite na voľbu typu tagu

   

3. Zvoľte typ “Custom HTML”

   

4. Do novo založeného tagu skopírujte príslušný JavaScriptový kód:

   <!-- Heureka.sk PRODUCT DETAIL script -->
   <script>
     (function(t, r, a, c, k, i, n, g) {t['ROIDataObject'] = k;
     t[k]=t[k]||function(){(t[k].q=t[k].q||[]).push(arguments)},t[k].c=i;n=r.createElement(a),
     g=r.getElementsByTagName(a)[0];n.async=1;n.src=c;g.parentNode.insertBefore(n,g)
     })(window, document, 'script', '//www.heureka.sk/ocm/sdk.js?version=2&page=product_detail', 'heureka', 'sk');
   </script>
   <!-- End Heureka.sk PRODUCT DETAIL script -->
   

   

5. Tagu nastavte v “Advanced Settings > Consent Settings” jeho chovanie voči Google Consent Mode na voľbu “No additional consent required”. Nový meriaci skript si stráži správne chovanie voči súhlasu používateľa automaticky sám.

   

6. Skontrolujte, či je tag správne nastavený a uložte zmeny

   

7. Následne tagu pridajte príslušný trigger, ktorý spustí tag v správnu chvíľu, teda na stránke produktového detailu. V štandardnej implementácii pre Google Analytics 4 využívame dataLayerový event “view_item”. Pokiaľ používate inú implementáciu dátovej vrstvy, trigger jej prispôsobte (napr. môžete tag spúšťať na trigger typu Page View s podmienkou na typ stránky: “Product” a pod.).

   1. Zvoľte trigger

      

   2. Vytvorte nový trigger (pluskom v rohu)

      

   3. Zvoľte typ triggeru “Custom Event”

      

   4. Nastavte trigger na udalosť “view_item”

      

   5. Skontrolujte nastavenia triggeru a uložte zmeny

      

Tag na ďakovaciu stránku po úspešnom nákupe

Tag na meranie konverzií je potrebné spúšťať na ďakovnej stránke po úspešnom nákupe, v momente, keď máme v dátovej vrstve potrebné údaje o transakcii. Tieto údaje sú do tagu prenášané pomocou "dataLayer" premenných. V príklade uvádzame "dataLayerové" premenné, ktoré zodpovedajú odporúčanej implementácii dátovej vrstvy pre Google Analytics 4. Ak máte štruktúru dátovej vrstvy odlišnú, prispôsobte použité premenné v skripte.

Ak v Google Tag Manager ešte nemáte vytvorené príslušné premenné, pripravte si ich. Budete potrebovať: ID transakcie, hodnotu transakcie, menu transakcie, pole produktov v transakcii. Ďalej budete potrebovať príslušný "API KEY" pre váš e-shop, ktorý získate v administrácii.

Postup vytvorenia "DataLayerovej" premennej je pre všetky rovnaký:

1. V záložke "Premenné" vytvorte novú premennú tlačidlom "New"

   

2. Vyberte typ premennej “Data Layer Variable”

   

3. Zvoľte správny kľúč premennej a dajte premennej názov

   

4. Rovnako opakujte pre všetky ostatné potrebné premenné

   

5. Následne vytvorte nový “Custom HTML” tag, ako v predchádzajúcom prípade, a vložte do neho nasledujúci skript. V skripte nahraďte hodnotu “API KEY” skutočným API kľúčom, a ak je to potrebné, upravte príslušné GTM premenné podľa vášho nastavenia.

   <!-- Heureka.sk THANK YOU PAGE script -->
   <script>
       (function(t, r, a, c, k, i, n, g) {t['ROIDataObject'] = k;
       t[k]=t[k]||function(){(t[k].q=t[k].q||[]).push(arguments)},t[k].c=i;n=r.createElement(a),
       g=r.getElementsByTagName(a)[0];n.async=1;n.src=c;g.parentNode.insertBefore(n,g)
       })(window, document, 'script', '//www.heureka.sk/ocm/sdk.js?version=2&page=thank_you', 'heureka', 'sk');
       heureka('authenticate', 'API KEY');
       heureka('set_order_id', '{{dl.ecommerce.transaction_id}}');
       var items = {{dl.ecommerce.items}};
       if (typeof items !== "undefined"){
         for (var a = 0; a < items.length; a++){
           heureka('add_product', items[a].item_id.toString(), items[a].item_name.toString(), items[a].price.toString(), items[a].quantity.toString());
         }
       }
       heureka('set_total_vat', '{{dl.ecommerce.value}}');
       heureka('set_currency', '{{dl.ecommerce.currency}}');
       heureka('send', 'Order');
   </script>
   <!-- End Heureka.sk THANK YOU PAGE script -->

6. Tagu nastavte príslušný trigger, ktorý spustí tag v správnom čase, teda na ďakovnej stránke, keď sú dostupné príslušné údaje v dátovej vrstve. Pri štandardnej implementácii pre Google Analytics 4 používame event „purchase“. Tagu tiež nastavte správanie voči súhlasu s meraním na možnosť „No additional consent required“, tag si kontroluje súhlasy automaticky sám.

   

   1. Nastavte trigger na udalosť “purchase”

      

   2. Nastavte consent rovnako ako pri predošlom triggere

      

7. Skontrolujte nastavenia tagu a uložte zmeny

   

8. Po nastavení a uložení tagu je potrebné implementáciu skontrolovať v režime „Preview“. Ak sa tagy spúšťajú a vidíte, že údaje odchádzajú na príslušný koncový bod (https://harvester.ocm.heureka.group/), je všetko v poriadku a môžete implementáciu publikovať. Tým je implementácia merania Heureka konverzií hotová.

   

Problémy s implementáciou

Pokiaľ ste implementovali nový meriaci konverzný skript a na stránke so štatistikami sa objaví chybová správa „Za posledných 7 dní sme obdržali XY objednávok s nesprávnymi údajmi“, znamená to, že niektorá časť vášho skriptu nefunguje podľa očakávaní. Existuje niekoľko možných varovaní a chýb, ktoré môžete obdržať. Závažnosť môže byť buď varovanie, alebo chyba - varovanie znamená, že skript funguje podľa očakávaní, objednávky sú uložené, ale niektoré hodnoty nie sú odosielané správne. Chyba obvykle znamená závažnejší problém v implementácii, ktorý môže ovplyvniť ukladanie objednávok. Nižšie je uvedený popis možných hodnôt varovaní a chýb.