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 odprite nastavitve prilagajanja. V razdelku Analytics & integrations prilepite svoj GTM Container ID v polje GTM Container ID in shranite. Vaša integracija je zdaj aktivna.

3. Potrdite pri svojem ponudniku

   Č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 razdelku Analytics & integrations vaših nastavitev prilagajanja. 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 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 le podatke, ki se nanašajo na vašo nastanitev.
• Dogodek zaključene rezervacije (purchase) se sproži v brskalniku na strani zahvale. GTM Container ID je črna skrinjica — Wink ne more vedeti, katere oznake so v njem — zato Wink nikoli ne kliče Googla v vašem imenu s svojih strežnikov. Namesto tega katera koli GA4 ali konverzijska oznaka v vašem vsebniku prejme purchase na strani odjemalca, enako kot vsak drug dogodek rezervacije. Ker ponudnik plačila preusmeri brskalnik gosta stran in nazaj, Wink ponovno poveže analitično sejo, ki jo je prekinil preusmeritveni dogodek pred sprožitvijo purchase, tako da se prodaja pripiše prvotnemu obisku gosta in ne šteje kot nova seja.

---

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, da bi zastareli podatki vplivali na nove sprožilce.

Note

Vzorec ponastavitve dataLayer

Wink pred vsakim potiskom dogodka ponastavi ecommerce objekt:

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 v istem dogodku.

---

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 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 le, č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 ponudnika. coupon je prisoten le, č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 le, č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 le, č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	—	Tip 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 nivoju elementa

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 lastnini, preden se prikažejo v analizah ali standardnih poročilih. Navodila za nastavitev so v poglavju Custom Dimensions in GA4.

Lastnost	Tip	Opis
property_id	niz	Winkov 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 prihoda v formatu YYYY-MM-DD
end_date	niz	Datum odhoda 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 s ceno
room_location	niz	Opis lokacije sobe (npr. Overwater, Garden)
room_view	niz	Opis pogleda iz sobe (npr. Ocean, City)
room_classification	niz	Klasifikacija sobe ali nivo (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 na nivoju elementa. Registrirati morate le tiste parametre, ki jih želite uporabljati v poročilih — ni potrebno registrirati vseh 20.

1. Odprite Custom Definitions

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

2. Ustvarite novo po meri dimenzijo

   Kliknite Create custom dimensions.

3. Izpolnite podatke o dimenziji

   • Dimension name — berljivo ime, 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 tabelo)
   • Description — neobvezno, a priporočeno

4. Shrani in ponovi

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

Note

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

GA4 omogoča do 50 dimenzij na nivoju elementa na standardnih lastnostih (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	Zaznan tip 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 prihoda iz trenutne iskalne seje
endDate	Datum odhoda iz trenutne iskalne seje
guests	Število gostov iz trenutne iskalne seje
rooms	Število sob iz trenutne iskalne seje