Sojern Pixel -integraatio

Jos suoritat mainoskampanjoita Sojernin kautta, voit yhdistää Sojern-tilisi Winkiin syöttämällä Sojern GTM Container ID -tunnuksesi Wink-portaaliin. Kun yhteys on muodostettu, Sojernin seurantapikseli aktivoituu automaattisesti kiinteistölläsi — kattaen koko vieraan matkan hausta aina varauksen vahvistumiseen asti.

Vinkki

Tämä edellyttää, että sinulla on jo aktiivinen Sojern-tili ja olet saanut GTM Container ID -tunnuksesi Sojern-tilisi yhteyshenkilöltä. Jos sinulla ei vielä ole Sojern-tiliä, käy osoitteessa sojern.com/contact aloittaaksesi.

---

Mitä sinun tulee tehdä

1. Hanki GTM Container ID Sojernilta

   Ota yhteyttä Sojern-tilisi yhteyshenkilöön ja pyydä GTM Container ID -tunnuksesi. Se on muotoa GTM-XXXXXXX. Tämä eroaa Sojern Pixel ID:stä — varmista, että pyydät nimenomaan GTM Container ID:tä.

2. Syötä se Wink-portaaliin

   Kirjaudu sisään osoitteessa my.wink.travel, valitse tilisi ja siirry Customizations-välilehdelle. Liitä Sojern GTM Container ID Sojern-kenttään ja tallenna. Integraatiosi on nyt käytössä.

3. Vahvista Sojern-tilisi yhteyshenkilön kanssa

   Ilmoita Sojern-tilisi yhteyshenkilölle, että integraatio on aktiivinen. He voivat tarkistaa omalta puoleltaan, että pikseli aktivoituu oikein wink.travel-sivustolla kiinteistölläsi ja että tiedot virtaavat Sojern-tilillesi.

Huomio

Tätä integraatiota varten sinun ei tarvitse lisätä pikselikoodia omalle verkkosivustollesi. Wink lataa Sojern-kontainerisi automaattisesti kaikilla sivuilla, joilla kiinteistösi on aktiivinen.

Tämä asetus toimii minkä tahansa mukautetun GTM Container ID:n kanssa. Käytimme Sojernia esimerkkinä, koska se on hyvin yleinen integraatio.

---

Mitä Wink tekee omalla puolellaan

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

• Sojern GTM Container ID -kenttä on saatavilla Wink-portaalin Customizations-välilehdellä. Kun syötät Container ID:n, Wink tarkistaa muodon ja tallentaa sen turvallisesti kiinteistöösi.
• Jokaisella sivulla, jolla kiinteistösi on aktiivinen Winkissä, Sojern GTM Container ID upotetaan sivulle ja Winkin tagien hallintajärjestelmä lataa dynaamisesti Sojern-kontainerisi oman kontainerinsa rinnalle. Tämä tapahtuu automaattisesti — Wink-tiimiltä ei vaadita manuaalisia toimenpiteitä kiinteistökohtaisesti.
• Sojern-kontainerisi ladataan asynkronisesti, eli se ei vaikuta sivun latausnopeuteen vieraillesi.
• Winkin oma seuranta ja Sojern-pikseli toimivat rinnakkain, käyttäen samaa jaettua tapahtumatietoa. Jokainen varaukseen liittyvä tapahtuma, jonka Wink seuraa, on samanaikaisesti saatavilla Sojern-kontainerillesi.
• Kun kiinteistöäsi ei katsota — esimerkiksi kun vieras selaa toista hotellia Winkissä — Sojern-kontaineria ei ladata. Tämä varmistaa, että Sojern saa vain kiinteistöäsi koskevia tietoja.

---

DataLayer-viite

Wink työntää GA4-yhteensopivia tapahtumia dataLayer-taulukkoon koko vieraan matkan ajan. GTM-kontainerisi lukee tästä samasta jaetusta dataLayer-taulukosta, 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 työntöä Wink tyhjentää edellisen ecommerce-payloadin estääkseen vanhentuneiden tietojen siirtymisen uusiin triggereihin.

Huomio

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 aktivoituvat automaattisesti, kun vieras etenee varausprosessissa. Määritä GTM-triggerisi Custom Event -triggereiksi, jotka vastaavat alla olevia tapahtumanimiä.

Vaihe	Tapahtuma	Milloin se aktivoituu
1	view_item_list	Hotellivaraston ruudukko 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	Varaus vahvistetaan
8	refund	Varaus peruutetaan

---

view_item_list

Aktivoituu, kun hotellivaraston ruudukko tai lista renderöidään.

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

---

view_item

Aktivoituu, kun vieras katsoo tiettyä kiinteistöä.

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

---

add_to_cart

Aktivoituu, kun vieras lisää huoneen ostoskoriin.

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

---

begin_checkout

Aktivoituu, 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

Aktivoituu, 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 tyypillä. coupon on mukana vain, jos alennuskoodi on käytössä.

---

login

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

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

---

purchase

Aktivoituu, 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 varauskohtainen yksilöllinen tunniste. coupon, shipping ja tax ovat mukana vain, jos ne ovat sovellettavissa.

