GTM Analytics Integráció

Bármilyen Google Tag Manager (GTM) konténert csatlakoztathat a Winkhez, ha beírja annak GTM Container ID-ját a Wink portálon. A csatlakozás után a konténer automatikusan betöltődik az ingatlanához, és közvetlenül olvassa a Wink foglalási eseményeit — lefedve a teljes vendégutat a kereséstől a foglalás befejezéséig. Egy gyakori felhasználási eset a Sojern konténer retargetinghez és hirdetéshez, de bármely GTM konténer ugyanígy működik.

Tipp

Ez feltételezi, hogy már rendelkezik GTM Container ID-val (formátum: GTM-XXXXXXX). Ha a konténer egy partner, például a Sojern által érkezik, kérje meg fiókkezelőjét a GTM Container ID-ra — ez eltér a pixel vagy tag ID-tól. Új a Sojernnél? Látogasson el a sojern.com/contact oldalra a kezdéshez.

---

Mit Kell Tennie

1. Szerezze be a GTM Container ID-ját

   Szerezze be a GTM Container ID-ját (formátum: GTM-XXXXXXX). Ha egy partner, például a Sojern biztosítja, kérje kifejezetten a GTM Container ID-t — ez eltér a pixel vagy tag ID-tól.

2. Adja meg a Wink portálon

   Jelentkezzen be a app.wink.travel oldalra, válassza ki fiókját, és lépjen a Testreszabások fülre. Illessze be a GTM Container ID-t a GTM mezőbe, majd mentse el. Az integráció most él.

3. (Opcionális) Adjon meg GA4 Measurement ID-t + API titkot a szerveroldali vásárláshoz

   A GTM konténerek teljes egészében a vendég böngészőjében futnak, így egy befejezett foglalás elmaradhat, ha a vendég bezárja a lapot a fizetés átirányításakor. Ha a konténer betölt egy GA4 property-t, és megbízhatóan szeretné rögzíteni a befejezett foglalásokat, adja meg a GA4 Measurement ID-ját és a Measurement Protocol API titkot a GTM szekcióban. A Wink ezután a purchase eseményt szerveroldalon küldi el az adott property-hez, pontosan az GA4 Analytics Integráció útmutatóban leírtak szerint. Ha csak böngészőben történő követésre van szüksége, hagyja ezeket üresen.

4. Erősítse meg szolgáltatójával

   Ha a konténer egy partner, például a Sojern által érkezik, tájékoztassa fiókkezelőjét, hogy az integráció aktív. Ők ellenőrizhetik, hogy a tagek helyesen működnek-e a wink.travel oldalon az ingatlanához, és hogy az adatok beérkeznek-e a fiókjába.

Megjegyzés

Ehhez az integrációhoz nem kell pixelkódot elhelyeznie a saját weboldalán. A Wink automatikusan betölti a GTM konténerét minden olyan oldalon, ahol az ingatlana aktív.

Ez bármilyen GTM Container ID-val működik — a Sojern csak egy gyakori példa.

---

Mit Tesz a Wink a Saját Oldalán

Átláthatóság kedvéért itt van, mit konfigurál a Wink az integráció működéséhez:

• A Wink portál Testreszabások fülén elérhető egy GTM Container ID mező. Ha beírja a Container ID-t, a Wink ellenőrzi a formátumot (GTM-XXXXXXX), és biztonságosan tárolja az ingatlanához.
• A Wink minden olyan oldalon, ahol az ingatlana aktív, közvetlenül beilleszti a konténert az oldalba — megosztva a Wink saját window.dataLayer-jét — így az a Wink saját konténerével párhuzamosan töltődik be, további konfiguráció nélkül. Ez automatikusan történik, ingatlanonkénti külön munkát nem igényel a Wink csapatától.
• A konténer aszinkron módon töltődik be, így nem befolyásolja a vendégek oldalbetöltési teljesítményét.
• A Wink saját követése és a konténer párhuzamosan futnak, ugyanabból a megosztott dataLayer-ből olvasva. Minden foglalási esemény, amit a Wink követ, egyszerre elérhető a konténer számára is.
• Ha az ingatlan nincs megtekintve — például ha a vendég egy másik hotelt böngész a Wink oldalán — a konténer nem töltődik be, így csak az ingatlanához releváns adatokat kapja.
• Ha megadott GA4 Measurement ID-t + API titkot (3. lépés fent), a befejezett foglalások purchase eseménye emellett szerveroldalon is elküldésre kerül a GA4 Measurement Protocol segítségével, így a vásárlás rögzítve lesz akkor is, ha a vendég nem tér vissza a visszaigazoló oldalra.

