Přeskočit obsah

Trackování E-commerce

Nasazení

Měřící kód slouží k pokročilému měření návštěv a konverzí na vašem webu/e-shopu. Pro nasazení je nutné jednoduše umístit HTML kód na všechny stránky, podobně jako jste zvyklí z jiných měřících systémů, např. Google Analytics.

Implementace probíhá obdobně jako u kódu pro Google Analytics. Měřící kód je tedy nutné umístit před uzavírající </body> tag, na každé stránce vašeho webu:

<script type="text/javascript">
var Colpirio = Colpirio || [];
(function() {
var d=document, trg=d.createElement('script'); trg.type='text/javascript'; trg.async=true; trg.defer=true;
trg.src='https://cdn.colpirio.com/tracker.js';
var s = d.getElementsByTagName('script')[0]; s.parentNode.insertBefore(trg, s);
})();
Colpirio.push(['siteId', '<SITE_ID>']);
</script>

Vysvětlivky k jednotlivým parametrům:

  • site_id: Unikátní identifikátor webu/e-shopu.

Výhodou výše uvedeného HTML kódu je asynchronní způsob komunikace s Colpirio, díky které nijak nezpomaluje načtení webu.

Měřící kód je možné nasadit i přes Google Tag Manager nebo jiný obdobný nástroj. To představuje alternativu k implementaci přímo do kódu stránky.

Doplňkové skripty

Doplňkové skripty se starají o trackování chování jednotlivých uživatelů na míru. Všechny tyto skripty se umístí na stránce hned pod řídící skript.

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Product', 'View', {
'item': '<PRODUCTID>',
'price': <PRICE>,
'price_vat': <PRICE_VAT>,
'brand': '<BRAND>',
'category': '<CATEGORYID>'
}]);
</script>

Příklad

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Product', 'View', {
'item': '391202',
'price': 11561.98,
'price_vat': 13990.00,
'brand': 'apple',
'category': 'mobile'
}]);
</script>

Ve skriptu nahraďte PRODUCTID vždy hodnotou ITEM_ID, používanou u navštíveného produktu v XML feedu. Ostatní položky (price, price_vat, brand a category) jsou nepovinné.

Umístit na stránku detailu kategorie:

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Category', 'View', {'id': '<CATEGORYID>'}]);
</script>

Ve skriptu nahraďte CATEGORYID vždy hodnotou ID kategorie, která je právě navštívena.

Aktualizace nákupního košíku

Skript trackující obsah nákupního košíku je nutné zobrazit na jakékoliv stránce, vždy po vykonání některé z následujících akcí:

  • Uživatel přidal produkt do košíku
  • Uživatel odebral produkt z košíku
  • Uživatel změnil počet položek u některého produktu v košíku
<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Cart', 'Update', {
'items': ['<PRODUCTID_1>', '<PRODUCTID_2>', ],
'quantity': [<PRODUCT_1_QUANTITY>, <PRODUCT_2_QUANTITY>, ],
'prices': [<PRODUCT_1_PRICE>, <PRODUCT_2_PRICE>, ],
'prices_vat': [<PRODUCT_1_VAT>, <PRODUCT_2_VAT>, ],
'total': <TOTAL_PRICE>,
'total_vat': <TOTAL_VAT>
}]);
</script>

Vysvětlivky k jednotlivým parametrům:

  • total: celková cena za celou objednávku bez DPH
  • total_vat: celková cena za celou objednávku vč. DPH
  • items: pole obsahující identifikatory produktu.
  • prices: jednotková cena za produkt bez DPH
  • prices_vat: jednotková cena za produkt vč. DPH
  • quantity: počet položek odpovídajícího produktu v košíku

Příklad

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Cart', 'Update', {
'items': ['391202', '101729'],
'quantity': [2, 1],
'prices': [11561.98, 100.00],
'prices_vat': [13990.00, 121.00],
'total': 11561.98,
'total_vat': 13990.00
}]);

</script>

Tato ukázka kódu představuje zaznamenání situace, kdy uživatel měl v nákupním košíku 2ks produktu s ID 391202 a 1ks produktu s ID 101729.

Dokončení nákupu

Skript zaznamenávající dokončení nákupu se přidá pouze na děkovací stránku po dokončení (a zaplacení) objednávky.

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['trackEvent', 'Ecommerce', 'Order', 'Create', {
'order': '<ORDER_ID>',
'items': ['<PRODUCTID_1>', '<PRODUCTID_2>', ],
'quantity': [<PRODUCT_1_QUANTITY>, <PRODUCT_2_QUANTITY>, ],
'prices': [<PRODUCT_1_PRICE>, <PRODUCT_2_PRICE>, ],
'prices_vat': [<PRODUCT_1_VAT>, <PRODUCT_2_VAT>, ],
'total': <TOTAL_PRICE>,
'total_vat': <TOTAL_VAT>
}]);
</script>

Předpokládá se, že tomuto volání předcházelo alespoň jedno volání Aktualizace nákupního košíku.

Párování uživatelů


Pro párování uživatelů stačí vložit na libovolnou stránku, která zná (přihlášeného) uživatele, následující kód:

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['pair', '<SITE_USER_ID>', '<SITE_ORIGIN>']);
</script>

Vysvětlivky k jednotlivým parametrům:

  • site_user_id: Libovolné ID koncového uživatele (například e-mailová adresa, login name). Na straně prohlížeče je site_user_id hashovano a není tedy nikdy přenášeno a ukládáno v čitelné formě.
  • site_origin: Normalizovaná doména webu/e-shopu, pro rozlišení stejných uživatelů různých webů/e-shopů (například kasa_cz a profizoo_cz).

Příklad

<script type="text/javascript">
var Colpirio = Colpirio || [];
Colpirio.push(['pair', 'petr.novak@seznam.cz', 'profizoo_cz']);
</script>

Hashing se provadi nasledovně

import {SHA256} from "crypto-js";
external_id = SHA256(ANY_USER_ID.toLowerCase()).toString()

Do systému Colpirio se odesílá až výsledný hash (external_id). Pomocí takto konstruovaného external_id lze potom dotazovat Colpirio API.