Integracija GTM Analytics

Povežete lahko kateri koli Google Tag Manager (GTM) vsebnik z Wink tako, da v portal Wink vnesete njegov GTM Container ID. Ko je povezan, se vaš vsebnik samodejno naloži za vašo nastanitev in neposredno bere Winkove dogodke rezervacij — pokriva celotno pot gosta od iskanja do zaključene rezervacije. Pogosta uporaba je Sojern vsebnik za retargeting in oglaševanje, vendar kateri koli GTM vsebnik deluje enako.

Tip

To predpostavlja, da že imate GTM Container ID (format GTM-XXXXXXX). Če vaš vsebnik prihaja od partnerja, kot je Sojern, prosite svojega upravitelja računa za GTM Container ID posebej — ta se razlikuje od ID-ja piksla ali oznake. Ste novi pri Sojern? Obiščite sojern.com/contact za začetek.

---

Kaj morate storiti

1. Pridobite svoj GTM Container ID

   Pridobite svoj GTM Container ID (format GTM-XXXXXXX). Če prihaja od partnerja, kot je Sojern, posebej zahtevajte GTM Container ID — razlikuje se od ID-ja piksla ali oznake.

2. Vnesite ga v portal Wink

   Prijavite se na app.wink.travel, izberite svoj račun in pojdite na zavihek Prilagoditve. Prilepite svoj GTM Container ID v polje GTM in shranite. Vaša integracija je zdaj aktivna.

3. (Neobvezno) Dodajte GA4 Measurement ID + API Secret za strežniški nakup

   GTM vsebniki delujejo popolnoma v brskalniku gosta, zato se lahko zaključena rezervacija spregleda, če gost zapre zavihek med preusmeritvijo na plačilo. Če vaš vsebnik naloži GA4 lastnost in želite zanesljivo beleženje zaključenih rezervacij, vnesite tudi GA4 Measurement ID in Measurement Protocol API secret v razdelek GTM. Wink bo nato poslal purchase za to lastnost strežniško, točno kot je opisano v vodiču GA4 Analytics Integration. Pustite prazno, če potrebujete samo sledenje v brskalniku.

4. Potrdite s svojim ponudnikom

   Če vaš vsebnik prihaja od partnerja, kot je Sojern, obvestite svojega upravitelja računa, da je integracija aktivna. Lahko preverijo na svoji strani, da se oznake pravilno sprožajo na wink.travel za vašo nastanitev in da podatki tečejo v vaš račun.

Note

Za to integracijo ni potrebno nameščati nobene kode piksla na vašo spletno stran. Wink samodejno naloži vaš GTM vsebnik na vseh straneh, kjer je vaša nastanitev aktivna.

To deluje za kateri koli GTM Container ID — Sojern je le pogost primer.

---

Kaj Wink naredi na naši strani

Za preglednost, tukaj je, kaj Wink konfigurira, da ta integracija deluje:

• Polje GTM Container ID je na voljo v zavihku Prilagoditve v vašem Wink portalu. Ko vnesete svoj Container ID, Wink preveri format (GTM-XXXXXXX) in ga varno shrani za vašo nastanitev.
• Na vsaki strani, kjer je vaša nastanitev aktivna na Wink, se vaš vsebnik neposredno vstavi v stran — deli Winkov lasten window.dataLayer — tako da se naloži skupaj z Winkovim lastnim vsebnikom brez odvisnosti od dodatnih nastavitev. To se zgodi samodejno, brez dodatnega dela Wink ekipe za posamezno nastanitev.
• Vaš vsebnik se naloži asinhrono, zato ne vpliva na hitrost nalaganja strani za vaše goste.
• Winkovo lastno sledenje in vaš vsebnik tečeta vzporedno, bereta iz istega skupnega dataLayer. Vsak dogodek rezervacije, ki ga Wink sledi, je hkrati na voljo vašemu vsebniku.
• Ko vaša nastanitev ni ogledana — na primer, ko gost brska po drugem hotelu na Wink — vaš vsebnik ni naložen, zato prejema samo podatke, ki se nanašajo na vašo nastanitev.
• Če ste zagotovili GA4 Measurement ID + API secret (korak 3 zgoraj), se purchase za zaključene rezervacije dodatno pošlje strežniško preko GA4 Measurement Protocol, tako da je prodaja zabeležena tudi, če gost nikoli ne pride nazaj na potrditveno stran.

---

