GTM Analyticsi integratsioon

Saate ühendada mis tahes Google Tag Manageri (GTM) konteineri Winkiga, sisestades selle GTM konteineri ID Wink portaali. Kui ühendus on loodud, laaditakse teie konteiner automaatselt teie objekti jaoks ja loeb Wink’i broneerimissündmusi otse — hõlmates kogu külalisteekonda otsingust kuni broneeringu lõpuleviimiseni. Levinud kasutusjuht on Sojern konteiner sihtreklaami ja reklaami jaoks, kuid mis tahes GTM konteiner töötab samamoodi.

Tip

Eeldatakse, et teil on juba GTM konteineri ID (vormingus GTM-XXXXXXX). Kui teie konteiner pärineb partnerilt nagu Sojern, küsige oma kontohaldurilt spetsiaalselt GTM konteineri ID — see erineb pikslist või sildi ID-st. Sojerniga alustamiseks külastage sojern.com/contact.

---

Mida peate tegema

1. Hankige oma GTM konteineri ID

   Hankige oma GTM konteineri ID (vormingus GTM-XXXXXXX). Kui see pärineb partnerilt nagu Sojern, küsige spetsiaalselt GTM konteineri ID — see erineb pikslist või sildi ID-st.

2. Sisestage see Wink portaali

   Logige sisse app.wink.travel, valige oma konto ja minge vahekaardile Kohandused. Kleepige oma GTM konteineri ID välja GTM ja salvestage. Teie integratsioon on nüüd aktiivne.

3. (Valikuline) Lisage GA4 mõõte-ID + API saladus serveripoolseks ostu registreerimiseks

   GTM konteinerid töötavad täielikult külalise brauseris, seega võib broneering jääda registreerimata, kui külaline sulgeb makse suunamise ajal vahelehe. Kui teie konteiner laadib GA4 vara ja soovite, et broneeringud registreeritakse usaldusväärselt, sisestage ka selle GA4 Mõõte-ID ja Mõõteprotokolli API saladus GTM sektsiooni. Wink saadab seejärel purchase sündmuse selle vara kohta serveripoolselt, täpselt nagu on kirjeldatud juhendis GA4 Analyticsi integratsioon. Jätke need väljad tühjaks, kui vajate ainult brauseripõhist jälgimist.

4. Kinnitage oma teenusepakkujaga

   Kui teie konteiner pärineb partnerilt nagu Sojern, andke oma kontohaldurile teada, et integratsioon on aktiivne. Nad saavad kontrollida, et sildid töötavad korrektselt wink.travel lehel teie objekti jaoks ja et andmed voolavad teie kontole.

Note

Selle integratsiooni jaoks ei ole vaja oma veebisaidile paigaldada ühtegi pikslikoodi. Wink laadib teie GTM konteineri automaatselt kõigil lehtedel, kus teie objekt on aktiivne.

See töötab mis tahes GTM konteineri ID-ga — Sojern on lihtsalt tavaline näide.

---

Mida Wink meie poolel teeb

Läbipaistvuse huvides on siin, mida Wink seadistab selle integratsiooni toimimiseks:

• GTM konteineri ID väli on saadaval Wink portaali Kohandused vahekaardil. Kui sisestate oma konteineri ID, kontrollib Wink selle vormingut (GTM-XXXXXXX) ja salvestab selle turvaliselt teie objekti külge.
• Igal lehel, kus teie objekt on Winkis aktiivne, süstitakse teie konteiner otse lehele — jagades Wink’i enda window.dataLayer — nii et see laaditakse koos Wink’i enda konteineriga ilma täiendava konfiguratsioonita. See toimub automaatselt, ilma Wink meeskonna lisatööta iga objekti jaoks.
• Teie konteiner laaditakse asünkroonselt, nii et see ei mõjuta teie külaliste lehe laadimise kiirust.
• Wink’i enda jälgimine ja teie konteiner töötavad paralleelselt, lugedes samast jagatud dataLayer-ist. Iga broneerimissündmus, mida Wink jälgib, on samaaegselt teie konteineri jaoks kättesaadav.
• Kui teie objekti ei vaadata — näiteks kui külaline sirvib Winkis mõnda teist hotelli — ei laadita teie konteinerit, seega saab see ainult teie objektiga seotud andmeid.
• Kui sisestasite GA4 mõõte-ID + API saladuse (eelmine samm 3), saadetakse broneeringu purchase sündmus lisaks serveripoolselt GA4 mõõteprotokolli kaudu, nii et müük registreeritakse isegi siis, kui külaline ei naase kunagi kinnituse lehele.

