Technická dokumentace služby měření konverzí

Obsah

• 2 scripty na měření konverzí
• Implementace přes HTML
• Nastavení měření konverzí
• Cookies
• Popis metod JavaScriptového kódu
• Implementace přes GTM
• Problémy s implementací

Pokud máte e-shop přes Shoprenter, konzultujte prosím dokumentaci Shoprenteru.

2 scripty na měření konverzí

Na rozdíl od starého měření konverzí, které obsahovalo jenom jeden měřící script na thank_you page, přecházíme na používání dvou scriptů:

1. Kód pro produktovou stránku
2. Kód pro stránku potvrzení objednávky

Najdete je v administraci Heureky. Doporučujeme scripty z administrace zkopírovat a pouze změnit hodnoty relevantních argumentů.

Implementace přes HTML

Základním postupem pro správné zprovoznění měření konverzí je použití dvou měřících scriptů. Kód pro košík využívá funkci heureka() s několika argumenty. Pořadí volaní této funkce není důležité, ale send musí být zavolán až na konci po všech ostatních funkcích.

Kód pro produktovou stránku

V tomhle scriptu nemusíte nic měnit.

Kód pro stránku potvrzení objednávky

1. Identifikace vašeho e-shopu

   Použitím authenticate metody identifikujete váš e-shop.

2. Vytvoříte novou objednávku

   Použitím set_order_id metody vytvoříte novou objednávku a nastavíte jí ID, které ji přiřadil váš e-shop.

3. Přidáte produkt(y) do objednávky

   Použitím add_product metody přidáte produkty k objednávce. Tato metoda bude volaná tolikrát, kolik je v objednávce produktů. Prosím nepřidávejte položky jako dopravné, dobírka, balné, recyklační poplatek, atd.!

4. (volitelně) Přidáte další neproduktové položky do objednávky

   Použitím add_additional_item metody přidáte další neproduktové položky jako je například dopravné, dobírka, balné, recyklační poplatek, vouchery, slevy, atp. do objednávky. Můžete jí zavolat jednou pro součet všech položek, nebo pro každou jednotlivou položku zvlášť.

5. Nastavení hodnoty objednávky

   Použitím set_total_vat nastavíte celkovou cenu objednávky (včetně DPH nebo bez ní, podle vašich nastavení).

6. Nastavení měny

   Použitím set_currency nastavíte měnu objednávky.
   
   Doporučujeme posílat objednávky již přepočítané do měny portálu ( 'EUR' pro heureka.sk, 'CZK' pro heureka.cz). V opačném případě může při větším objemu dat dojít ke zkreslení statistik v důsledku konverze měn. Pokud se i tak rozhodnete posílat objednávky v rozdílných měnách, musí to být některá z těch námi podporovaných (aktuálně 40 měn dle Evropské centrální banky). Jejich seznam naleznete na této stránce. Kurzy aktualizujeme každý den o půlnoci.
   
   Měna musí být ve formátu ISO 4217 (např. CZK, EUR, USD).
   
   Pokud použijete nepodporovanou měnu nebo neplatnou hodnotu, objednávka bude uložena ve výchozí měně portálu, což může zkreslit statistiky.

7. Odešlete objednávku našemu serveru

   Použitím send potvrdíte celou objednávku a odešlete ji našemu serveru. Toto volání musí být poslední ve scriptu.

Testování předání identifikátoru prokliku při vytvoření objednávky

Pokud chcete lokálně otestovat, zda bude objednávka správně spárována s proklikem uživatele (tj. bude konverzní), postupujte podle následujících kroků:

1. Přidání parametru do URL

   • Do URL adresy na stránce, kde je implementován některý z měřicích scriptů, přidejte parametr hgtid=test (například: https://localhost:4001/order_summary?hgtid=test).
   • Zkontrolujte, zda se vytvořila cookie hg_ocm_id s hodnotou test.

2. Vytvoření objednávky

   • Dokončete proces vytvoření objednávky.

3. Ověření na stránce potvrzení objednávky

   • Na stránce potvrzení objednávky ("thank you page") zkontrolujte, zda byla hodnota této cookie předána v payloadu požadavku.

Tento postup vám pomůže zajistit správné fungování předávání identifikátorů prokliku a jejich správné zpracování v systému.

Nastavení měření konverzí

Zobrazování nákladů a DPH

Toto nastavení určuje, zda se vaše náklady budou zobrazovat s DPH nebo bez ní. Ve výchozím nastavení předpokládáme, že hodnoty zasíláte včetně DPH. Chování lze však upravit na stránce nastavení měření konverzí (kde se k nastavení dostanete také kliknutím na tlačítko „Nastavení“ na stránce statistik). Pokud tuto možnost změníte, náklady se budou zobrazovat bez DPH.

Nastavení by mělo odpovídat formátu, ve kterém nám hodnotu objednávky zasíláte (s DPH nebo bez ní).

Cookies

Služba měření konverzí pracuje s cookie hg_ocm_id , jejíž účel je analytický, a která zajišťuje uložení identifikátoru exitu z Heureka produktového detailu.

Popis metod JavaScriptového kódu

Implementace přes GTM

Implementaci přes Google Tag Manager (GTM) nedoporučujeme, protože bývá často blokován adblockery, což může způsobit nepřesnosti v měření konverzí.

Příklad implementace měření přes GTM uvádíme pro případ standardní implementace datové vrstvy (dataLayer), dle definice pro Google Analytics 4. Pokud máte implementaci datové vrstvy odlišnou, je potřeba přizpůsobit této implementaci příslušné proměnné v tagu “Heureka - Purchase”.

Existují dva způsoby, jak implementovat měření přes GTM:

• Postup uvedený v této dokumentaci.
• Použití šablony GTM - Heureka, která byla vytvořena třetí stranou. Upozorňujeme, že za používání této šablony neneseme žádnou odpovědnost.

Pro implementaci přes GTM neposkytujeme technickou podporu, protože se na tuto oblast nezaměřujeme. Doporučujeme proto implementaci přímo přes kód.

Pro správné měření podle tohoto návodu je nutné vložit dva “Custom HTML” tagy s příslušnými JavaScriptovými kódy.

Tag pro stránku produktového detailu

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

   

2. Přejděte na volbu typu tagu

   

3. Zvolte typ “Custom HTML”

   









4. Do nově založeného tagu zkopírujte příslušný JavaScriptový kód:

   <!-- Heureka.cz 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.cz/ocm/sdk.js?version=2&page=product_detail', 'heureka', 'cz');
   </script>
   <!-- End Heureka.cz PRODUCT DETAIL script -->
   

   

5. Tagu nastavte v “Advanced Settings > Consent Settings” jeho chování vůči Google Consent Mode na volbu “No additional consent required”. Nový měřící skript si hlídá správné chování vůči souhlasu uživatele automaticky sám.

   

6. Zkontrolujte, zda je tag správně nastaven a uložte změny

   

7. Následně tagu přidejte příslušný trigger, který spustí tag ve správnou chvíli, tedy na stránce produktového detailu. Ve standardní implementaci pro Google Analytics 4 využíváme dataLayerovou eventu “view_item”. Pokud používáte jinou implementaci datové vrstvy, příslušně trigger přizpůsobte (např. můžete tag spouštět na trigger typu Page View s podmínkou na typ stránky: “Product” apod.).

   1. Zvolte trigger

      

   2. Vytvořte nový trigger (pluskem v rohu)

      

   3. Zvolte typ triggeru “Custom Event”

      
   
   
   
   
   
   
   
   
   
   

   4. Nastavte trigger na událost “view_item”

      

   5. Zkontrolujte nastavení triggeru a uložte změny

      

Tag pro děkovací stránku po úspěšném nákupu

Tag pro měření konverzí je potřeba spouštět na děkovací stránce po úspěšném nákupu, ve chvíli kdy máme v datové vrstvě potřebná data o transakci. Tato data jsou do tagu předávaná pomocí “dataLayer” proměnných. V příkladu uvádíme “dataLayerové” proměnné odpovídající doporučené Google Analytics 4 implementaci datové vrstvy. Pokud máte strukturu datové vrstvy odlišnou, přizpůsobte použité proměnné ve skriptu.

Pokud v Google Tag Manager kontejneru nemáte ještě založené příslušné proměnné, připravte si je. Budeme potřebovat: ID transakce, hodnotu transakce, měnu transakce, pole produktů v transakci. Dále potřebujete příslušnou “API KEY” pro váš e-shop, kterou získáte v administraci.

Postup založení “DataLayerové” proměnné je pro všechny stejný:

1. V záložce “Proměnné” založte novou proměnnou tlačítkem “New”

   

2. Vyberte typ proměnné “Data Layer Variable”

   

3. Zvolte správný klíč proměnné a dejte proměnné název

   

4. Stejný postup opakujte pro všechny ostatní potřebné proměnné

   











5. Následně založte nový “Custom HTML” tag jako v předchozím případě a vložte do něho následující skript. Ve skriptu nahraďte hodnotu “API KEY” skutečným API klíčem, pokud je potřeba upravte příslušné GTM proměnné dle vašeho nastavení.

   <!-- Heureka.cz 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.cz/ocm/sdk.js?version=2&page=thank_you', 'heureka', 'cz');
       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.cz THANK YOU PAGE script -->

6. Tagu nastavte příslušný trigger, který spustí tag ve vhodnou chvíli, tedy na děkovací stránce ve chvíli kdy máme příslušná data dostupná v datové vrstvě. Při standardní implementaci pro Google Analytics 4 využíváme event “purchase”. Tagu také nastavte chování vůči souhlasu s měřením “No additional consent required”, tag si hlídá souhlasy automaticky sám.

   

   1. Nastavte trigger na událost “purchase”

      

   2. Nastavte consent stejně jako při předchozím triggeru

      

7. Zkontrolujte nastavení tagu a uložte změny

   

8. Po nastavení a uložení tagu je potřeba implementaci zkontrolovat v “Preview módu”. Pokud se tagy spouští a vidíte data odcházet na příslušný koncový bod (https://harvester.ocm.heureka.group/) je vše v pořádku a můžete implementaci publikovat. Tím je implementace měření Heureka konverzí hotová.

   

Problémy s implementací

Pokud jste implementovali nový měřící konverzní skript a na stránce se statistikami se objeví chybová zpráva „Za posledních 7 dní jsme obdrželi XY objednávek s nesprávnými údaji“, znamená to, že některá část vašeho skriptu nefunguje podle očekávání. Existuje několik možných varování a chyb, které můžete obdržet. Závažnost může být buď varování, nebo chyba - varování znamená, že skript funguje podle očekávání, objednávky jsou uloženy, ale některé hodnoty nejsou odesílány správně. Chyba obvykle znamená závažnější problém v implementaci, který může ovlivnit ukládání objednávek. Níže je uveden popis možných hodnot varování a chyb.