Referenca DataLayer

Wink potiska dogodke, združljive z GA4, v dataLayer skozi celotno pot gosta. Vaš GTM vsebnik bere iz istega skupnega dataLayer, zato ima vsak sprožilec ali spremenljivka, ki jo konfigurirate, dostop do vseh spodaj opisanih lastnosti.

Vsak dogodek sledi standardni GA4 strukturi Enhanced Ecommerce: vrhnji niz event in objekt ecommerce. Pred vsakim potiskom Wink počisti prejšnjo ecommerce vsebino, da prepreči prenos zastarelih podatkov v nove sprožilce.

Note

Vzorec ponastavitve dataLayer

Wink ponastavi ecommerce objekt pred vsakim potiskom dogodka:

dataLayer.push({ ecommerce: null });   // počisti prejšnji dogodek
dataLayer.push({ event: '...', ecommerce: { ... } });

Ne zanašajte se, da lastnosti ecommerce ostanejo med dogodki. Vedno jih preberite ob sprožitvi znotraj istega dogodka.

---

Dogodki poti rezervacije

Ti dogodki se sprožijo samodejno, ko gost napreduje skozi rezervacijski lijak. Konfigurirajte svoje GTM sprožilce kot Custom Event sprožilce, ki ustrezajo spodnjim imenom dogodkov.

Korak	Dogodek	Kdaj se sproži
1	view_item_list	Naloži se mreža ali seznam hotelskih kapacitet
2	view_item	Gost si ogleda stran določene nastanitve
3	add_to_cart	Gost doda sobo v nakupovalno košarico
4	begin_checkout	Naloži se stran za plačilo / zaključek nakupa
5	add_payment_info	Gost izbere način plačila
6	login	Gost se prijavi preko SSO
7	purchase	Rezervacija je potrjena
8	refund	Rezervacija je preklicana

---

view_item_list

Sproži se, ko se prikaže mreža ali seznam hotelskih kapacitet.

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

---

view_item

Sproži se, ko si gost ogleda določeno nastanitev.

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

---

add_to_cart

Sproži se, ko gost doda sobo v košarico.

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

---

begin_checkout

Sproži se, ko se naloži stran za plačilo / zaključek nakupa.

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

coupon je prisoten samo, če je bil uporabljen koda za popust.

---

add_payment_info

Sproži se, ko gost izbere ali potrdi način plačila.

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

payment_type je izpolnjen glede na vrsto plačilnega pridobitelja. coupon je prisoten samo, če je bil uporabljen koda za popust.

---

login

Sproži se, ko se gost prijavi preko enotne prijave (SSO).

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

---

purchase

Sproži se, ko je rezervacija potrjena.

