Integracija GTM Analytics

Možete povezati bilo koji Google Tag Manager (GTM) kontejner s Winkom unošenjem njegovog GTM Container ID u Wink portal. Nakon povezivanja, vaš kontejner se automatski učitava za vašu nekretninu i izravno čita Winkove događaje rezervacije — pokrivajući cijelo putovanje gosta od pretraživanja do završene rezervacije. Čest slučaj upotrebe je Sojern kontejner za retargeting i oglašavanje, ali bilo koji GTM kontejner funkcionira na isti način.

Tip

Ovo pretpostavlja da već imate GTM Container ID (format GTM-XXXXXXX). Ako vaš kontejner dolazi od partnera poput Sojerna, zatražite od svog voditelja računa GTM Container ID — on se razlikuje od pixel ili tag ID-a. Novi ste u Sojernu? Posjetite sojern.com/contact za početak.

---

Što trebate učiniti

1. Nabavite svoj GTM Container ID

   Nabavite svoj GTM Container ID (format GTM-XXXXXXX). Ako dolazi od partnera poput Sojerna, zatražite specifično GTM Container ID — on se razlikuje od pixel ili tag ID-a.

2. Unesite ga u Wink portal

   Prijavite se na app.wink.travel, odaberite svoj račun i idite na karticu Customizations. Zalijepite svoj GTM Container ID u polje GTM i spremite. Vaša integracija je sada aktivna.

3. (Opcionalno) Dodajte GA4 Measurement ID + API Secret za server-side kupnju

   GTM kontejneri se u potpunosti izvršavaju u pregledniku gosta, pa se završena rezervacija može propustiti ako gost zatvori karticu tijekom preusmjeravanja na plaćanje. Ako vaš kontejner učitava GA4 property i želite pouzdano bilježiti završene rezervacije, unesite i GA4 Measurement ID i Measurement Protocol API secret u GTM sekciju. Wink će tada poslati purchase za tu property server-side, točno kao što je opisano u vodiču GA4 Analytics Integration. Ostavite prazno ako vam treba samo praćenje u pregledniku.

4. Potvrdite s vašim pružateljem usluge

   Ako vaš kontejner dolazi od partnera poput Sojerna, obavijestite svog voditelja računa da je integracija aktivna. Oni mogu provjeriti s njihove strane da se tagovi ispravno aktiviraju na wink.travel za vašu nekretninu i da podaci teku u vaš račun.

Note

Ne morate postavljati nikakav pixel kod na vlastitu web stranicu za ovu integraciju. Wink automatski učitava vaš GTM kontejner na svim stranicama gdje je vaša nekretnina aktivna.

Ovo radi za bilo koji GTM Container ID — Sojern je samo čest primjer.

---

Što Wink radi s naše strane

Za transparentnost, evo što Wink konfigurira da bi ova integracija funkcionirala:

• Polje za GTM Container ID dostupno je u kartici Customizations vašeg Wink portala. Kada unesete Container ID, Wink provjerava format (GTM-XXXXXXX) i sigurno ga pohranjuje za vašu nekretninu.
• Na svakoj stranici gdje je vaša nekretnina aktivna na Wink-u, vaš kontejner se izravno ubacuje u stranicu — dijeleći Winkov vlastiti window.dataLayer — tako da se učitava paralelno s Winkovim kontejnerom bez potrebe za dodatnom konfiguracijom. Ovo se događa automatski, bez dodatnog rada Wink tima po nekretnini.
• Vaš kontejner se učitava asinkrono, tako da ne utječe na performanse učitavanja stranice za vaše goste.
• Winkovo vlastito praćenje i vaš kontejner rade paralelno, čitajući iz istog zajedničkog dataLayer. Svaki događaj rezervacije koji Wink prati istovremeno je dostupan vašem kontejneru.
• Kada vaša nekretnina nije pregledavana — na primjer, kada gost pregledava drugi hotel na Wink-u — vaš kontejner se ne učitava, pa prima samo podatke relevantne za vašu nekretninu.
• Ako ste unijeli GA4 Measurement ID + API secret (korak 3 gore), purchase za završene rezervacije se dodatno šalje server-side putem GA4 Measurement Protocola, tako da se prodaja bilježi čak i ako gost nikada ne vrati na stranicu potvrde.

---

Referenca DataLayer-a

Wink šalje GA4-kompatibilne događaje u dataLayer tijekom cijelog putovanja gosta. Vaš GTM kontejner čita iz istog zajedničkog dataLayer, tako da svaki okidač ili varijabla koju konfigurirate ima pristup svim svojstvima opisanima u nastavku.

