Integrácia GTM Analytics

Môžete pripojiť akýkoľvek kontajner Google Tag Manager (GTM) k Wink zadaním jeho GTM Container ID v portáli Wink. Po pripojení sa váš kontajner automaticky načíta pre vašu nehnuteľnosť a priamo číta rezervačné udalosti Wink — pokrývajúc celú cestu hosťa od vyhľadávania až po dokončenú rezerváciu. Bežným prípadom použitia je kontajner Sojern pre retargeting a reklamu, ale akýkoľvek GTM kontajner funguje rovnako.

Tip

Predpokladá sa, že už máte GTM Container ID (formát GTM-XXXXXXX). Ak váš kontajner pochádza od partnera, ako je Sojern, požiadajte svojho manažéra účtu o GTM Container ID — je odlišné od pixelu alebo ID tagu. Ste noví v Sojern? Navštívte sojern.com/contact a začnite.

---

Čo musíte urobiť

1. Získajte svoje GTM Container ID

   Získajte svoje GTM Container ID (formát GTM-XXXXXXX). Ak pochádza od partnera, ako je Sojern, vyžiadajte si špecificky GTM Container ID — je odlišné od pixelu alebo ID tagu.

2. Zadajte ho do portálu Wink

   Prihláste sa do app.wink.travel, vyberte svoj účet a prejdite na kartu Prispôsobenia. Vložte svoje GTM Container ID do poľa GTM a uložte. Vaša integrácia je teraz aktívna.

3. (Voliteľné) Pridajte GA4 Measurement ID + API Secret pre serverovú evidenciu nákupov

   GTM kontajnery bežia úplne v prehliadači hosťa, takže dokončená rezervácia môže byť prehliadnutá, ak hosť zatvorí kartu počas presmerovania na platbu. Ak váš kontajner načítava GA4 property a chcete spoľahlivo zaznamenávať dokončené rezervácie, zadajte tiež GA4 Measurement ID a Measurement Protocol API secret v sekcii GTM. Wink potom odošle purchase pre túto property serverovo, presne ako je popísané v návode GA4 Analytics Integration. Ak potrebujete len sledovanie v prehliadači, nechajte tieto polia prázdne.

4. Potvrďte u svojho poskytovateľa

   Ak váš kontajner pochádza od partnera, ako je Sojern, informujte svojho manažéra účtu, že integrácia je aktívna. Môžu overiť zo svojej strany, že tagy sa správne spúšťajú na wink.travel pre vašu nehnuteľnosť a že dáta prúdia do vášho účtu.

Poznámka

Pre túto integráciu nemusíte na svojej webovej stránke umiestňovať žiadny pixelový kód. Wink automaticky načíta váš GTM kontajner na všetkých stránkach, kde je vaša nehnuteľnosť aktívna.

Toto funguje pre akýkoľvek GTM Container ID — Sojern je len bežný príklad.

---

Čo Wink robí na našej strane

Pre transparentnosť, toto Wink konfiguruje, aby táto integrácia fungovala:

• Pole GTM Container ID je dostupné na karte Prispôsobenia vo vašom portáli Wink. Keď zadáte svoje Container ID, Wink overí formát (GTM-XXXXXXX) a bezpečne ho uloží k vašej nehnuteľnosti.
• Na každej stránke, kde je vaša nehnuteľnosť aktívna na Wink, sa váš kontajner priamo vloží do stránky — zdieľajúc Wink vlastný window.dataLayer — takže sa načíta spolu s Wink kontajnerom bez závislosti na ďalšej konfigurácii. Toto sa deje automaticky, bez potreby práce tímu Wink pre každú nehnuteľnosť.
• Váš kontajner sa načítava asynchrónne, takže neovplyvňuje výkon načítania stránky pre vašich hostí.
• Sledovanie Wink a váš kontajner bežia paralelne, čítajúc z rovnakého zdieľaného dataLayer. Každá rezervačná udalosť, ktorú Wink sleduje, je zároveň dostupná vášmu kontajneru.
• Keď sa vaša nehnuteľnosť neprezerá — napríklad keď hosť prehliada iný hotel na Wink — váš kontajner sa nenačíta, takže dostáva len dáta relevantné pre vašu nehnuteľnosť.
• Ak ste zadali GA4 Measurement ID + API secret (krok 3 vyššie), purchase pre dokončené rezervácie sa navyše odosiela serverovo cez GA4 Measurement Protocol, takže predaj je zaznamenaný aj v prípade, že hosť sa nikdy nevráti na stránku potvrdenia.

---

Referencia DataLayer

Wink posiela GA4-kompatibilné udalosti do dataLayer počas celej cesty hosťa. Váš GTM kontajner číta z toho istého zdieľaného dataLayer, takže každý trigger alebo premenná, ktorú nastavíte, má prístup ku všetkým nižšie popísaným vlastnostiam.