---

DataLayeri viide

Wink saadab GA4-ga ühilduvaid sündmusi dataLayer-isse kogu külalisteekonna vältel. Teie GTM konteiner loeb samast jagatud dataLayer-ist, nii et iga teie seadistatud käivitaja või muutuja pääseb ligi kõigile allpool kirjeldatud omadustele.

Iga sündmus järgib standardset GA4 täiustatud e-kaubanduse struktuuri: tipp-taseme event string ja ecommerce objekt. Enne iga pushi tühjendab Wink eelneva e-kaubanduse koormuse, et vältida vanade andmete kandumist uutesse käivitajatesse.

Note

dataLayeri lähtestamise muster

Wink lähtestab e-kaubanduse objekti enne iga sündmuse pushi:

dataLayer.push({ ecommerce: null });   // eelmine sündmus tühjendatud
dataLayer.push({ event: '...', ecommerce: { ... } });

Ärge lootke, et e-kaubanduse omadused püsivad sündmuste vahel. Lugege neid alati käivitaja ajal samas sündmuses.

---

Broneerimisteekonna sündmused

Need sündmused käivituvad automaatselt, kui külaline liigub broneerimislehtris. Seadistage oma GTM käivitajad kui Kohandatud sündmuse käivitajad, mis vastavad allpool toodud sündmuste nimedele.

Samm	Sündmus	Millal käivitub
1	view_item_list	Hotelli inventari ruudustik või nimekiri laaditakse
2	view_item	Külaline vaatab konkreetset objekti lehte
3	add_to_cart	Külaline lisab toa ostukorvi
4	begin_checkout	Kassa / makse leht laaditakse
5	add_payment_info	Külaline valib makseviisi
6	login	Külaline autentib end SSO kaudu
7	purchase	Broneering kinnitatakse
8	refund	Broneering tühistatakse

---

view_item_list

Käivitub, kui hotelli inventari ruudustik või nimekiri kuvatakse.

{
  "event": "view_item_list",
  "ecommerce": {
    "item_list_id": "featured_hotels",
    "item_list_name": "Esiletõstetud hotellid",
    "items": [ ]
  }
}

---

view_item

Käivitub, kui külaline vaatab konkreetset objekti.

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

---

add_to_cart

Käivitub, kui külaline lisab toa ostukorvi.

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

---

begin_checkout

Käivitub, kui kassa / makse leht laaditakse.

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

coupon on olemas ainult siis, kui kasutati sooduskoodi.

---

add_payment_info

Käivitub, kui külaline valib või kinnitab makseviisi.

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

payment_type täidetakse makse vahendaja tüübi järgi. coupon on olemas ainult siis, kui kasutati sooduskoodi.

---

login

Käivitub, kui külaline autentib end ühe sisselogimise kaudu.

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

---

purchase

Käivitub, kui broneering kinnitatakse.

