Nápověda menu

Reference událostí

Kompletní přehled všech podporovaných SEM událostí, jejich parametrů a kódových ukázek. Události se odesílají metodou SEM('track', 'NázevUdálosti', data).

Základní pravidla
Měna musí být vždy CZK. Ostatní měny přepočítejte před odesláním. Parametr value je vždy bez DPH (cena produktů celkem). Ceny dopravy (delivery_price), dalších nákladů (other_costs) a cena za kus (unit_price) jsou včetně DPH.

Přehled všech událostí

Název v rozhraníUdálostPovinnéDoporučené
Zobrazení stránkyPageView
Zobrazení obsahuViewContentcontent_typecurrencyvaluecontents
Přidání do košíkuAddToCartcurrencyvaluecontents
Přidání do wishlistuAddToWishlistcurrencyvaluecontents
Zahájení objednávkyInitiateCheckoutcurrencyvaluecontents
Přidání platebních údajůAddPaymentInfocurrencyvaluecontents
NákupPurchaseorder_idcurrencyvaluevalue_taxcontent_typecontentsreview_emaildelivery_typedelivery_price
VyhledáníSearchsearch_string
Získání kontaktuLeadcurrencyvalue
Dokončení registraceCompleteRegistrationstatuscurrencyvalue
Přihlášení k odběruSubscribecurrencyvaluepredicted_ltv
Zahájení zkušební verzeStartTrialcurrencyvaluepredicted_ltv
KontaktContact
Naplánování událostiSchedule
DarováníDonate
Přizpůsobení produktuCustomizeProduct
Odeslání žádosti/přihláškySubmitApplication

PageView

Odesílejte na každé stránce webu. Základní skript volá PageView automaticky. U SPA aplikací (React, Vue atd.) volejte událost manuálně při každé změně routy.

PageView se také využívá pro dynamický retargeting produktů – pokud k události přidáte content_type: 'product' a ID produktu v poli contents.

// Základní PageView (automaticky voláno skriptem)
SEM('track', 'PageView');

// PageView s daty produktu (pro DRTG)
SEM('track', 'PageView', {
  content_type: 'product',
  currency: 'CZK',  // podporováno pouze CZK
  value: 27677,         // bez DPH
  contents: [{
    id: 'ABC12345',
    quantity: 1,
    unit_price: 33490,    // s DPH
    content_name: 'iPhone 15 Pro Max',
    content_category: 'Elektronika | Mobilní telefony | Apple'
  }]
});

ViewContent

Odesílejte při zobrazení stránky produktu nebo stránky kategorie. Klíčová událost pro dynamický retargeting – pomocí content_type rozlišujete, zda jde o produkt nebo kategorii.

Párové parametry
value a currency musí být vždy zasílány společně. Stejně tak contents a content_type – jedno bez druhého nestačí.

ParametrTypPovinnostPříkladPopis
content_typestringDoporučený'product'Typ obsahu: product pro detail produktu, product_group pro kategorii, page pro ostatní stránky
currencystringDoporučený'CZK'Vždy CZK. Ostatní měny přepočítejte.
valuenumberDoporučený33490Celková hodnota košíku v CZK bez DPH
contentsarrayDoporučenýviz ukázkaPole produktů. Viz popis objektu Contents[] níže.

Detail produktu

SEM('track', 'ViewContent', {
  content_type: 'product',
  currency: 'CZK',  // podporováno pouze CZK
  value: 27677,          // bez DPH
  contents: [{
    id: 'ABC12345',
    quantity: 1,
    unit_price: 33490,      // s DPH
    content_name: 'iPhone 15 Pro Max',
    content_category: 'Elektronika | Mobilní telefony | Apple'
  }]
});

Kategorie

// Pro stránku kategorie – content_type musí být 'product_group'
SEM('track', 'ViewContent', {
  content_type: 'product_group',
  currency: 'CZK',  // podporováno pouze CZK
  value: 0,
  contents: [{
    content_category: 'Elektronika | Mobilní telefony | Apple'  // kategorie pro DRTG
  }]
});

AddToCart a AddToWishlist

Odesílejte při přidání produktu do košíku (AddToCart) nebo do oblíbených (AddToWishlist). Struktura dat je pro obě události identická.

ParametrTypPovinnostPříkladPopis
currencystringDoporučený'CZK'Vždy CZK
valuenumberDoporučený33490Celková hodnota košíku v CZK bez DPH
contentsarrayDoporučenýviz ukázkaPřidané produkty. Viz Contents[].
SEM('track', 'AddToCart', {  // nebo 'AddToWishlist'
  currency: 'CZK',  // podporováno pouze CZK
  value: 27677,          // bez DPH
  contents: [{
    id: 'ABC12345',
    content_name: 'iPhone 15 Pro Max',
    content_category: 'Elektronika | Mobilní telefony | Apple',
    quantity: 1,
    unit_price: 33490      // s DPH
  }]
});

InitiateCheckout a AddPaymentInfo

Odesílejte při zahájení procesu objednávky (InitiateCheckout) a při zadání platebních údajů (AddPaymentInfo). Umožňují měřit míru opuštění košíku.