Každá udalosť nasleduje štandardnú štruktúru GA4 Enhanced Ecommerce: reťazec event na najvyššej úrovni a objekt ecommerce. Pred každým pushom Wink vymaže predchádzajúce ecommerce dáta, aby zabránil prenikaniu starých dát do nových triggerov.

Poznámka

Vzor resetovania dataLayer

Wink resetuje ecommerce objekt pred každým pushom udalosti:

dataLayer.push({ ecommerce: null });   // vyčistí predchádzajúcu udalosť
dataLayer.push({ event: '...', ecommerce: { ... } });

Nespoliehajte sa na pretrvávanie ecommerce vlastností medzi udalosťami. Vždy ich čítajte v čase spustenia triggera v rámci tej istej udalosti.

---

Udalosti cesty rezervácie

Tieto udalosti sa spúšťajú automaticky, keď hosť prechádza rezervačným procesom. Nastavte svoje GTM triggery ako Custom Event triggery zodpovedajúce nižšie uvedeným názvom udalostí.

Krok	Udalosť	Kedy sa spúšťa
1	view_item_list	Načítanie mriežky alebo zoznamu hotelovej ponuky
2	view_item	Hosť si prezerá konkrétnu stránku nehnuteľnosti
3	add_to_cart	Hosť pridá izbu do košíka
4	begin_checkout	Načítanie stránky pokladne / platby
5	add_payment_info	Hosť vyberie spôsob platby
6	login	Hosť sa autentifikuje cez SSO
7	purchase	Rezervácia je potvrdená
8	refund	Rezervácia je zrušená

---

view_item_list

Spúšťa sa, keď sa zobrazí mriežka alebo zoznam hotelovej ponuky.

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

---

view_item

Spúšťa sa, keď hosť prezerá konkrétnu nehnuteľnosť.

{
  "event": "view_item",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

add_to_cart

Spúšťa sa, keď hosť pridá izbu do košíka.

{
  "event": "add_to_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

---

begin_checkout

Spúšťa sa, keď sa načíta stránka pokladne / platby.

{
  "event": "begin_checkout",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "items": [ ]
  }
}

coupon je prítomný len v prípade, že bol použitý zľavový kód.

---

add_payment_info

Spúšťa sa, keď hosť vyberie alebo potvrdí spôsob platby.

{
  "event": "add_payment_info",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "coupon": "SUMMER10",
    "payment_type": "STRIPE",
    "items": [ ]
  }
}

payment_type je vyplnený podľa typu platobného akceptora. coupon je prítomný len v prípade, že bol použitý zľavový kód.

---

login

Spúšťa sa, keď sa hosť autentifikuje cez single sign-on.

{
  "event": "login",
  "ecommerce": {
    "method": "IAM"
  }
}

---

purchase

Spúšťa sa, keď je rezervácia potvrdená.

{
  "event": "purchase",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [
      {
        "item_id": "rr-xyz789",
        "item_name": "Deluxe Ocean Suite",
        "item_brand": "Grand Resort",
        "item_category": "GUEST_ROOM",
        "price": 299.00,
        "quantity": 1,
        "property_id": "prop-abc123",
        "property_name": "Grand Resort Maldives",
        "property_brand": "Grand Collection",
        "property_chain": "Luxury Hotels International",
        "city_name": "Malé",
        "country_code": "MV",
        "start_date": "2026-06-01",
        "end_date": "2026-06-05",
        "num_adults": 2,
        "num_children": 0,
        "cancellation_policy": "Refundable",
        "rate_plan_id": "rp-summer2026",
        "room_rate_id": "rr-xyz789",
        "room_rate_name": "Summer Escape — Bed & Breakfast",
        "num_perks": 2,
        "room_location": "Overwater",
        "room_view": "Ocean",
        "room_classification": "Suite"
      }
    ]
  }
}

transaction_id je jedinečný identifikátor rezervačnej zmluvy. coupon, shipping a tax sú prítomné len ak sú relevantné.

---

refund

Spúšťa sa, keď je rezervácia zrušená.

{
  "event": "refund",
  "ecommerce": {
    "currency": "USD",
    "transaction_id": "bc-a1b2c3d4",
    "value": 299.00,
    "coupon": "SUMMER10",
    "shipping": 0.00,
    "tax": 0.00,
    "items": [ ]
  }
}

transaction_id zodpovedá udalosti purchase pre tú istú rezerváciu. coupon, shipping a tax sú prítomné len ak sú relevantné.

---

Vlastnosti položiek

Všetky udalosti, ktoré obsahujú pole items, používajú rovnakú schému položiek. Každá vlastnosť je voliteľná, pokiaľ nie je označená ako povinná.

Štandardné polia GA4