---

refund

Aktivoituu, 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 tunnistetta kuin purchase-tapahtumassa. coupon, shipping ja tax ovat mukana vain, jos ne ovat sovellettavissa.

---

Tuoteominaisuudet

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

GA4:n standardikentä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	merkkijono	Kyllä	Huoneen tai tuotteen yksilöllinen tunniste
item_name	merkkijono	—	Huoneen tai tuotteen nimi
affiliation	merkkijono	—	Kumppani- tai myyjän nimi
coupon	merkkijono	—	Tuotteeseen sovellettu alennuskoodi
currency	merkkijono	—	ISO 4217 valuuttakoodi (esim. USD)
creative_name	merkkijono	—	Kampanjan luova nimi
creative_slot	merkkijono	—	Kampanjan luovan sijoituspaikka
discount	numero	—	Sovellettu alennusmäärä
index	numero	—	Sijainti listalla (1-pohjainen)
item_brand	merkkijono	—	Hotelli tai tuotemerkki
item_category	merkkijono	—	Tuotetyyppi — esim. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	merkkijono	—	Listan tunniste, johon tuote kuuluu
item_list_name	merkkijono	—	Listan näyttönimi
location_id	merkkijono	—	Kiinteistön maantieteelliset koordinaatit
price	numero	—	Yksikköhinta
promotion_id	merkkijono	—	Kampanjan tunniste
promotion_name	merkkijono	—	Kampanjan näyttönimi
quantity	numero	—	Määrä (oletus 1)

Mukautetut tuoteparametrit

Nämä parametrit sisältävät Wink-spesifin varauskontekstin. GA4 ei automaattisesti näytä niitä raporteissa — sinun tulee rekisteröidä jokainen niistä tuotealuekohtaiseksi 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	merkkijono	Wink-kiinteistön tunniste
property_name	merkkijono	Kiinteistön näyttönimi
property_brand	merkkijono	Kiinteistön tuotemerkki
property_chain	merkkijono	Kiinteistön ketju
property_url_name	merkkijono	Kiinteistön URL-ystävällinen tunniste
city_name	merkkijono	Kiinteistön kaupunki
country_code	merkkijono	ISO 3166-1 alpha-2 -maatunnus
start_date	merkkijono	Saapumispäivä muodossa YYYY-MM-DD
end_date	merkkijono	Lähtöpäivä muodossa YYYY-MM-DD
num_adults	numero	Aikuisten lukumäärä varauksessa
num_children	numero	Lasten lukumäärä varauksessa
cancellation_policy	merkkijono	Yksi seuraavista: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	merkkijono	Hintasuunnitelman tunniste
room_rate_id	merkkijono	Tietyn huonehinnan tunniste
room_rate_name	merkkijono	Huonehinnan näyttönimi
num_perks	numero	Hintaan sisältyvien etujen lukumäärä
room_location	merkkijono	Huoneen sijaintikuvaus (esim. Overwater, Garden)
room_view	merkkijono	Huoneen näkymäkuvaus (esim. Ocean, City)
room_classification	merkkijono	Huoneen luokitus tai taso (esim. Suite, Standard)
bed_type	merkkijono	Huoneen vuodejärjestely (esim. King, Twin)

---

Mukautetut ulottuvuudet GA4:ssa

GA4 ei huomioi mukautettuja tuoteparametreja raporteissa, ennen kuin rekisteröit ne nimenomaan tuotealuekohtaisiksi mukautetuiksi ulottuvuuksiksi. Sinun ei tarvitse rekisteröidä kaikkia 20, vaan vain ne, joita aiot käyttää raporteissa.

1. Avaa Mukautetut määritelmät

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

2. Luo uusi mukautettu ulottuvuus

   Klikkaa Create custom dimensions.

3. 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, kuten se näkyy dataLayerissa (katso alla oleva taulukko)
   • Description — valinnainen, mutta suositeltava

4. Tallenna ja toista

   Klikkaa Save ja toista jokaiselle seurattavalle parametrille.

Huomio

Mukautettujen ulottuvuuksien näkyminen GA4-raporteissa voi kestää jopa 24 tuntia rekisteröinnin jälkeen. Ennen rekisteröintiä kerättyjä historiallisia tietoja ei täydennetä jälkikäteen.

GA4 sallii enintään 50 tuotealuekohtaista mukautettua ulottuvuutta per omaisuus (360-ominaisuuksissa enemmän).

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 tuotemerkki	property_brand	Teksti
Kiinteistön ketju	property_chain	Teksti
Kiinteistön URL-nimi	property_url_name	Teksti
Kaupungin nimi	city_name	Teksti
Maatunnus	country_code	Teksti
Saapumispäivä	start_date	Teksti
Lähtöpäivä	end_date	Teksti
Aikuisten lukumäärä	num_adults	Numero
Lasten lukumää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 lukumää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 dataLayerissa, mutta ne eivät kuulu standardiin varausputkeen. Ne voivat aktivoitua muista alustan toiminnoista.

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 mukautettu Wink-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 lukumäärä nykyisestä hakusessiosta
rooms	Huoneiden lukumäärä nykyisestä hakusessiosta