GTM analizės integracija

Galite prijungti bet kurį Google Tag Manager (GTM) konteinerį prie Wink, įvesdami jo GTM konteinerio ID Wink portale. Prijungus, jūsų konteineris automatiškai įkeliama jūsų nuosavybei ir tiesiogiai skaito Wink užsakymo įvykius — apimdamas visą svečio kelionę nuo paieškos iki užsakymo užbaigimo. Dažnas naudojimo atvejis yra Sojern konteineris pakartotinei rinkodarai ir reklamai, tačiau bet kuris GTM konteineris veikia taip pat.

Tip

Tai reiškia, kad jau turite GTM konteinerio ID (formatu GTM-XXXXXXX). Jei jūsų konteineris yra iš partnerio, pvz., Sojern, paprašykite savo paskyros vadybininko būtent GTM konteinerio ID — jis skiriasi nuo pikselo ar žymos ID. Naujas Sojern? Aplankykite sojern.com/contact, kad pradėtumėte.

---

Ką turite padaryti

1. Gaukite savo GTM konteinerio ID

   Gaukite savo GTM konteinerio ID (formatu GTM-XXXXXXX). Jei jis gaunamas iš partnerio, pvz., Sojern, paprašykite būtent GTM konteinerio ID — jis skiriasi nuo pikselo ar žymos ID.

2. Įveskite jį Wink portale

   Prisijunkite prie app.wink.travel, pasirinkite savo paskyrą ir eikite į skirtuką Customizations. Įklijuokite savo GTM konteinerio ID į laukelį GTM ir išsaugokite. Jūsų integracija dabar veikia.

3. (Pasirinktinai) Pridėkite GA4 matavimo ID + API slaptą raktą serverio pusės pirkimams

   GTM konteineriai veikia visiškai svečio naršyklėje, todėl užbaigtas užsakymas gali būti praleistas, jei svečias uždaro skirtuką mokėjimo peradresavimo metu. Jei jūsų konteineris įkelia GA4 nuosavybę ir norite patikimai registruoti užbaigtus užsakymus, taip pat įveskite to GA4 matavimo ID ir Measurement Protocol API slaptą raktą GTM skiltyje. Wink tada išsiųs purchase įvykį serverio pusėje, tiksliai kaip aprašyta GA4 analizės integracijos vadove. Palikite tuščius, jei jums reikia tik naršyklės stebėjimo.

4. Patvirtinkite su savo tiekėju

   Jei jūsų konteineris yra iš partnerio, pvz., Sojern, praneškite savo paskyros vadybininkui, kad integracija aktyvi. Jie gali patikrinti iš savo pusės, ar žymos tinkamai veikia wink.travel jūsų nuosavybei ir ar duomenys teka į jūsų paskyrą.

Note

Jums nereikia įdėti jokio pikselo kodo savo svetainėje šiai integracijai. Wink automatiškai įkelia jūsų GTM konteinerį visuose puslapiuose, kuriuose aktyvi jūsų nuosavybė.

Tai veikia su bet kuriuo GTM konteinerio ID — Sojern yra tik dažnas pavyzdys.

---

Ką Wink daro savo pusėje

Skaidrumui, štai ką Wink konfigūruoja, kad ši integracija veiktų:

• GTM konteinerio ID laukas yra prieinamas Wink portalo Customizations skirtuke. Įvedus konteinerio ID, Wink patikrina formatą (GTM-XXXXXXX) ir saugiai jį saugo jūsų nuosavybei.
• Kiekviename puslapyje, kuriame aktyvi jūsų nuosavybė Wink tiesiogiai įterpia jūsų konteinerį į puslapį — dalijantis Wink pačios window.dataLayer — todėl jis įkeliama kartu su Wink konteineriu be papildomų konfigūracijų. Tai vyksta automatiškai, be papildomo Wink komandos darbo kiekvienai nuosavybei.
• Jūsų konteineris įkeliamas asinchroniškai, todėl neįtakoja puslapio įkėlimo greičio jūsų svečiams.
• Wink stebėjimas ir jūsų konteineris veikia lygiagrečiai, skaitydami iš to paties bendro dataLayer. Kiekvienas Wink stebimas užsakymo įvykis tuo pačiu metu yra prieinamas jūsų konteineriui.
• Kai jūsų nuosavybė nėra peržiūrima — pavyzdžiui, kai svečias naršo kitą viešbutį Wink — jūsų konteineris neįkeliamas, todėl gauna tik duomenis, susijusius su jūsų nuosavybe.
• Jei pateikėte GA4 matavimo ID + API slaptą raktą (3 žingsnis aukščiau), purchase užbaigtų užsakymų įvykis papildomai siunčiamas serverio pusėje per GA4 Measurement Protocol, todėl pardavimas užregistruojamas net jei svečias niekada negrįžta į patvirtinimo puslapį.

---

DataLayer nuoroda

Wink siunčia GA4 suderinamus įvykius į dataLayer visos svečio kelionės metu. Jūsų GTM konteineris skaito iš to paties bendro dataLayer, todėl bet kuris jūsų sukonfigūruotas trigeris ar kintamasis turi prieigą prie visų žemiau aprašytų savybių.

Kiekvienas įvykis atitinka standartinę GA4 Enhanced Ecommerce struktūrą: viršutinio lygio event eilutę ir ecommerce objektą. Prieš kiekvieną push, Wink išvalo ankstesnį ecommerce duomenų paketą, kad išvengtų pasenusių duomenų įsiskverbimo į naujus trigerius.

Note

dataLayer išvalymo modelis

Wink išvalo ecommerce objektą prieš kiekvieną įvykio push:

dataLayer.push({ ecommerce: null });   // išvalyti ankstesnį įvykį
dataLayer.push({ event: '...', ecommerce: { ... } });

Nesitikėkite, kad ecommerce savybės išliks tarp įvykių. Visada skaitykite jas trigerio metu tame pačiame įvykyje.

---

Užsakymo kelionės įvykiai

Šie įvykiai automatiškai paleidžiami, kai svečias juda užsakymo piltuvo etapuose. Sujunkite savo GTM trigerius kaip Custom Event trigerius, atitinkančius žemiau pateiktus įvykių pavadinimus.

Žingsnis	Įvykis	Kada paleidžiamas
1	view_item_list	Įkeliama viešbučių inventoriaus tinklelio arba sąrašo peržiūra
2	view_item	Svečias peržiūri konkrečios nuosavybės puslapį
3	add_to_cart	Svečias prideda kambarį į krepšelį
4	begin_checkout	Įkeliama atsiskaitymo / mokėjimo puslapis
5	add_payment_info	Svečias pasirenka mokėjimo būdą
6	login	Svečias autentifikuojasi per SSO
7	purchase	Užsakymas patvirtintas
8	refund	Užsakymas atšauktas

---

view_item_list

Paleidžiamas, kai įkeliama viešbučių inventoriaus tinklelio arba sąrašo peržiūra.

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

---

view_item

Paleidžiamas, kai svečias peržiūri konkrečią nuosavybę.

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

---

add_to_cart

Paleidžiamas, kai svečias prideda kambarį į krepšelį.

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

---

begin_checkout

Paleidžiamas, kai įkeliama atsiskaitymo / mokėjimo puslapis.

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

coupon yra tik tada, kai buvo pritaikytas nuolaidos kodas.

---

add_payment_info

Paleidžiamas, kai svečias pasirenka arba patvirtina mokėjimo būdą.

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

payment_type užpildomas pagal mokėjimo gavėjo tipą. coupon yra tik tada, kai buvo pritaikytas nuolaidos kodas.

---

login

Paleidžiamas, kai svečias autentifikuojasi per vieno prisijungimo sistemą.

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

---

purchase

Paleidžiamas, kai užsakymas patvirtinamas.