Svaki događaj slijedi standardnu GA4 Enhanced Ecommerce strukturu: string event na vrhu i objekt ecommerce. Prije svakog push-a, Wink briše prethodni ecommerce payload kako bi spriječio da zastarjeli podaci utječu na nove okidače.

Note

Obrazac resetiranja dataLayer-a

Wink resetira ecommerce objekt prije svakog push-a događaja:

dataLayer.push({ ecommerce: null });   // briše prethodni događaj
dataLayer.push({ event: '...', ecommerce: { ... } });

Nemojte se oslanjati na to da ecommerce svojstva ostaju između događaja. Uvijek ih čitajte u trenutku okidača unutar istog događaja.

---

Događaji putovanja rezervacije

Ovi događaji se automatski aktiviraju dok se gost kreće kroz lijevak rezervacije. Konfigurirajte svoje GTM okidače kao Custom Event okidače koji odgovaraju imenima događaja u nastavku.

Korak	Događaj	Kada se aktivira
1	view_item_list	Učitava se mreža ili lista hotela
2	view_item	Gost pregledava stranicu određene nekretnine
3	add_to_cart	Gost dodaje sobu u košaricu
4	begin_checkout	Učitava se stranica za plaćanje / naplatu
5	add_payment_info	Gost odabire način plaćanja
6	login	Gost se autentificira putem SSO-a
7	purchase	Rezervacija je potvrđena
8	refund	Rezervacija je otkazana

---

view_item_list

Aktivira se kada se prikaže mreža ili lista hotela.

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

---

view_item

Aktivira se kada gost pregleda određenu nekretninu.

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

---

add_to_cart

Aktivira se kada gost doda sobu u košaricu.

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

---

begin_checkout

Aktivira se kada se učita stranica za plaćanje / naplatu.

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

coupon je prisutan samo kada je primijenjen kod za popust.

---

add_payment_info

Aktivira se kada gost odabere ili potvrdi način plaćanja.

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

payment_type se popunjava iz tipa platnog procesora. coupon je prisutan samo kada je primijenjen kod za popust.

---

login

Aktivira se kada se gost autentificira putem single sign-on.

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

---

purchase

Aktivira se kada je rezervacija potvrđena.

