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

Popis metod JavaScriptového kódu

Implementace přes GTM

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”.

Pro správné měření 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.