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 kasutusjuhtum on Sojern konteiner sihtreklaami ja reklaami jaoks, kuid mis tahes GTM konteiner töötab samamoodi.

Mida peate tegema

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.
Sisestage see Wink portaali

Logige sisse app.wink.travel, valige oma konto ja avage kohandamise seaded. Jaotises Analytics & integrations kleepige oma GTM konteineri ID välja GTM Container ID ja salvestage. Teie integratsioon on nüüd aktiivne.
Kinnitage oma teenusepakkujaga

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

Mida Wink meie pool teeb

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

GTM konteineri ID väli on saadaval teie kohandamise seadete jaotises Analytics & integrations. 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’i 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, nii et see saab ainult teie objekti jaoks olulisi andmeid.
Lõpetatud broneeringu (purchase) sündmus käivitub brauseris tänulehel. GTM konteineri ID on must kast — Wink ei saa eeldada, millised sildid seal sees on — seega Wink ei tee Google’i poolelt serveripoolseid kutsungeid teie nimel. Selle asemel saab teie konteineris olev GA4 või konversioonisilt purchase sündmuse kliendipoolse täpselt samamoodi nagu kõik teised broneerimissündmused. Kuna makseteenuse pakkuja suunab külalise brauseri eemale ja tagasi, ühendab Wink analüütika seansi, mille suunamine katkestas, enne purchase sündmuse käivitamist, nii et müük omistatakse külalise algsele külastusele, mitte ei loeta uue seansina.

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 konfigureeritav käivitaja või muutuja pääseb ligi kõigile allpool kirjeldatud omadustele.

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

dataLayeri lähtestamise muster

Wink lähtestab ecommerce objekti enne iga sündmuse pushi:

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

Ärge lootke, et ecommerce omadused püsivad sündmuste vahel. Lugege neid alati käivitamise ajal samas sündmuses.

Broneerimisteekonna sündmused

Need sündmused käivituvad automaatselt, kui külaline liigub broneerimislehtris. Konfigureerige oma GTM käivitajad kui Custom Event tüüpi, 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": "Featured Hotels",
    "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 sooduskood oli rakendatud.

`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 omandaja tüübi alusel. coupon on olemas ainult siis, kui sooduskood oli rakendatud.

`login`

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

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

`purchase`

Käivitub, kui broneering on kinnitatud.

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

Standardseid GA4 välju

Need väljad on GA4 poolt natiivsed ja ilmuvad standardsetes ecommerce aruannetes ilma täiendava konfiguratsioonita.

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	—	Kampaania loominguline nimi
`creative_slot`	string	—	Kampaania loominguline 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 kuvamise nimi
`location_id`	string	—	Objekti geokoordinaadid
`price`	number	—	Ühiku hind
`promotion_id`	string	—	Kampaania identifikaator
`promotion_name`	string	—	Kampaania kuvamise 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 omaduses, 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 kuvamise nimi
`property_brand`	string	Bränd, millele objekt kuulub
`property_chain`	string	Kett, millele objekt kuulub
`property_url_name`	string	URL-sõbralik nimi objekti jaoks
`city_name`	string	Linn, kus objekt asub
`country_code`	string	ISO 3166-1 alfa-2 riigikood
`start_date`	string	Sisseregistreerimise kuupäev vormingus `YYYY-MM-DD`
`end_date`	string	Väljaregistreerimise kuupäev vormingus `YYYY-MM-DD`
`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 kuvamise 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 voodi konfiguratsioon (nt `King`, `Twin`)

Kohandatud mõõdikud GA4-s

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

Avage Kohandatud definitsioonid

GA4-s minge Admin (vasakus allnurgas hammasratta ikoon) → valige oma omadus → Data display → Custom definitions.
Looge uus kohandatud mõõdik

Klõpsake Create custom dimensions.
Täitage mõõdiku andmed
- Dimension name — inimloetav silt, mis ilmub GA4 aruannetes (vt allolevat tabelit)
- Scope — valige Item
- Event parameter — täpne parameetri nimi, nagu see ilmub dataLayer’is (vt allolevat tabelit)
- Description — valikuline, kuid soovitatav
Salvestage ja korrake

Klõpsake Save ja korrake iga jälgitava parameetri jaoks.

Kasutage allolevat tabelit viitena kohandatud mõõdikute loomisel. Event parameter väärtus peab olema täpne — GA4 on tõstutundlik.

Mõõdiku nimi	Event parameter	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
Voodi tüü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 platvormi muud 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": "Featured Hotels",
    "items": [ ]
  }
}

`view_cart`

{
  "event": "view_cart"
}

Selle sündmusega ei kaasne ecommerce objekti.

`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`

See on kohandatud Wink sündmus — ei kuulu standardse GA4 sündmuste komplekti. See lükatakse iga lehe navigeerimise ajal ja kannab seadme ning seansi 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 toorstring
`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 otsinguseansist
`endDate`	Väljaregistreerimise kuupäev praegusest otsinguseansist
`guests`	Külaliste arv praegusest otsinguseansist
`rooms`	Tubade arv praegusest otsinguseansist