SEM('track', 'InitiateCheckout', {  // nebo 'AddPaymentInfo'
  currency: 'CZK',  // podporováno pouze CZK
  value: 28090,          // bez DPH
  contents: [
    {
      id: 'ABC12345',
      quantity: 1,
      content_name: 'iPhone 15 Pro Max',
      content_category: 'Elektronika | Mobilní telefony | Apple',
      unit_price: 33490      // s DPH
    },
    {
      id: 'KRYT999',
      quantity: 1,
      content_name: 'Ochranný kryt',
      content_category: 'Elektronika | Příslušenství | Kryty na telefon',
      unit_price: 500        // s DPH
    }
  ]
});

Purchase

Nejdůležitější e-commerce událost – odesílejte ihned po dokončení objednávky na stránce potvrzení. Obsahuje kompletní data objednávky včetně produktů, dopravy a platby.

review_email musí být nehashovaný
Parametr review_email slouží pro odesílání dotazníku spokojenosti Zboží.cz. Na rozdíl od ostatních e-mailových údajů jej nehashujte. Zasílejte jej jen pokud uživatel nevyjádřil nesouhlas se zasíláním dotazníků.

ParametrTypPovinnostPříkladPopis
order_idstringPovinný'OBJ-987654'Unikátní číslo objednávky. Slouží k deduplikaci.
currencystringPovinný'CZK'Vždy CZK
valuenumberPovinný27364Celková hodnota košíku v CZK bez DPH
value_taxnumberDoporučený5746DPH z hodnoty value
content_typestringDoporučený'product'Vždy product u nákupu produktů
contentsarrayDoporučenýviz ukázkaZakoupené produkty. Viz Contents[].
review_emailstringDoporučený'jan@email.cz'⚠️ NEHASHOVAT. E-mail pro dotazník Zboží.cz.
delivery_typestringDoporučený'CESKA_POSTA'Způsob dopravy dle DELIVERY_ID z XML feedu
delivery_pricenumberDoporučený121Cena dopravy včetně DPH v CZK
payment_typestringVolitelný'karta'Způsob platby – libovolný řetězec
other_costsnumberVolitelný-500Další náklady/slevy včetně DPH. Slevy = záporné číslo.
SEM('track', 'Purchase', {
  content_type: 'product',
  currency: 'CZK',  // podporováno pouze CZK
  order_id: 'OBJ-987654',
  review_email: 'zakaznik@email.cz',  // ⚠️ NEHASHOVAT
  value: 27364,          // celková hodnota bez DPH (v CZK)
  value_tax: 5746,       // hodnota DPH (v CZK)
  delivery_type: 'CESKA_POSTA',
  delivery_price: 121,    // doprava včetně DPH
  other_costs: -500,     // sleva včetně DPH (záporné číslo)
  payment_type: 'karta',
  contents: [
    {
      id: 'ABC12345',
      quantity: 1,
      content_name: 'iPhone 15 Pro Max',
      content_category: 'Elektronika | Mobilní telefony | Apple',
      unit_price: 33490      // s DPH
    }
  ]
});

Odesílejte při každém vyhledávání na webu. Umožňuje cílit retargeting na uživatele hledající konkrétní produkty.

SEM('track', 'Search', {
  search_string: 'bezdrátová sluchátka'
});

Lead, CompleteRegistration, Subscribe, StartTrial

Události pro non-e-commerce weby – lead generation, registrace, předplatné.

Lead

SEM('track', 'Lead', {
  currency: 'CZK',  // podporováno pouze CZK
  value: 500       // odhadovaná hodnota leadu
});

CompleteRegistration

SEM('track', 'CompleteRegistration', {
  status: true,    // true = úspěšná registrace
  currency: 'CZK',  // podporováno pouze CZK
  value: 0
});

Subscribe / StartTrial

SEM('track', 'Subscribe', {  // nebo 'StartTrial'
  currency: 'CZK',  // podporováno pouze CZK
  value: 199,           // cena předplatného (bez DPH)
  predicted_ltv: 2400  // odhadovaná celoživotní hodnota zákazníka
});

Ostatní události

Tyto události nemají povinné parametry a slouží pro měření specifických interakcí.

UdálostKdy použít
ContactUživatel kontaktoval firmu (telefon, chat, e-mail)
CustomizeProductUživatel přizpůsobil produkt (barva, konfigurace)
DonateDar na charitativní účel
ScheduleRezervace termínu (kadeřnictví, lékař…)
SubmitApplicationOdeslání žádosti nebo přihlášky
// Bez parametrů
SEM('track', 'Contact');

// S volitelnou hodnotou
SEM('track', 'Schedule', {
  currency: 'CZK',  // podporováno pouze CZK
  value: 1000
});

Objekt produktu contents[]
Parametry jednotlivých produktů předávaných v poli contents jsou popsány na samostatné stránce Objekt produktů – contents.

Potřebujete další pomoc?

Pokud si stále nevíte rady, obraťte se na naše specialisty. 95 % vašich dotazů umíme vyřešit do 2 hodin.