GTM-analytiikka-integraatio

Voit yhdistää minkä tahansa Google Tag Manager (GTM) -säiliön Winkiin syöttämällä sen GTM Container ID:n Wink-portaaliin. Kun säiliö on yhdistetty, se ladataan automaattisesti kiinteistöllesi ja lukee Wink:n varaus tapahtumat suoraan — kattaen koko vieraan matkan hausta aina varauksen vahvistamiseen asti. Yleinen käyttötapaus on Sojern-säiliö uudelleenmarkkinointiin ja mainontaan, mutta mikä tahansa GTM-säiliö toimii samalla tavalla.

Mitä sinun tulee tehdä

Hanki GTM Container ID

Hanki GTM Container ID (muodossa GTM-XXXXXXX). Jos se tulee kumppanilta kuten Sojern, pyydä nimenomaan GTM Container ID — se eroaa pikseli- tai tagi-ID:stä.
Syötä se Wink-portaaliin

Kirjaudu sisään osoitteessa app.wink.travel, valitse tilisi ja siirry Customizations-välilehdelle. Liitä GTM Container ID GTM-kenttään ja tallenna. Integraatiosi on nyt käytössä.
(Valinnainen) Lisää GA4 Measurement ID + API-salaisuus palvelinpuolen ostotapahtumia varten

GTM-säiliöt toimivat kokonaan vieraan selaimessa, joten vahvistettu varaus voi jäädä rekisteröitymättä, jos vieras sulkee välilehden maksun uudelleenohjauksen aikana. Jos säiliösi lataa GA4-omaisuuden ja haluat varmistaa varauksien luotettavan kirjaamisen, syötä myös kyseisen GA4:n Measurement ID ja Measurement Protocol API -salaisuus GTM-kohdassa. Wink lähettää tällöin purchase-tapahtuman palvelinpuolella, kuten on kuvattu GA4 Analytics Integration -oppaassa. Jätä nämä tyhjiksi, jos tarvitset vain selaimessa tapahtuvaa seurantaa.
Vahvista palveluntarjoajasi kanssa

Jos säiliösi tulee kumppanilta kuten Sojern, ilmoita tilinhoitajallesi, että integraatio on aktiivinen. He voivat tarkistaa omalta puoleltaan, että tagit laukeavat oikein wink.travel-sivustolla kiinteistöllesi ja että data virtaa tilillesi.

Mitä Wink tekee omalla puolellaan

Läpinäkyvyyden vuoksi tässä on, mitä Wink konfiguroi tämän integraation toimimiseksi:

GTM Container ID -kenttä on saatavilla Wink-portaalin Customizations-välilehdellä. Kun syötät Container ID:n, Wink tarkistaa muodon (GTM-XXXXXXX) ja tallentaa sen turvallisesti kiinteistöösi.
Jokaisella sivulla, jolla kiinteistösi on aktiivinen Winkissä, säiliösi upotetaan suoraan sivulle — jakamalla Wink:n oma window.dataLayer — joten se ladataan rinnakkain Wink:n oman säiliön kanssa ilman lisäkonfiguraatiota. Tämä tapahtuu automaattisesti, ilman erillistä työtä Wink-tiimiltä.
Säiliösi ladataan asynkronisesti, joten se ei vaikuta sivun latausnopeuteen vieraille.
Wink:n oma seuranta ja säiliösi toimivat rinnakkain, lukien samaa jaettua dataLayer-objektia. Jokainen varauksen tapahtuma, jonka Wink seuraa, on samanaikaisesti saatavilla säiliöllesi.
Kun kiinteistöäsi ei katsota — esimerkiksi kun vieras selaa toista hotellia Winkissä — säiliötäsi ei ladata, joten se saa vain kiinteistöäsi koskevat tiedot.
Jos annoit GA4 Measurement ID:n + API-salaisuuden (kohdassa 3 yllä), vahvistettujen varausten purchase-tapahtuma lähetetään lisäksi palvelinpuolella GA4 Measurement Protocolin kautta, joten myynti kirjautuu, vaikka vieras ei palaisi vahvistussivulle.

DataLayer-viite

Wink työntää GA4-yhteensopivia tapahtumia dataLayer-objektiin koko vieraan matkan ajan. GTM-säiliösi lukee tästä samasta jaetusta dataLayer-objektista, joten kaikki määrittämäsi triggerit tai muuttujat pääsevät käsiksi alla kuvattuihin ominaisuuksiin.

Jokainen tapahtuma noudattaa standardia GA4 Enhanced Ecommerce -rakennetta: ylin event-merkkijono ja ecommerce-objekti. Ennen jokaista push-toimintoa Wink tyhjentää edellisen ecommerce-payloadin estääkseen vanhojen tietojen vuotamisen uusiin triggereihin.

dataLayerin nollausmalli

Wink nollaa ecommerce-objektin ennen jokaista tapahtuman työntöä:

dataLayer.push({ ecommerce: null });   // tyhjennä edellinen tapahtuma
dataLayer.push({ event: '...', ecommerce: { ... } });