{
  "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 on unikaalne broneerimislepingu identifikaator. coupon, shipping ja tax on olemas ainult vajadusel.

---

refund

Käivitub, kui broneering tühistatakse.

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

transaction_id vastab sama broneeringu purchase sündmusele. coupon, shipping ja tax on olemas ainult vajadusel.

---

Toote omadused

Kõik sündmused, mis sisaldavad items massiivi, jagavad sama toote skeemi. Iga omadus on valikuline, välja arvatud kui on märgitud kohustuslik.

Standard GA4 väljad

Need väljad on GA4 poolt natiivsed ja ilmuvad standardsetes e-kaubanduse aruannetes ilma täiendava seadistuseta.

Omadus	Tüüp	Kohustuslik	Kirjeldus
item_id	string	Jah	Unikaalne identifikaator toa või toote jaoks
item_name	string	—	Toa või toote nimi
affiliation	string	—	Partneri või müüja nimi
coupon	string	—	Tootele rakendatud sooduskoodi kood
currency	string	—	ISO 4217 valuutakood (nt USD)
creative_name	string	—	Reklaamikampaania nimi
creative_slot	string	—	Reklaamikampaania positsioon
discount	number	—	Rakendatud allahindluse summa
index	number	—	Positsioon nimekirjas (1-põhine)
item_brand	string	—	Hotelli või brändi nimi
item_category	string	—	Toote tüüp — nt GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Nimekirja identifikaator, kuhu toode kuulub
item_list_name	string	—	Nimekirja kuvatav nimi
location_id	string	—	Objekti geokoordinaadid
price	number	—	Ühiku hind
promotion_id	string	—	Kampaania identifikaator
promotion_name	string	—	Kampaania kuvatav nimi
quantity	number	—	Kogus (vaikimisi 1)

Kohandatud tooteparameetrid

Need parameetrid kannavad Wink-spetsiifilist broneerimiskonteksti. GA4 ei kuva neid aruannetes automaatselt — peate igaühe registreerima kui tooteulatuses kohandatud mõõdiku oma GA4 varas, enne kui need ilmuvad uurimistes või standardsetes aruannetes. Vaadake allpool Kohandatud mõõdikud GA4-s seadistamise juhiseid.

Omadus	Tüüp	Kirjeldus
property_id	string	Wink objekti identifikaator
property_name	string	Objekti kuvatav nimi
property_brand	string	Bränd, millele objekt kuulub
property_chain	string	Kett, millele objekt kuulub
property_url_name	string	URL-sõbralik nimi objektile
city_name	string	Linn, kus objekt asub
country_code	string	ISO 3166-1 alfa-2 riigikood
start_date	string	Sisseregistreerimise kuupäev vormingus AAAA-KK-PP
end_date	string	Väljaregistreerimise kuupäev vormingus AAAA-KK-PP
num_adults	number	Täiskasvanute arv broneeringus
num_children	number	Laste arv broneeringus
cancellation_policy	string	Üks järgmistest: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Hinnaplaani identifikaator
room_rate_id	string	Konkreetse toa hinna identifikaator
room_rate_name	string	Toa hinna kuvatav nimi
num_perks	number	Hinnaplaaniga kaasnevate lisade arv
room_location	string	Toa asukoha kirjeldus (nt Overwater, Garden)
room_view	string	Toa vaate kirjeldus (nt Ocean, City)
room_classification	string	Toa klassifikatsioon või tase (nt Suite, Standard)
bed_type	string	Toa voodikonfiguratsioon (nt King, Twin)

---

Kohandatud mõõdikud GA4-s

GA4 ignoreerib kohandatud tooteparameetreid aruannetes, kuni need on registreeritud kui tooteulatuses kohandatud mõõdikud. Registreerima peate ainult need parameetrid, mida soovite aruannetes kasutada — kõiki 20 ei ole vaja registreerida.

1. Avage Kohandatud määratlused

   GA4-s minge Admin (vasakus allnurgas hammasratta ikoon) → valige oma vara → Andmete kuvamine → Kohandatud määratlused.

2. Looge uus kohandatud mõõdik

   Klõpsake Loo kohandatud mõõdikud.

3. Täida mõõdiku andmed

   • Mõõdiku nimi — inimloetav silt, mis kuvatakse GA4 aruannetes (vt allolevat tabelit)
   • Ulatus — valige Item
   • Sündmuse parameeter — täpne parameetri nimi, nagu see on dataLayer’is (vt tabelit)
   • Kirjeldus — valikuline, kuid soovitatav

4. Salvesta ja korda

   Klõpsake Salvesta ja korrake iga jälgitava parameetri puhul.

Note

Kohandatud mõõdikute ilmumine GA4 aruannetes võib võtta kuni 24 tundi pärast registreerimist. Ajaloolisi andmeid, mis koguti enne registreerimist, ei täideta tagantjärele.

GA4 lubab standardvarade puhul kuni 50 tooteulatuses kohandatud mõõdikut (360 varade puhul rohkem).

Kasutage allolevat tabelit viitena kohandatud mõõdikute loomisel. Sündmuse parameeter väärtus peab olema täpne — GA4 on tõstutundlik.

Mõõdiku nimi	Sündmuse parameeter	Tüüp
Objekti ID	property_id	Tekst
Objekti nimi	property_name	Tekst
Objekti bränd	property_brand	Tekst
Objekti kett	property_chain	Tekst
Objekti URL nimi	property_url_name	Tekst
Linna nimi	city_name	Tekst
Riigi kood	country_code	Tekst
Sisseregistreerimise kuupäev	start_date	Tekst
Väljaregistreerimise kuupäev	end_date	Tekst
Täiskasvanute arv	num_adults	Number
Laste arv	num_children	Number
Tühistamispoliitika	cancellation_policy	Tekst
Hinnaplaani ID	rate_plan_id	Tekst
Toa hinna ID	room_rate_id	Tekst
Toa hinna nimi	room_rate_name	Tekst
Lisade arv	num_perks	Number
Toa asukoht	room_location	Tekst
Toa vaade	room_view	Tekst
Toa klassifikatsioon	room_classification	Tekst
Vooditüüp	bed_type	Tekst

---

Täiendavad saadaval sündmused

Järgmised sündmused on saadaval Wink dataLayer’is, kuid ei kuulu standardse broneerimislehtri hulka. Neid võivad käivitada muud platvormi interaktsioonid.

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": "Esiletõstetud hotellid",
    "items": [ ]
  }
}