{
  "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 yra unikalus užsakymo sutarties identifikatorius. coupon, shipping ir tax yra tik tada, kai taikoma.

---

refund

Paleidžiamas, kai užsakymas atšaukiamas.

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

transaction_id atitinka tą patį purchase įvykį už tą patį užsakymą. coupon, shipping ir tax yra tik tada, kai taikoma.

---

Prekės savybės

Visi įvykiai, turintys items masyvą, naudoja tą pačią prekės schemą. Kiekviena savybė yra neprivaloma, nebent pažymėta kaip privaloma.

Standartiniai GA4 laukai

Šie laukai yra natūraliai suprantami GA4 ir rodomi standartinėse ecommerce ataskaitose be papildomos konfigūracijos.

Savybė	Tipas	Privaloma	Aprašymas
item_id	string	Taip	Unikalus kambario ar produkto identifikatorius
item_name	string	—	Kambario ar produkto pavadinimas
affiliation	string	—	Partnerio arba pardavėjo pavadinimas
coupon	string	—	Pritaikytas kupono kodas
currency	string	—	ISO 4217 valiutos kodas (pvz., USD)
creative_name	string	—	Reklamos kūrinio pavadinimas
creative_slot	string	—	Reklamos kūrinio pozicija
discount	number	—	Pritaikyta nuolaida
index	number	—	Pozicija sąraše (pradedant nuo 1)
item_brand	string	—	Viešbučio ar prekės ženklas
item_category	string	—	Produkto tipas — pvz., GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Sąrašo, kuriam priklauso prekė, identifikatorius
item_list_name	string	—	Sąrašo pavadinimas
location_id	string	—	Nuosavybės geografinės koordinatės
price	number	—	Vieneto kaina
promotion_id	string	—	Akcijos identifikatorius
promotion_name	string	—	Akcijos pavadinimas
quantity	number	—	Kiekis (numatytoji reikšmė 1)

Individualūs prekės lygmens parametrai

Šie parametrai perteikia Wink specifinį užsakymo kontekstą. GA4 jų automatiškai nerodo ataskaitose — kiekvieną reikia užregistruoti kaip prekės lygmens individualią dimensiją savo GA4 nuosavybėje, kad ji atsirastų ataskaitose ar analizėse. Žr. Individualios dimensijos GA4 žemiau, kaip tai padaryti.

Savybė	Tipas	Aprašymas
property_id	string	Wink nuosavybės identifikatorius
property_name	string	Nuosavybės pavadinimas
property_brand	string	Prekės ženklas, kuriam priklauso nuosavybė
property_chain	string	Viešbučių tinklas, kuriam priklauso nuosavybė
property_url_name	string	URL draugiškas nuosavybės slapyvardis
city_name	string	Miestas, kuriame yra nuosavybė
country_code	string	ISO 3166-1 alpha-2 šalies kodas
start_date	string	Atvykimo data formatu YYYY-MM-DD
end_date	string	Išvykimo data formatu YYYY-MM-DD
num_adults	number	Su užsakymu susijusių suaugusiųjų skaičius
num_children	number	Su užsakymu susijusių vaikų skaičius
cancellation_policy	string	Viena iš: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Kainų plano identifikatorius
room_rate_id	string	Konkretios kambario kainos identifikatorius
room_rate_name	string	Kambario kainos pavadinimas
num_perks	number	Kainoje įtrauktų privalumų skaičius
room_location	string	Kambario vietos aprašymas (pvz., Overwater, Garden)
room_view	string	Kambario vaizdo aprašymas (pvz., Ocean, City)
room_classification	string	Kambario klasifikacija ar kategorija (pvz., Suite, Standard)
bed_type	string	Lovos konfigūracija kambaryje (pvz., King, Twin)

---

Individualios dimensijos GA4

GA4 ignoruoja individualius prekės parametrus ataskaitose, kol jų aiškiai neužregistruojate kaip prekės lygmens individualias dimensijas. Reikia registruoti tik tuos parametrus, kuriuos ketinate naudoti ataskaitose — nereikia registruoti visų 20.

1. Atidarykite Custom Definitions

   GA4 eikite į Admin (apatinis kairysis pavaros piktograma) → pasirinkite savo nuosavybę → Data display → Custom definitions.

2. Sukurkite naują individualią dimensiją

   Spauskite Create custom dimensions.

3. Užpildykite dimensijos duomenis

   • Dimension name — žmogui suprantamas pavadinimas, kuris bus matomas GA4 ataskaitose (žr. lentelę žemiau)
   • Scope — pasirinkite Item
   • Event parameter — tikslus parametro pavadinimas, kaip jis yra dataLayer (žr. lentelę žemiau)
   • Description — neprivaloma, bet rekomenduojama

4. Išsaugokite ir kartokite

   Spauskite Save, tada pakartokite kiekvienam parametrui, kurį norite stebėti.

Note

Individualios dimensijos gali pradėti rodyti duomenis GA4 ataskaitose per 24 valandas po registracijos. Istoriniai duomenys, surinkti prieš registraciją, nėra papildomai įtraukiami.

GA4 leidžia iki 50 prekės lygmens individualių dimensijų standartinėse nuosavybėse (360 nuosavybėse leidžiama daugiau).

Naudokite žemiau pateiktą lentelę kaip nuorodą kuriant individualias dimensijas. Event parameter reikšmė turi tiksliai sutapti — GA4 yra didžiųjų ir mažųjų raidžių atskyrimas.

Dimensijos pavadinimas	Event parameter	Tipas
Nuosavybės ID	property_id	Tekstas
Nuosavybės pavadinimas	property_name	Tekstas
Nuosavybės prekės ženklas	property_brand	Tekstas
Nuosavybės tinklas	property_chain	Tekstas
Nuosavybės URL pavadinimas	property_url_name	Tekstas
Miesto pavadinimas	city_name	Tekstas
Šalies kodas	country_code	Tekstas
Atvykimo data	start_date	Tekstas
Išvykimo data	end_date	Tekstas
Suaugusiųjų skaičius	num_adults	Skaičius
Vaikų skaičius	num_children	Skaičius
Atšaukimo politika	cancellation_policy	Tekstas
Kainų plano ID	rate_plan_id	Tekstas
Kambario kainos ID	room_rate_id	Tekstas
Kambario kainos pavadinimas	room_rate_name	Tekstas
Privalumų skaičius	num_perks	Skaičius
Kambario vieta	room_location	Tekstas
Kambario vaizdas	room_view	Tekstas
Kambario klasifikacija	room_classification	Tekstas
Lovos tipas	bed_type	Tekstas

---

Papildomi galimi įvykiai

Šie įvykiai yra prieinami Wink dataLayer, bet nėra standartinio užsakymo piltuvo dalis. Jie gali būti paleidžiami kitų platformos sąveikų metu.

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

Šis įvykis neturi ecommerce duomenų paketo.

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

Tai yra specialus Wink įvykis — ne standartinis GA4 įvykių rinkinys. Jis siunčiamas kiekvieną kartą keičiantis puslapiui ir perduoda įrenginio bei sesijos kontekstą. Jame nėra ecommerce objekto.

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

Savybė	Aprašymas
device	Aptiktas įrenginio tipas — Desktop, Android, iPhone, iPad ar panašiai
deviceAgent	Žaliava naudotojo agento eilutė
os	Aptikta operacinė sistema — Windows, MacOS, Linux, UNIX
path	Dabartinis puslapio kelias
title	Dabartinis puslapio pavadinimas
userId	Autentifikuoto naudotojo identifikatorius (praleidžiamas, jei neprisijungta)
startDate	Atvykimo data iš dabartinės paieškos sesijos
endDate	Išvykimo data iš dabartinės paieškos sesijos
guests	Svečio skaičius iš dabartinės paieškos sesijos
rooms	Kambarių skaičius iš dabartinės paieškos sesijos