{
  "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 jedinstveni identifikator ugovora o rezervaciji. coupon, shipping i tax su prisutni samo kada su primjenjivi.

---

refund

Aktivira se kada je rezervacija otkazana.

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

transaction_id odgovara purchase događaju za istu rezervaciju. coupon, shipping i tax su prisutni samo kada su primjenjivi.

---

Svojstva stavki

Svi događaji koji uključuju niz items dijele isti shematski opis stavke. Svako svojstvo je opcionalno osim ako nije označeno kao obavezno.

Standardna GA4 polja

Ova polja GA4 nativno razumije i pojavljuju se u standardnim ecommerce izvještajima bez dodatne konfiguracije.

Svojstvo	Tip	Obavezno	Opis
item_id	string	Da	Jedinstveni identifikator sobe ili proizvoda
item_name	string	—	Naziv sobe ili proizvoda
affiliation	string	—	Ime partnera ili prodavača
coupon	string	—	Primijenjeni kupon kod na stavku
currency	string	—	ISO 4217 kod valute (npr. USD)
creative_name	string	—	Naziv kreativnog oglasa u promociji
creative_slot	string	—	Pozicija kreativnog oglasa u slotu
discount	number	—	Iznos popusta primijenjen
index	number	—	Pozicija na listi (1-bazirano)
item_brand	string	—	Naziv hotela ili brenda
item_category	string	—	Tip proizvoda — npr. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Identifikator liste kojoj stavka pripada
item_list_name	string	—	Prikazni naziv liste
location_id	string	—	Geografske koordinate nekretnine
price	number	—	Jedinična cijena
promotion_id	string	—	Identifikator promocije
promotion_name	string	—	Prikazni naziv promocije
quantity	number	—	Količina (zadano 1)

Prilagođeni parametri vezani uz stavku

Ovi parametri nose Wink-specifični kontekst rezervacije. GA4 ih ne prikazuje automatski u izvještajima — morate ih registrirati kao item-scoped custom dimension u svojoj GA4 property prije nego što se pojave u izvještajima ili istraživanjima. Pogledajte Custom Dimensions in GA4 dolje za upute.

Svojstvo	Tip	Opis
property_id	string	Wink identifikator nekretnine
property_name	string	Prikazni naziv nekretnine
property_brand	string	Brend kojem nekretnina pripada
property_chain	string	Lanac kojem nekretnina pripada
property_url_name	string	URL-friendly slug nekretnine
city_name	string	Grad u kojem se nekretnina nalazi
country_code	string	ISO 3166-1 alpha-2 kod države
start_date	string	Datum prijave u formatu YYYY-MM-DD
end_date	string	Datum odjave u formatu YYYY-MM-DD
num_adults	number	Broj odraslih u rezervaciji
num_children	number	Broj djece u rezervaciji
cancellation_policy	string	Jedan od: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Identifikator cjenovnog plana
room_rate_id	string	Identifikator specifične cijene sobe
room_rate_name	string	Prikazni naziv cijene sobe
num_perks	number	Broj pogodnosti uključenih u cijenu
room_location	string	Opis lokacije sobe (npr. Overwater, Garden)
room_view	string	Opis pogleda iz sobe (npr. Ocean, City)
room_classification	string	Klasifikacija ili kategorija sobe (npr. Suite, Standard)
bed_type	string	Konfiguracija kreveta u sobi (npr. King, Twin)

---

Prilagođene dimenzije u GA4

GA4 ignorira prilagođene parametre stavke u izvještajima dok ih eksplicitno ne registrirate kao item-scoped custom dimensions. Trebate registrirati samo one parametre koje namjeravate koristiti u izvještajima — nije potrebno registrirati svih 20.

1. Otvorite Custom Definitions

   U GA4 idite na Admin (ikona zupčanika dolje lijevo) → odaberite svoju property → Data display → Custom definitions.

2. Kreirajte novu prilagođenu dimenziju

   Kliknite Create custom dimensions.

3. Ispunite detalje dimenzije

   • Dimension name — čitljiv naziv koji se pojavljuje u GA4 izvještajima (vidi tablicu dolje)
   • Scope — odaberite Item
   • Event parameter — točan naziv parametra kako se pojavljuje u dataLayer-u (vidi tablicu dolje)
   • Description — opcionalno, ali preporučeno

4. Spremite i ponovite

   Kliknite Save, zatim ponovite za svaki parametar koji želite pratiti.

Note

Prilagođene dimenzije mogu potrajati do 24 sata da se počnu prikazivati u GA4 izvještajima nakon registracije. Povijesni podaci prikupljeni prije registracije se ne nadopunjuju.

GA4 dopušta do 50 item-scoped custom dimensions po property na standardnim propertyjima (360 propertyji dopuštaju više).

Koristite sljedeću tablicu kao referencu pri kreiranju prilagođenih dimenzija. Vrijednost Event parameter mora biti točna — GA4 razlikuje velika i mala slova.

Naziv dimenzije	Event parameter	Tip
Property ID	property_id	Tekst
Property name	property_name	Tekst
Property brand	property_brand	Tekst
Property chain	property_chain	Tekst
Property URL name	property_url_name	Tekst
City name	city_name	Tekst
Country code	country_code	Tekst
Check-in date	start_date	Tekst
Check-out date	end_date	Tekst
Number of adults	num_adults	Broj
Number of children	num_children	Broj
Cancellation policy	cancellation_policy	Tekst
Rate plan ID	rate_plan_id	Tekst
Room rate ID	room_rate_id	Tekst
Room rate name	room_rate_name	Tekst
Number of perks	num_perks	Broj
Room location	room_location	Tekst
Room view	room_view	Tekst
Room classification	room_classification	Tekst
Bed type	bed_type	Tekst

---

Dodatni dostupni događaji

Sljedeći događaji su dostupni u Wink dataLayer-u, ali nisu dio standardnog lijevka rezervacije. Mogu ih aktivirati druge interakcije na platformi.

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

Ovaj događaj ne uključuje ecommerce payload.

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

Ovo je prilagođeni Wink događaj — nije dio standardnog GA4 seta događaja. Pritiskuje se pri svakoj navigaciji stranice i nosi kontekst uređaja i sesije. Ne uključuje ecommerce objekt.

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

Svojstvo	Opis
device	Detektirani tip uređaja — Desktop, Android, iPhone, iPad ili slično
deviceAgent	Izvorni user agent string
os	Detektirani operativni sustav — Windows, MacOS, Linux, UNIX
path	Trenutna putanja stranice
title	Trenutni naslov stranice
userId	Identifikator autentificiranog korisnika (izostavljen ako nije prijavljen)
startDate	Datum prijave iz trenutne sesije pretraživanja
endDate	Datum odjave iz trenutne sesije pretraživanja
guests	Broj gostiju iz trenutne sesije pretraživanja
rooms	Broj soba iz trenutne sesije pretraživanja