view_cart

{
  "event": "view_cart"
}

Selle sündmusega ei kaasne ecommerce objekti.

view_promotion

{
  "event": "view_promotion",
  "ecommerce": {
    "creative_name": "Suvebänner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Suvemüük",
    "items": [ ]
  }
}

select_promotion

{
  "event": "select_promotion",
  "ecommerce": {
    "creative_name": "Suvebänner",
    "creative_slot": "hero",
    "promotion_id": "promo_001",
    "promotion_name": "Suvemüük",
    "items": [ ]
  }
}

search

{
  "event": "search",
  "ecommerce": {
    "search_term": "rannikuäärne kuurort"
  }
}

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": "Toa uuendus"
  }
}

level_start

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

level_end

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

See on kohandatud Wink sündmus — ei kuulu standardse GA4 sündmuste komplekti. See saadetakse iga lehe navigeerimise ajal ja kannab seadme ning sessiooni konteksti. See ei sisalda ecommerce objekti.

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

Omadus	Kirjeldus
device	Tuvastatud seadme tüüp — Desktop, Android, iPhone, iPad või sarnane
deviceAgent	Kasutajaagendi string
os	Tuvastatud operatsioonisüsteem — Windows, MacOS, Linux, UNIX
path	Praeguse lehe rada
title	Praeguse lehe pealkiri
userId	Autentitud kasutaja identifikaator (jätab välja, kui pole sisse logitud)
startDate	Sisseregistreerimise kuupäev praegusest otsingusessioonist
endDate	Väljaregistreerimise kuupäev praegusest otsingusessioonist
guests	Külaliste arv praegusest otsingusessioonist
rooms	Tubade arv praegusest otsingusessioonist