Älä luota siihen, että ecommerce-ominaisuudet säilyvät tapahtumien välillä. Lue ne aina triggerin aikana saman tapahtuman sisällä.

Varausmatkan tapahtumat

Nämä tapahtumat laukeavat automaattisesti, kun vieras etenee varausputkessa. Määritä GTM-triggerisi Custom Event -triggereiksi, jotka vastaavat alla olevia tapahtumanimiä.

Vaihe	Tapahtuma	Milloin laukeaa
1	`view_item_list`	Hotellin varausnäkymä tai lista latautuu
2	`view_item`	Vieras katsoo tiettyä kiinteistön sivua
3	`add_to_cart`	Vieras lisää huoneen ostoskoriin
4	`begin_checkout`	Kassalle/maksusivulle siirrytään
5	`add_payment_info`	Vieras valitsee maksutavan
6	`login`	Vieras kirjautuu sisään SSO:n kautta
7	`purchase`	Vahvistettu varaus
8	`refund`	Varauksen peruutus

`view_item_list`

Laukeaa, kun hotellin varausnäkymä tai lista renderöidään.

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

`view_item`

Laukeaa, kun vieras katsoo tiettyä kiinteistöä.

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

`add_to_cart`

Laukeaa, kun vieras lisää huoneen ostoskoriin.

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

`begin_checkout`

Laukeaa, kun kassalle/maksusivulle siirrytään.

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

coupon on mukana vain, jos alennuskoodi on käytössä.

`add_payment_info`

Laukeaa, kun vieras valitsee tai vahvistaa maksutavan.

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

payment_type täytetään maksun hankkijan tyypistä. coupon on mukana vain, jos alennuskoodi on käytössä.

`login`

Laukeaa, kun vieras kirjautuu sisään single sign-on -menetelmällä.

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

`purchase`

Laukeaa, kun varaus vahvistetaan.

