Reference událostí
- PageView
- ViewContent
- AddToCart a AddToWishlist
- InitiateCheckout a AddPaymentInfo
- Purchase
- Lead, CompleteRegistration, Subscribe, StartTrial
- Ostatní události
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álost | Povinné | Doporučené |
|---|---|---|---|
| Zobrazení stránky | PageView | – | – |
| Zobrazení obsahu | ViewContent | – | content_type, currency, value, contents |
| Přidání do košíku | AddToCart | – | currency, value, contents |
| Přidání do wishlistu | AddToWishlist | – | currency, value, contents |
| Zahájení objednávky | InitiateCheckout | – | currency, value, contents |
| Přidání platebních údajů | AddPaymentInfo | – | currency, value, contents |
| Nákup | Purchase | order_id, currency, value | value_tax, content_type, contents, review_email, delivery_type, delivery_price |
| Vyhledání | Search | – | search_string |
| Získání kontaktu | Lead | – | currency, value |
| Dokončení registrace | CompleteRegistration | – | status, currency, value |
| Přihlášení k odběru | Subscribe | – | currency, value, predicted_ltv |
| Zahájení zkušební verze | StartTrial | – | currency, value, predicted_ltv |
| Kontakt | Contact | – | – |
| Naplánování události | Schedule | – | – |
| Darování | Donate | – | – |
| Přizpůsobení produktu | CustomizeProduct | – | – |
| Odeslání žádosti/přihlášky | SubmitApplication | – | – |
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é parametryvalue a currency musí být vždy zasílány společně. Stejně tak contents a content_type – jedno bez druhého nestačí.
| Parametr | Typ | Povinnost | Příklad | Popis |
|---|---|---|---|---|
content_type | string | Doporučený | 'product' | Typ obsahu: product pro detail produktu, product_group pro kategorii, page pro ostatní stránky |
currency | string | Doporučený | 'CZK' | Vždy CZK. Ostatní měny přepočítejte. |
value | number | Doporučený | 33490 | Celková hodnota košíku v CZK bez DPH |
contents | array | Doporučený | viz ukázka | Pole 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á.
| Parametr | Typ | Povinnost | Příklad | Popis |
|---|---|---|---|---|
currency | string | Doporučený | 'CZK' | Vždy CZK |
value | number | Doporučený | 33490 | Celková hodnota košíku v CZK bez DPH |
contents | array | Doporučený | viz ukázka | Př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ů.
| Parametr | Typ | Povinnost | Příklad | Popis |
|---|---|---|---|---|
order_id | string | Povinný | 'OBJ-987654' | Unikátní číslo objednávky. Slouží k deduplikaci. |
currency | string | Povinný | 'CZK' | Vždy CZK |
value | number | Povinný | 27364 | Celková hodnota košíku v CZK bez DPH |
value_tax | number | Doporučený | 5746 | DPH z hodnoty value |
content_type | string | Doporučený | 'product' | Vždy product u nákupu produktů |
contents | array | Doporučený | viz ukázka | Zakoupené produkty. Viz Contents[]. |
review_email | string | Doporučený | 'jan@email.cz' | ⚠️ NEHASHOVAT. E-mail pro dotazník Zboží.cz. |
delivery_type | string | Doporučený | 'CESKA_POSTA' | Způsob dopravy dle DELIVERY_ID z XML feedu |
delivery_price | number | Doporučený | 121 | Cena dopravy včetně DPH v CZK |
payment_type | string | Volitelný | 'karta' | Způsob platby – libovolný řetězec |
other_costs | number | Volitelný | -500 | Další 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
}
]
});
Search
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álost | Kdy použít |
|---|---|
Contact | Uživatel kontaktoval firmu (telefon, chat, e-mail) |
CustomizeProduct | Uživatel přizpůsobil produkt (barva, konfigurace) |
Donate | Dar na charitativní účel |
Schedule | Rezervace termínu (kadeřnictví, lékař…) |
SubmitApplication | Odeslá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.