---

DataLayer Referencia

A Wink GA4-kompatibilis eseményeket tol a dataLayer-be a vendégút során. A GTM konténere ebből a megosztott dataLayer-ből olvas, így bármely trigger vagy változó, amit konfigurál, hozzáfér az alábbi tulajdonságokhoz.

Minden esemény a standard GA4 Enhanced Ecommerce struktúrát követi: egy felső szintű event stringet és egy ecommerce objektumot. Minden push előtt a Wink törli az előző ecommerce payloadot, hogy elkerülje az elavult adatok átszivárgását az új triggerekbe.

Megjegyzés

dataLayer reset minta

A Wink minden esemény push előtt visszaállítja az ecommerce objektumot:

dataLayer.push({ ecommerce: null });   // előző esemény törlése
dataLayer.push({ event: '...', ecommerce: { ... } });

Ne számítson arra, hogy az ecommerce tulajdonságok megmaradnak események között. Mindig az esemény triggerelésekor olvassa őket ugyanabban az eseményben.

---

Foglalási Út Események

Ezek az események automatikusan aktiválódnak, ahogy a vendég halad a foglalási tölcséren. Konfigurálja GTM triggerjeit Egyedi Esemény triggerként, az alábbi eseménynévvel.

Lépés	Esemény	Mikor Aktiválódik
1	view_item_list	Szálláshely-készlet rács vagy lista betöltődik
2	view_item	Vendég megtekint egy adott ingatlan oldalt
3	add_to_cart	Vendég hozzáad egy szobát a kosárhoz
4	begin_checkout	Fizetési oldal betöltődik
5	add_payment_info	Vendég kiválaszt vagy megerősít egy fizetési módot
6	login	Vendég bejelentkezik SSO-val
7	purchase	Foglalás megerősítve
8	refund	Foglalás törölve

---

view_item_list

Aktiválódik, amikor egy szálláshely-készlet rács vagy lista megjelenik.

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Kiemelt Szállodák",
    "items": [ ]
  }
}

---

view_item

Aktiválódik, amikor a vendég megtekint egy adott ingatlant.

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

---

add_to_cart

Aktiválódik, amikor a vendég hozzáad egy szobát a kosarához.

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

---

begin_checkout

Aktiválódik, amikor a fizetési oldal betöltődik.

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

A coupon csak akkor jelenik meg, ha kedvezménykódot alkalmaztak.

---

add_payment_info

Aktiválódik, amikor a vendég kiválaszt vagy megerősít egy fizetési módot.

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

A payment_type a fizetési szolgáltató típusából töltődik. A coupon csak akkor jelenik meg, ha kedvezménykódot alkalmaztak.

---

login

Aktiválódik, amikor a vendég egyetlen bejelentkezéssel (SSO) hitelesíti magát.

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

---

purchase

Aktiválódik, amikor a foglalás megerősítésre kerül.

{
  "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"
      }
    ]
  }
}

A transaction_id az egyedi foglalási szerződés azonosítója. A coupon, shipping és tax csak akkor jelenik meg, ha alkalmazható.

---

refund

Aktiválódik, amikor egy foglalást törölnek.

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

A transaction_id megegyezik a purchase eseményével ugyanahhoz a foglaláshoz. A coupon, shipping és tax csak akkor jelenik meg, ha alkalmazható.

---

Elem Tulajdonságok

