Níže naleznete popis jednotlivých událostí, které v případě připojeného kódu API key pro GTM odesíláme do datové vrstvy. Pro analytiku je tedy mít nutno definován data parametr data-add-gtag příp. URL ekvivalent. Ke každé události je připojena i datová struktura, která se odesílá společně s eventem.
Start formuláře
Tento event se spustí po načtení formuláře. Event vlastně říká, že se zobrazil formulář. Pokud tento event chybí, nedochází k zobrazení formuláře anebo je problém s nastavením GTM a jeho odchytáváním.
Event name: start
Datová struktura:
{
"event": "start",
"page": "default-layout",
...users_custom_props_from_BH
}
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Výběr data v kalendářích
Tento event se spustí po vybrání data odjezdu na kterémkoliv z obou dostupných kalendářů. Lze z něj vytěžit data o nejvyhledávanejších termínech.
Event name: selectDate
Datová struktura:
{
"event": "selectDate",
"language": "cs",
"arrival": "2024-12-01",
"departure": "2024-12-05",
"guests": 3,
"page": "/index",
...users_custom_props_from_BH
}
- language - jazyk v ISO 639-2
- guests - celkový počet hostů
- arrival/departure - datum ve formátu YYYY-MM-DD
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Přechod z kroku 1 na krok 2
Přechod po výběru v kalendáři na view, kde lze doplnit služby, balíčky, pojištění apod. Tento event v podstatě říká, že došlo na kroku 1 (výběr roomtypu) k výběru pokoje, resp. kliknutí na CTA tlačítko Rezervovat.
Event name: formSentStep1
Datová struktura:
{
"event": "formSentStep1",
"language": "cs",
"currency": "CZK",
"package": 99,
"roomTypes": "Jednolůžkový pokoj, Dvoulůžkový pokoj",
"food": "1, 2",
"rooms": 3,
"guests": 3,
"total": 9999,
"page": "/summary",
…users_custom_props_from_BH
}
- language - jazyk v ISO 639-2
- currency - měna v ISO 4217
- package - ID balíčků
- roomTypes - názvy jednotlivých položek
- food - ID stravy
- rooms - počet pokojů
- guests - počet hostů
- total - cena rezervace v příslušné měně
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Výběr balíčku na kroku 2
Ve stejném kroku lze udělat upsell balíčku (je-li toto povoleno v nastavení). Při přidání balíčku navíc do rezervace v mezikroku 2 přidá balíček a odešle se tato událost, která informuje o tom, který konkrétní balíček byl přidán k rezervaci.
Event name: packageUpsale
Datová struktura:
{
"event": "packageUpsale",
"language": "cs",
"currency": "CZK",
"package": "Silvestrovský pobyt",
"roomTypes": "Jednolůžkový pokoj",
"food": 1,
"guests": 3,
"total": 9999,
"price_delta": "2000",
"page": "/summary",
…users_custom_props_from_BH
}
- language - jazyk v ISO 639-2
- currency - měna v ISO 4217
- package - jméno balíčku
- roomTypes - názvy jednotlivých položek
- food - ID stravy
- guests - počet hostů
- total - cena rezervace v příslušné měně
- price_delta - cena navíc pro balíček
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Úspěšné dokončení rezervace
Tento event je v podstatě událost pro měření konverzí. Znamená to, že došlo ke koupi. Při platbě na místě dojde k odeslání této události ihned, při platbě na platební bráně až po ověření platby systémem BH. Tj. systém musí ověřit platbu, pokud se platba nepovede ověřit, tato událost není odeslána.
Event name: finishBooking
Datová struktura:
{
"event": "finishBooking",
"language": "cs",
"paymentId": "1234562",
"reservation": [Object rezervace],
"page": "/thanks",
...users_custom_props_from_BH
}
- language - jazyk v ISO 639-2
- paymentId - ID transakce
- reservation - objekt rezervace (popsán níže)
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Neúspěšná kontrola platby systémem BH
Tento event informuje o tom, že se systému BH nepodařilo ověřit platbu po rezervaci.
Upozornění: tento event se odesílá pouze v případě, že systém BH není schopen ověřit platbu. Neposílá se v případě selhání nebo zrušení platby zákazníkem na samotné bráně, nebo technickými potížemi, které jsou mimo naši kontrolu (typicky na platební bráně).
Event name: paymentFail
Datová struktura:
{
"event": "paymentFail",
"language": "cs",
"currency": "CZK",,
"total": 9999,
"paymentId": "123456",
"paymentState": "success",
"reservation": [Object rezervace],
"payment": [Object platby],
"arrival": "2024-12-01",
"departure": "2024-12-05",
"error": "Chybová hláška",
"page": "/paygate-return",
...users_custom_props_from_BH
}
- language - jazyk v ISO 639-2
- currency - měna v ISO 4217
- total - cena rezervace v příslušné měně
- paymentId- ID transakce
- paymentState - stav ověřování platby success/failed/pending
- reservation - objekt rezervace (popsán níže)
- payment - objekt platby (popsán níže)
- arrival/departure - datum ve formátu YYYY-MM-DD
- error - chybová hláška - je-li k dispozici
- users_custom_props_from_BH - jakékoliv další proměnné, které si klienti mohou přidat v nastavení pro konverzní kódy z BH
Úspěšné dokončení koupě voucheru
Tento event je v podstatě událost pro měření konverzí. Znamená to, že došlo ke koupi voucheru. Při platbě na místě dojde k odeslání této události ihned, při platbě na platební bráně až po ověření platby systémem BH. Tj. systém musí ověřit platbu, pokud se platba nepovede ověřit, tato událost není odeslána
Event name: finishVoucherBooking
Datová struktura:
{
"event": "finishVoucherBooking",
"language": "cs",
"currency": "CZK",
"paymentId": "123456",
"voucher": [Object voucheru],
"payment": [Object platby],
"page": "/ive"
}
- language - jazyk v ISO 639-2
- currency - měna v ISO 4217
- paymentId- ID transakce
- voucher - objekt voucheru (popsán níže)
- payment - objekt platby (popsán níže)
Neúspěšná kontrola platby voucheru systémem BH
Tento event informuje o tom, že se systému BH nepodařilo ověřit platbu za voucher.
Upozornění: tento event se odesílá pouze v případě, že systém BH není schopen ověřit platbu. Neposílá se v případě selhání nebo zrušení platby zákazníkem na samotné bráně, nebo technickými potížemi, které jsou mimo naši kontrolu (typicky na platební bráně)
Event name: paymentVoucherFail
Datová struktura:
{
"event": "paymentVoucherFail",
"language": "cs",
"currency": "CZK",
"paymentId": "123456",
"voucher": [Object voucheru],
"payment": "card",
"error": "Chybová hláška",
"page": "/paygate-return-ive"
}
- language - jazyk v ISO 639-2
- currency - měna v ISO 4217
- paymentId- ID transakce
- voucher - objekt voucheru (popsán níže)
- payment - metoda platby
- error - chybová hláška - je-li k dispozici
Podobjekty
Kvůli repetitivnosti kódu v příkladech jsou níže uvedeny příklady dat odesílaných spolu s příslušnými event. V kód viz výše je použita pouze zkratka [Object object]
Rezervace
Pole jednotlivých rezervací (roomtypes), zde jsou základní údaje o objednané službě.
[
{
"packages_id": 0,
"rates_id": 2,
"foods": [
0
],
"persons": 1,
"price": 17618,
"room_types_id": 4613,
"storno_conditions_id": 127,
"guest_list": {
"0": {
"guest_type_id": 1,
"food_id": 0
}
}
}
]
- packages_id - ID balíčku
- rates_id - ID raty
- foods - ID stravy
- persons - počet hostů v konkrétní rezervaci pokoje
- price - celková cena za pokoj
- room_types_id - ID pokoje (roomtype)
- storno_conditions_id - ID storno podmínek
- guest_list - objekt jednotlivých hostů (ID kategorie hosta a vybrané stravy)
Platba
Informace o způsobu platby a zda-li a jak byla placena záloha.
{
"depositModel": null,
"paymentModel": "card"
}
- depositModel - transfer/card - metoda platby zálohy
- paymentModel - cash/card - metoda platby rezervace
Voucher
Základní informace o objednaném voucheru.
{
"id": 217,
"name": {
"cs": "Voucher na 1500Kč",
},
"dynamic_price": 0,
"currency": "CZK",
"valid_from": "2020-04-01",
"valid_to": "2020-06-30",
"able_from": null,
"able_to": null,
"price": 4000
}
- name - název voucheru v jazykové mutaci
- dynamic_price - {boolean} - zda se jedná o otevřený voucher (1 ano, 0 ne)
- currency - měna v ISO 4217
- valid_from - platnost voucheru od - formát YYYY-MM-DD
- valid_to - platnost voucheru do - formát YYYY-MM-DD
- able_from - využitelnost voucheru od - formát YYYY-MM-DD
- able_from - využitelnost voucheru do - formát YYYY-MM-DD
- price - cena voucheru