{
  "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 edinstvena identifikacija rezervacijskega pogodbenega števila. coupon, shipping in tax so prisotni samo, če so relevantni.

---

refund

Sproži se, ko je rezervacija preklicana.

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

transaction_id se ujema z dogodkom purchase za isto rezervacijo. coupon, shipping in tax so prisotni samo, če so relevantni.

---

Lastnosti elementov

Vsi dogodki, ki vključujejo polje items, uporabljajo enako shemo elementov. Vsaka lastnost je neobvezna, razen če je označena kot obvezna.

Standardna GA4 polja

Ta polja GA4 nativno razume in se pojavijo v standardnih ecommerce poročilih brez dodatnih nastavitev.

Lastnost	Tip	Obvezno	Opis
item_id	niz	Da	Edinstveni identifikator sobe ali produkta
item_name	niz	—	Ime sobe ali produkta
affiliation	niz	—	Ime partnerja ali prodajalca
coupon	niz	—	Koda kupona, uporabljena za element
currency	niz	—	ISO 4217 koda valute (npr. USD)
creative_name	niz	—	Ime kreativne promocije
creative_slot	niz	—	Položaj kreativne promocije
discount	število	—	Znesek popusta
index	število	—	Položaj na seznamu (1-bazirano)
item_brand	niz	—	Ime hotela ali blagovne znamke
item_category	niz	—	Vrsta produkta — npr. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	niz	—	Identifikator seznama, kateremu element pripada
item_list_name	niz	—	Prikazno ime seznama
location_id	niz	—	Geografske koordinate nastanitve
price	število	—	Cena na enoto
promotion_id	niz	—	Identifikator promocije
promotion_name	niz	—	Prikazno ime promocije
quantity	število	—	Količina (privzeto 1)

Po meri definirani parametri na elementih

Ti parametri nosijo Wink-specifičen kontekst rezervacije. GA4 jih ne prikaže samodejno v poročilih — vsak morate registrirati kot item-scoped custom dimension v svoji GA4 lastnosti, preden se prikažejo v raziskavah ali standardnih poročilih. Za navodila glejte Custom Dimensions in GA4.

Lastnost	Tip	Opis
property_id	niz	Wink identifikator nastanitve
property_name	niz	Prikazno ime nastanitve
property_brand	niz	Blagovna znamka, ki ji nastanitev pripada
property_chain	niz	Veriga, ki ji nastanitev pripada
property_url_name	niz	URL-prijazen slug nastanitve
city_name	niz	Mesto, kjer se nastanitev nahaja
country_code	niz	ISO 3166-1 alpha-2 koda države
start_date	niz	Datum prijave v formatu YYYY-MM-DD
end_date	niz	Datum odjave v formatu YYYY-MM-DD
num_adults	število	Število odraslih v rezervaciji
num_children	število	Število otrok v rezervaciji
cancellation_policy	niz	Ena od: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	niz	Identifikator cenovnega načrta
room_rate_id	niz	Identifikator specifične cene sobe
room_rate_name	niz	Prikazno ime cene sobe
num_perks	število	Število ugodnosti, vključenih v ceno
room_location	niz	Opis lokacije sobe (npr. Overwater, Garden)
room_view	niz	Opis pogleda iz sobe (npr. Ocean, City)
room_classification	niz	Klasifikacija ali kategorija sobe (npr. Suite, Standard)
bed_type	niz	Konfiguracija postelje v sobi (npr. King, Twin)

---

Po meri definirane dimenzije v GA4

GA4 ignorira po meri definirane parametre elementov v poročilih, dokler jih ne registrirate kot dimenzije z obsegom elementa. Registrirati morate samo tiste parametre, ki jih želite uporabljati v poročilih — ni treba registrirati vseh 20.

1. Odprite Custom Definitions

   V GA4 pojdite na Admin (ikona zobnika spodaj levo) → izberite svojo lastnost → Data display → Custom definitions.

2. Ustvarite novo po meri dimenzijo

   Kliknite Create custom dimensions.

3. Izpolnite podrobnosti dimenzije

   • Dimension name — berljiv naziv, ki se prikaže v GA4 poročilih (glejte spodnjo tabelo)
   • Scope — izberite Item
   • Event parameter — natančno ime parametra, kot se pojavi v dataLayer (glejte spodnjo tabelo)
   • Description — neobvezno, a priporočeno

4. Shrani in ponovi

   Kliknite Save, nato ponovite za vsak parameter, ki ga želite spremljati.

Note

Po meri definirane dimenzije lahko do 24 ur po registraciji začnejo prikazovati podatke v GA4 poročilih. Zgodovinski podatki, zbrani pred registracijo, niso dopolnjeni.

GA4 omogoča do 50 po meri dimenzij z obsegom elementa na standardno lastnost (360 lastnosti omogočajo več).

Uporabite spodnjo tabelo kot referenco pri ustvarjanju po meri dimenzij. Vrednost Event parameter mora biti natančno enaka — GA4 je občutljiv na velike in male črke.

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

---

Dodatni razpoložljivi dogodki

Naslednji dogodki so na voljo v Wink dataLayer, vendar niso del standardnega rezervacijskega lijaka. Lahko jih sprožijo 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"
}

Ta dogodek ne vsebuje ecommerce podatkov.

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

To je po meri definiran Wink dogodek — ni del standardnega GA4 nabora dogodkov. Potiska se ob vsakem premiku med stranmi in nosi kontekst naprave in seje. Ne vsebuje objekta 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"
}

Lastnost	Opis
device	Zaznana vrsta naprave — Desktop, Android, iPhone, iPad ali podobno
deviceAgent	Izvirni niz uporabniškega agenta
os	Zaznan operacijski sistem — Windows, MacOS, Linux, UNIX
path	Trenutna pot strani
title	Trenutni naslov strani
userId	Identifikator prijavljenega uporabnika (izpuščen, če ni prijavljen)
startDate	Datum prijave iz trenutne iskalne seje
endDate	Datum odjave iz trenutne iskalne seje
guests	Število gostov iz trenutne iskalne seje
rooms	Število sob iz trenutne iskalne seje