Tieto polia GA4 natívne rozumie a zobrazujú sa v štandardných ecommerce reportoch bez ďalšej konfigurácie.

Vlastnosť	Typ	Povinné	Popis
item_id	string	Áno	Jedinečný identifikátor izby alebo produktu
item_name	string	—	Názov izby alebo produktu
affiliation	string	—	Názov affiliate alebo predajcu
coupon	string	—	Použitý zľavový kód
currency	string	—	ISO 4217 kód meny (napr. USD)
creative_name	string	—	Názov kreatívy použitej v promo akcii
creative_slot	string	—	Pozícia kreatívy v promo akcii
discount	number	—	Výška zľavy
index	number	—	Pozícia v zozname (1-založená)
item_brand	string	—	Názov hotela alebo značky
item_category	string	—	Typ produktu — napr. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Identifikátor zoznamu, ku ktorému položka patrí
item_list_name	string	—	Zobrazovaný názov zoznamu
location_id	string	—	Geokoordináty nehnuteľnosti
price	number	—	Jednotková cena
promotion_id	string	—	Identifikátor promo akcie
promotion_name	string	—	Zobrazovaný názov promo akcie
quantity	number	—	Množstvo (predvolené 1)

Vlastné parametre na úrovni položky

Tieto parametre nesú kontext rezervácie špecifický pre Wink. GA4 ich automaticky nezobrazuje v reportoch — musíte ich zaregistrovať ako vlastné dimenzie na úrovni položky vo vašej GA4 property, aby sa zobrazili v exploráciách alebo štandardných reportoch. Pozrite si nižšie Vlastné dimenzie v GA4 pre inštrukcie.

Vlastnosť	Typ	Popis
property_id	string	Identifikátor nehnuteľnosti Wink
property_name	string	Zobrazovaný názov nehnuteľnosti
property_brand	string	Značka, ktorej nehnuteľnosť patrí
property_chain	string	Reťazec, ku ktorému nehnuteľnosť patrí
property_url_name	string	URL-friendly slug nehnuteľnosti
city_name	string	Mesto, kde sa nehnuteľnosť nachádza
country_code	string	ISO 3166-1 alpha-2 kód krajiny
start_date	string	Dátum príchodu v formáte YYYY-MM-DD
end_date	string	Dátum odchodu v formáte YYYY-MM-DD
num_adults	number	Počet dospelých v rezervácii
num_children	number	Počet detí v rezervácii
cancellation_policy	string	Jeden z: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Identifikátor cenového plánu
room_rate_id	string	Identifikátor konkrétnej ceny izby
room_rate_name	string	Zobrazovaný názov ceny izby
num_perks	number	Počet benefitov zahrnutých v cene
room_location	string	Popis umiestnenia izby (napr. Overwater, Garden)
room_view	string	Popis výhľadu z izby (napr. Ocean, City)
room_classification	string	Klasifikácia alebo kategória izby (napr. Suite, Standard)
bed_type	string	Konfigurácia postele v izbe (napr. King, Twin)

---

Vlastné dimenzie v GA4

GA4 ignoruje vlastné parametre položiek v reportoch, kým ich výslovne nezaregistrujete ako vlastné dimenzie na úrovni položky. Potrebujete zaregistrovať len tie parametre, ktoré chcete používať v reportoch — nemusíte registrovať všetkých 20.

1. Otvorte Vlastné definície

   V GA4 choďte do Admin (ikona ozubeného kolieska vľavo dole) → vyberte svoju property → Zobrazenie dát → Vlastné definície.

2. Vytvorte novú vlastnú dimenziu

   Kliknite na Vytvoriť vlastné dimenzie.

3. Vyplňte detaily dimenzie

   • Názov dimenzie — ľudsky čitateľný názov, ktorý sa zobrazí v GA4 reportoch (pozrite tabuľku nižšie)
   • Rozsah — vyberte Položka (Item)
   • Parameter udalosti — presný názov parametra, ako sa zobrazuje v dataLayer (pozrite tabuľku nižšie)
   • Popis — voliteľné, ale odporúčané

4. Uložte a opakujte

   Kliknite na Uložiť, potom opakujte pre každý parameter, ktorý chcete sledovať.

Poznámka

Vlastné dimenzie môžu začať byť viditeľné v GA4 reportoch až do 24 hodín po registrácii. Historické dáta zozbierané pred registráciou sa nevyplnia spätne.

GA4 umožňuje až 50 vlastných dimenzií na úrovni položky na štandardnú property (360 properties umožňujú viac).

Použite nasledujúcu tabuľku ako referenciu pri vytváraní vlastných dimenzií. Hodnota Parameter udalosti musí presne zodpovedať — GA4 rozlišuje veľké a malé písmená.