Minden esemény, amely tartalmaz items tömböt, ugyanazt az elem sémát használja. Minden tulajdonság opcionális, kivéve, ha kötelezőként jelöltük.

Standard GA4 mezők

Ezeket a mezőket a GA4 natívan érti, és megjelennek a standard ecommerce jelentésekben további konfiguráció nélkül.

Tulajdonság	Típus	Kötelező	Leírás
item_id	string	Igen	Egyedi azonosító a szobához vagy termékhez
item_name	string	—	A szoba vagy termék neve
affiliation	string	—	Partner vagy eladó neve
coupon	string	—	Az elemhez alkalmazott kuponkód
currency	string	—	ISO 4217 pénznemkód (pl. USD)
creative_name	string	—	Promócióban használt kreatív neve
creative_slot	string	—	A promóció kreatív pozíciója
discount	number	—	Alkalmazott kedvezmény összege
index	number	—	Pozíció a listában (1-től kezdve)
item_brand	string	—	Szálloda vagy márkanév
item_category	string	—	Terméktípus — pl. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	A lista azonosítója, amelyhez az elem tartozik
item_list_name	string	—	A lista megjelenítendő neve
location_id	string	—	Az ingatlan földrajzi koordinátái
price	number	—	Egységár
promotion_id	string	—	A promóció azonosítója
promotion_name	string	—	A promóció megjelenítendő neve
quantity	number	—	Mennyiség (alapértelmezett: 1)

Egyedi elemhez kötött paraméterek

Ezek a paraméterek Wink-specifikus foglalási kontextust hordoznak. A GA4 nem jeleníti meg automatikusan a jelentésekben — minden egyes paramétert regisztrálnia kell elemhez kötött egyedi dimenzióként a GA4 property-jében, mielőtt megjelenik a jelentésekben vagy elemzésekben. Lásd a Custom Dimensions in GA4 részt a beállítási útmutatóért.

Tulajdonság	Típus	Leírás
property_id	string	Wink ingatlan azonosító
property_name	string	Az ingatlan megjelenítendő neve
property_brand	string	Márka, amelyhez az ingatlan tartozik
property_chain	string	Szállodalánc, amelyhez az ingatlan tartozik
property_url_name	string	URL-barát slug az ingatlanhoz
city_name	string	Város, ahol az ingatlan található
country_code	string	ISO 3166-1 alpha-2 országkód
start_date	string	Bejelentkezés dátuma YYYY-MM-DD formátumban
end_date	string	Kijelentkezés dátuma YYYY-MM-DD formátumban
num_adults	number	Felnőttek száma a foglalásban
num_children	number	Gyermekek száma a foglalásban
cancellation_policy	string	Egyike: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Árterv azonosítója
room_rate_id	string	Egyedi szobadíj azonosító
room_rate_name	string	A szobadíj megjelenítendő neve
num_perks	number	Az árhoz tartozó kedvezmények száma
room_location	string	Szoba elhelyezkedésének leírása (pl. Overwater, Garden)
room_view	string	Szoba kilátásának leírása (pl. Ocean, City)
room_classification	string	Szoba besorolása vagy kategóriája (pl. Suite, Standard)
bed_type	string	Ágy konfigurációja a szobában (pl. King, Twin)

---

Egyedi Dimenziók a GA4-ben

A GA4 figyelmen kívül hagyja az egyedi elem paramétereket a jelentésekben, amíg kifejezetten nem regisztrálja őket elemhez kötött egyedi dimenzióként. Csak azokat a paramétereket kell regisztrálnia, amelyeket használni szeretne a jelentésekben — nem szükséges az összes 20-at regisztrálni.

1. Nyissa meg az Egyedi Definíciókat

   A GA4-ben lépjen az Adminisztráció (bal alsó fogaskerék ikon) → válassza ki a property-t → Adatmegjelenítés → Egyedi definíciók.

2. Hozzon létre új egyedi dimenziót

   Kattintson a Egyedi dimenzió létrehozása gombra.