{
  "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 varauksen yksilöllinen sopimusnumero. coupon, shipping ja tax ovat mukana vain, jos sovellettavissa.

`refund`

Laukeaa, kun varaus peruutetaan.

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

transaction_id vastaa samaa purchase-tapahtumaa kyseiselle varaukselle. coupon, shipping ja tax ovat mukana vain, jos sovellettavissa.

Kohteen ominaisuudet

Kaikilla tapahtumilla, jotka sisältävät items-taulukon, on sama kohteen skeema. Jokainen ominaisuus on valinnainen, ellei toisin mainita.

Standardit GA4-kentät

Nämä kentät ovat GA4:n natiivisti ymmärtämiä ja näkyvät standardeissa ecommerce-raporteissa ilman lisäkonfiguraatiota.

Ominaisuus	Tyyppi	Pakollinen	Kuvaus
`item_id`	string	Kyllä	Huoneen tai tuotteen yksilöllinen tunniste
`item_name`	string	—	Huoneen tai tuotteen nimi
`affiliation`	string	—	Kumppani- tai myyjän nimi
`coupon`	string	—	Kohteeseen sovellettu alennuskoodi
`currency`	string	—	ISO 4217 valuuttakoodi (esim. `USD`)
`creative_name`	string	—	Kampanjan nimi
`creative_slot`	string	—	Kampanjan sijoituspaikka
`discount`	number	—	Sovellettu alennusmäärä
`index`	number	—	Sijainti listalla (1-pohjainen)
`item_brand`	string	—	Hotelli tai tuotemerkki
`item_category`	string	—	Tuotetyyppi — esim. `GUEST_ROOM`, `ACTIVITY`, `ATTRACTION`, `MEETING_ROOM`, `RESTAURANT`, `SPA`
`item_list_id`	string	—	Listan tunniste, johon kohde kuuluu
`item_list_name`	string	—	Listan näyttönimi
`location_id`	string	—	Kiinteistön maantieteelliset koordinaatit
`price`	number	—	Yksikköhinta
`promotion_id`	string	—	Kampanjan tunniste
`promotion_name`	string	—	Kampanjan näyttönimi
`quantity`	number	—	Määrä (oletus `1`)

Mukautetut kohdekohtaiset parametrit

Nämä parametrit sisältävät Wink-spesifisen varauskontekstin. GA4 ei automaattisesti näytä niitä raporteissa — sinun tulee rekisteröidä jokainen niistä kohdekohtaiseksi mukautetuksi ulottuvuudeksi GA4-omaisuudessasi ennen kuin ne näkyvät tutkimuksissa tai standardiraporteissa. Katso Mukautetut ulottuvuudet GA4:ssa alla asennusohjeet.

Ominaisuus	Tyyppi	Kuvaus
`property_id`	string	Wink-kiinteistön tunniste
`property_name`	string	Kiinteistön näyttönimi
`property_brand`	string	Kiinteistön brändi
`property_chain`	string	Kiinteistöketju
`property_url_name`	string	Kiinteistön URL-ystävällinen tunniste
`city_name`	string	Kaupunki, jossa kiinteistö sijaitsee
`country_code`	string	ISO 3166-1 alpha-2 -maakoodi
`start_date`	string	Saapumispäivä muodossa `YYYY-MM-DD`
`end_date`	string	Lähtöpäivä muodossa `YYYY-MM-DD`
`num_adults`	number	Aikuisten määrä varauksessa
`num_children`	number	Lasten määrä varauksessa
`cancellation_policy`	string	Yksi seuraavista: `Refundable`, `Non-Refundable`, `Refundable-With-Restrictions`, `Non-Refundable-With-Restrictions`
`rate_plan_id`	string	Hintasuunnitelman tunniste
`room_rate_id`	string	Tietyn huonehinnan tunniste
`room_rate_name`	string	Huonehinnan näyttönimi
`num_perks`	number	Hintaan sisältyvien etujen määrä
`room_location`	string	Huoneen sijaintikuvaus (esim. `Overwater`, `Garden`)
`room_view`	string	Huoneen näkymäkuvaus (esim. `Ocean`, `City`)
`room_classification`	string	Huoneen luokitus tai taso (esim. `Suite`, `Standard`)
`bed_type`	string	Huoneen vuodejärjestely (esim. `King`, `Twin`)

Mukautetut ulottuvuudet GA4:ssa

GA4 ei huomioi mukautettuja kohdeparametreja raporteissa, ennen kuin rekisteröit ne nimenomaan kohdekohtaisiksi mukautetuiksi ulottuvuuksiksi. Sinun tarvitsee rekisteröidä vain ne parametrit, joita aiot käyttää raporteissa — kaikkia 20 ei tarvitse rekisteröidä.

Avaa Mukautetut määritelmät

GA4:ssa siirry kohtaan Admin (vasen alakulman rataskuvake) → valitse omaisuutesi → Data display → Custom definitions.
Luo uusi mukautettu ulottuvuus

Klikkaa Create custom dimensions.
Täytä ulottuvuuden tiedot
- Dimension name — ihmisen luettava nimi, joka näkyy GA4-raporteissa (katso alla oleva taulukko)
- Scope — valitse Item
- Event parameter — tarkka parametri nimi, kuten dataLayerissa (katso alla oleva taulukko)
- Description — valinnainen, mutta suositeltava
Tallenna ja toista

Klikkaa Save ja toista jokaiselle seurattavalle parametrille.

Käytä alla olevaa taulukkoa viitteenä mukautettuja ulottuvuuksia luodessasi. Event parameter -arvon on oltava täsmälleen sama — GA4 on kirjainkoolla herkkä.

Ulottuvuuden nimi	Event parameter	Tyyppi
Kiinteistön tunniste	`property_id`	Teksti
Kiinteistön nimi	`property_name`	Teksti
Kiinteistön brändi	`property_brand`	Teksti
Kiinteistöketju	`property_chain`	Teksti
Kiinteistön URL-nimi	`property_url_name`	Teksti
Kaupungin nimi	`city_name`	Teksti
Maakoodi	`country_code`	Teksti
Saapumispäivä	`start_date`	Teksti
Lähtöpäivä	`end_date`	Teksti
Aikuisten määrä	`num_adults`	Numero
Lasten määrä	`num_children`	Numero
Peruutusehdot	`cancellation_policy`	Teksti
Hintasuunnitelman tunniste	`rate_plan_id`	Teksti
Huonehinnan tunniste	`room_rate_id`	Teksti
Huonehinnan nimi	`room_rate_name`	Teksti
Etujen määrä	`num_perks`	Numero
Huoneen sijainti	`room_location`	Teksti
Huoneen näkymä	`room_view`	Teksti
Huoneen luokitus	`room_classification`	Teksti
Vuodetyyppi	`bed_type`	Teksti

Lisätapahtumat

Seuraavat tapahtumat ovat saatavilla Wink:n dataLayerissa, mutta eivät kuulu standardiin varausputkeen. Ne voivat laueta muista vuorovaikutuksista alustalla.

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

Tässä tapahtumassa ei ole ecommerce-objektia.

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

Tämä on Wink-spesifinen tapahtuma — ei osa standardia GA4-tapahtumasarjaa. Se työntyy jokaisella sivunavigoinnilla ja sisältää laitteen ja istunnon kontekstin. Se ei sisällä ecommerce-objektia.

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

Ominaisuus	Kuvaus
`device`	Havaitun laitteen tyyppi — `Desktop`, `Android`, `iPhone`, `iPad` tai vastaava
`deviceAgent`	Raaka käyttäjäagenttijono
`os`	Havaittu käyttöjärjestelmä — `Windows`, `MacOS`, `Linux`, `UNIX`
`path`	Nykyisen sivun polku
`title`	Nykyisen sivun otsikko
`userId`	Tunnistettu käyttäjätunniste (pois jätetty, jos ei kirjautunut)
`startDate`	Saapumispäivä nykyisestä hakusessiosta
`endDate`	Lähtöpäivä nykyisestä hakusessiosta
`guests`	Vieraiden määrä nykyisessä hakusessiosta
`rooms`	Huoneiden määrä nykyisessä hakusessiosta