Názov dimenzie	Parameter udalosti	Typ
Property ID	property_id	Text
Názov nehnuteľnosti	property_name	Text
Značka nehnuteľnosti	property_brand	Text
Reťazec nehnuteľnosti	property_chain	Text
URL názov nehnuteľnosti	property_url_name	Text
Názov mesta	city_name	Text
Kód krajiny	country_code	Text
Dátum príchodu	start_date	Text
Dátum odchodu	end_date	Text
Počet dospelých	num_adults	Number
Počet detí	num_children	Number
Storno podmienky	cancellation_policy	Text
ID cenového plánu	rate_plan_id	Text
ID ceny izby	room_rate_id	Text
Názov ceny izby	room_rate_name	Text
Počet benefitov	num_perks	Number
Umiestnenie izby	room_location	Text
Výhľad z izby	room_view	Text
Klasifikácia izby	room_classification	Text
Typ postele	bed_type	Text

---

Ďalšie dostupné udalosti

Nasledujúce udalosti sú dostupné v dataLayer Wink, ale nie sú súčasťou štandardného rezervačného procesu. Môžu byť spúšťané inými interakciami na platforme.

add_to_wishlist

{
  "event": "add_to_wishlist",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

remove_from_cart

{
  "event": "remove_from_cart",
  "ecommerce": {
    "currency": "USD",
    "value": 299.00,
    "items": [ ]
  }
}

select_item

{
  "event": "select_item",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Featured Hotels",
    "items": [ ]
  }
}

view_cart

{
  "event": "view_cart"
}

Táto udalosť neobsahuje ecommerce objekt.

view_promotion

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

select_promotion

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Summer Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Summer Sale",
    "items": [ ]
  }
}

search

{
  "event": "search",
  "ecommerce": {
    "search_term": "beachfront resort"
  }
}

select_content

{
  "event": "select_content",
  "ecommerce": {
    "content_type": "hotel",
    "content_id": "prop_12345"
  }
}

share

{
  "event": "share",
  "ecommerce": {
    "method": "copy_link",
    "content_type": "hotel",
    "item_id": "prop_12345"
  }
}

sign_up

{
  "event": "sign_up",
  "ecommerce": {
    "method": "email"
  }
}

generate_lead

{
  "event": "generate_lead",
  "ecommerce": {
    "currency": "USD",
    "value": 0.00
  }
}

join_group

{
  "event": "join_group",
  "ecommerce": {
    "group_id": "group_abc"
  }
}

earn_virtual_currency

{
  "event": "earn_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 100
  }
}

spend_virtual_currency

{
  "event": "spend_virtual_currency",
  "ecommerce": {
    "virtual_currency_name": "WinkPoints",
    "value": 50,
    "item_name": "Room Upgrade"
  }
}

level_start

{
  "event": "level_start",
  "ecommerce": {
    "level_name": "Gold"
  }
}

level_end

{
  "event": "level_end",
  "ecommerce": {
    "level_name": "Gold",
    "success": true
  }
}

level_up

{
  "event": "level_up",
  "ecommerce": {
    "level": 2,
    "character": "traveler"
  }
}

post_score

{
  "event": "post_score",
  "ecommerce": {
    "score": 980,
    "level": 2,
    "character": "traveler"
  }
}

unlock_achievement

{
  "event": "unlock_achievement",
  "ecommerce": {
    "achievement_id": "first_booking"
  }
}

tutorial_begin

{
  "event": "tutorial_begin",
  "ecommerce": {}
}

tutorial_complete

{
  "event": "tutorial_complete",
  "ecommerce": {}
}

---

virtualPageView

Toto je vlastná udalosť Wink — nie je súčasťou štandardnej sady GA4 udalostí. Posiela sa pri každej navigácii na stránku a nesie kontext zariadenia a relácie. Neobsahuje objekt ecommerce.

{
  "event": "virtualPageView",
  "device": "Desktop",
  "deviceAgent": "Mozilla/5.0 ...",
  "os": "MacOS",
  "path": "/hotels/grand-resort",
  "title": "Grand Resort — Wink",
  "userId": "user_abc123",
  "startDate": "2026-06-01",
  "endDate": "2026-06-05",
  "guests": "2",
  "rooms": "1"
}

Vlastnosť	Popis
device	Detekovaný typ zariadenia — Desktop, Android, iPhone, iPad alebo podobné
deviceAgent	Surový user agent string
os	Detekovaný operačný systém — Windows, MacOS, Linux, UNIX
path	Aktuálna cesta stránky
title	Aktuálny názov stránky
userId	Identifikátor autentifikovaného používateľa (vynechaný, ak nie je prihlásený)
startDate	Dátum príchodu z aktuálnej vyhľadávacej relácie
endDate	Dátum odchodu z aktuálnej vyhľadávacej relácie
guests	Počet hostí z aktuálnej vyhľadávacej relácie
rooms	Počet izieb z aktuálnej vyhľadávacej relácie