3. Töltse ki a dimenzió adatait

   • Dimenzió neve — az emberi olvasásra alkalmas címke, amely megjelenik a GA4 jelentésekben (lásd az alábbi táblázatot)
   • Hatókör — válassza az Elem opciót
   • Esemény paraméter — a pontos paraméternév, ahogy a dataLayer-ben szerepel (lásd az alábbi táblázatot)
   • Leírás — opcionális, de ajánlott

4. Mentse és ismételje

   Kattintson a Mentés gombra, majd ismételje meg minden követni kívánt paraméterrel.

Megjegyzés

Az egyedi dimenziók megjelenése a GA4 jelentésekben regisztráció után akár 24 órát is igénybe vehet. A regisztráció előtti történeti adatok nem kerülnek visszatöltésre.

A GA4 standard property-k esetén legfeljebb 50 elemhez kötött egyedi dimenzió engedélyezett (360-as property-k esetén több).

Az alábbi táblázatot használja referenciaként az egyedi dimenziók létrehozásához. Az Esemény paraméter értéknek pontosan meg kell egyeznie — a GA4 kis- és nagybetű érzékeny.

Dimenzió neve	Esemény paraméter	Típus
Ingatlan azonosító	property_id	Szöveg
Ingatlan neve	property_name	Szöveg
Ingatlan márkája	property_brand	Szöveg
Ingatlan lánca	property_chain	Szöveg
Ingatlan URL neve	property_url_name	Szöveg
Város neve	city_name	Szöveg
Országkód	country_code	Szöveg
Bejelentkezés dátuma	start_date	Szöveg
Kijelentkezés dátuma	end_date	Szöveg
Felnőttek száma	num_adults	Szám
Gyermekek száma	num_children	Szám
Lemondási feltétel	cancellation_policy	Szöveg
Árterv azonosító	rate_plan_id	Szöveg
Szobadíj azonosító	room_rate_id	Szöveg
Szobadíj neve	room_rate_name	Szöveg
Kedvezmények száma	num_perks	Szám
Szoba elhelyezkedése	room_location	Szöveg
Szoba kilátása	room_view	Szöveg
Szoba besorolása	room_classification	Szöveg
Ágy típusa	bed_type	Szöveg

---

További Elérhető Események

Az alábbi események elérhetők a Wink dataLayer-ben, de nem részei a standard foglalási tölcsérnek. Ezeket más platform interakciók is kiválthatják.

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": "Kiemelt Szállodák",
    "items": [ ]
  }
}

view_cart

{
  "event": "view_cart"
}

Ehhez az eseményhez nem tartozik ecommerce payload.

view_promotion

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Nyári Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Nyári Akció",
    "items": [ ]
  }
}

select_promotion

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Nyári Banner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Nyári Akció",
    "items": [ ]
  }
}

search

{
  "event": "search",
  "ecommerce": {
    "search_term": "tengerparti üdülőhely"
  }
}

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": "Szoba Frissítés"
  }
}

level_start

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

level_end

{
  "event": "level_end",
  "ecommerce": {
    "level_name": "Arany",
    "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

Ez egy egyedi Wink esemény — nem része a standard GA4 eseménykészletnek. Minden oldal navigációnál push-olódik, és eszköz- valamint munkamenet kontextust hordoz. Nem tartalmaz ecommerce objektumot.

{
  "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"
}

Tulajdonság	Leírás
device	Észlelt eszköz típus — Desktop, Android, iPhone, iPad vagy hasonló
deviceAgent	Nyers user agent string
os	Észlelt operációs rendszer — Windows, MacOS, Linux, UNIX
path	Aktuális oldal útvonala
title	Aktuális oldal címe
userId	Hitelesített felhasználó azonosítója (be nem jelentkezett esetén elhagyva)
startDate	Bejelentkezés dátuma az aktuális keresési munkamenetből
endDate	Kijelentkezés dátuma az aktuális keresési munkamenetből
guests	Vendégek száma az aktuális keresési munkamenetből
rooms	Szobák száma az aktuális keresési munkamenetből