Přeskočit obsah

Nasazení

Nasazení pro ecommerce Nasazení pro weby

Měřící kód slouží k pokročilému měření návštěv a konverzí na vašem 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(['shopId', '<SHOP_ID>']);
Colpirio.push(['shopOrigin', '<SHOP_ORIGIN>']);
</script>

Vysvětlivky k jednotlivým parametrům:

  • shop_id: Unikátní identifikátor shopu.
  • shop_origin: Normalizovaná doména shopu, kde tečka se nahradí za podtržítko, pomlčka zůstává. (například kasa_cz, profizoo_cz).

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">
 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">
  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é.

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

Ve skriptu nahraďte ITEMGROUP_ID vždy hodnotou ITEMGROUP_ID, používanou u skupiny produktů, které vzájemně představují varianty v XML feedu.

Umístit na stránku detailu kategorie:

<script type="text/javascript">
  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.

Zobrazení článku

<script type="text/javascript">
  Colpirio.push(['trackEvent', 'Content', 'Article', 'View', {'id': '<ARTICLEID>'}]);
</script>

Ve skriptu nahraďte ARTICLEID vždy hodnotou guid, používanou v RSS feedu článků.

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

Měření konverzí


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

Postup implementace

<script type="text/javascript">
  Colpirio.push(['trackData', 'conversion', {"type": "<User defined string>", "cid": <CID>}]);
</script>

Vysvětlivky k jednotlivým parametrům:

  • type je libolný text popisují konverzi,
  • cid je identifikátor konverze, který klient obdrží od Colpirio.

Příklad

<script type="text/javascript">
    Colpirio.push(['trackData', 'conversion', {"type": "Registrace", "cid": 5000798}]);
</script>

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>
var Colpirio = Colpirio || [];
Colpirio.push(['pair', '<SHOP_USER_ID>', '<SHOP_ORIGIN>']);
</script>

Vysvětlivky k jednotlivým parametrům:

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

Příklad

<script type="text/javascript">
    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.