GTM analītikas integrācija

Jūs varat savienot jebkuru Google Tag Manager (GTM) konteineru ar Wink, ievadot tā GTM konteineru ID Wink portālā. Kad tas ir savienots, jūsu konteiners tiek automātiski ielādēts jūsu īpašumam un tieši lasa Wink rezervācijas notikumus — aptverot pilnu viesu ceļojumu no meklēšanas līdz pabeigtai rezervācijai. Bieži izmantots piemērs ir Sojern konteiners atkārtotajai mārketinga un reklāmas vajadzībām, bet jebkurš GTM konteiners darbojas vienādi.

Kas jums jādara

Iegūstiet savu GTM konteineru ID

Iegūstiet savu GTM konteineru ID (formāts GTM-XXXXXXX). Ja tas nāk no partnera, piemēram, Sojern, pieprasiet tieši GTM konteineru ID — tas atšķiras no pikseļa vai taga ID.
Ievadiet to Wink portālā

Piesakieties app.wink.travel, izvēlieties savu kontu un atveriet pielāgošanas iestatījumus. Sadaļā Analytics & integrations ielīmējiet savu GTM konteineru ID laukā GTM Container ID un saglabājiet. Jūsu integrācija tagad ir aktīva.
Apstipriniet ar savu pakalpojumu sniedzēju

Ja jūsu konteiners nāk no partnera, piemēram, Sojern, informējiet savu konta pārvaldnieku, ka integrācija ir aktīva. Viņi var pārbaudīt no savas puses, ka tagi wink.travel jūsu īpašumam tiek aktivizēti pareizi un dati plūst jūsu kontā.

Ko Wink dara no savas puses

Lai nodrošinātu caurspīdīgumu, šeit ir tas, ko Wink konfigurē, lai šī integrācija darbotos:

GTM konteineru ID lauks ir pieejams sadaļā Analytics & integrations jūsu pielāgošanas iestatījumos. Kad ievadāt konteineru ID, Wink pārbauda formātu (GTM-XXXXXXX) un droši saglabā to pret jūsu īpašumu.
Katru reizi, kad jūsu īpašums ir aktīvs Wink lapā, jūsu konteiners tiek tieši injicēts lapā — koplietojot Wink paša window.dataLayer — tāpēc tas ielādējas kopā ar Wink konteineru bez papildu konfigurācijas. Tas notiek automātiski, bez papildu darba no Wink komandas puses.
Jūsu konteiners tiek ielādēts asinhroni, tāpēc tas neietekmē lapas ielādes ātrumu jūsu viesiem.
Wink paša izsekošana un jūsu konteiners darbojas paralēli, lasot no tā paša koplietotā dataLayer. Katrs rezervācijas notikums, ko Wink izseko, ir vienlaikus pieejams jūsu konteineram.
Kad jūsu īpašums netiek skatīts — piemēram, kad viesis pārlūko citu viesnīcu Wink — jūsu konteiners netiek ielādēts, tāpēc tas saņem tikai datus, kas attiecas uz jūsu īpašumu.
Pabeigtā rezervācija (purchase) tiek aktivizēta pārlūkprogrammā pateicības lapā. GTM konteineru ID ir melna kaste — Wink nevar pieņemt, kādi tagi tajā ir — tāpēc Wink nekad neizsauc Google jūsu vietā no saviem serveriem. Tā vietā jebkurš GA4 vai konversijas tags jūsu konteinerā saņem purchase klienta pusē, tieši tāpat kā katrs cits rezervācijas notikums. Tā kā maksājumu pakalpojumu sniedzējs novirza viesu pārlūkprogrammu prom un atpakaļ, Wink atjauno analītikas sesiju, kuru pārtrauca novirzīšana, pirms aktivizē purchase, tādējādi pārdošana tiek piesaistīta viesu sākotnējai apmeklējumam, nevis tiek skaitīta kā jauna sesija.

DataLayer atsauce

Wink nosūta GA4 saderīgus notikumus dataLayer visā viesu ceļojuma laikā. Jūsu GTM konteiners lasa no tā paša koplietotā dataLayer, tāpēc jebkuram trigerim vai mainīgajam, ko konfigurējat, ir piekļuve visām zemāk aprakstītajām īpašībām.

Katrs notikums seko standarta GA4 Enhanced Ecommerce struktūrai: augstākā līmeņa event virkne un ecommerce objekts. Pirms katra push Wink notīra iepriekšējo ecommerce saturu, lai novērstu novecojušu datu ietekmi uz jauniem trigeriem.

dataLayer atiestatīšanas paraugs

Wink atiestata ecommerce objektu pirms katra notikuma push:

dataLayer.push({ ecommerce: null });   // notīra iepriekšējo notikumu
dataLayer.push({ event: '...', ecommerce: { ... } });

Neuzticieties, ka ecommerce īpašības saglabājas starp notikumiem. Vienmēr nolasiet tās trigerēšanas brīdī tajā pašā notikumā.

Rezervācijas ceļojuma notikumi

Šie notikumi tiek aktivizēti automātiski, kad viesis pārvietojas rezervācijas piltuvē. Konfigurējiet savus GTM trigerus kā Custom Event trigerus, kas atbilst zemāk norādītajiem notikumu nosaukumiem.

Solis	Notikums	Kad tas aktivizējas
1	`view_item_list`	Kad tiek ielādēts viesnīcu inventāra režģis vai saraksts
2	`view_item`	Kad viesis apskata konkrētu īpašuma lapu
3	`add_to_cart`	Kad viesis pievieno istabu iepirkumu grozam
4	`begin_checkout`	Kad tiek ielādēta norēķinu / maksājumu lapa
5	`add_payment_info`	Kad viesis izvēlas maksājuma veidu
6	`login`	Kad viesis autentificējas ar SSO
7	`purchase`	Kad rezervācija ir apstiprināta
8	`refund`	Kad rezervācija tiek atcelta

`view_item_list`

Aktivizējas, kad tiek attēlots viesnīcu inventāra režģis vai saraksts.

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

`view_item`

Aktivizējas, kad viesis apskata konkrētu īpašumu.

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

`add_to_cart`

Aktivizējas, kad viesis pievieno istabu grozam.

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

`begin_checkout`

Aktivizējas, kad tiek ielādēta norēķinu / maksājumu lapa.

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

coupon ir pieejams tikai tad, ja tika piemērots atlaides kods.

`add_payment_info`

Aktivizējas, kad viesis izvēlas vai apstiprina maksājuma veidu.

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

payment_type tiek aizpildīts no maksājumu pieņēmēja veida. coupon ir pieejams tikai tad, ja tika piemērots atlaides kods.

`login`

Aktivizējas, kad viesis autentificējas ar vienoto pierakstīšanos (SSO).

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

`purchase`

Aktivizējas, kad rezervācija ir apstiprināta.

{
  "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 ir unikāls rezervācijas līguma identifikators. coupon, shipping un tax ir pieejami tikai, ja attiecas.

`refund`

Aktivizējas, kad rezervācija tiek atcelta.

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

transaction_id atbilst purchase notikumam tai pašai rezervācijai. coupon, shipping un tax ir pieejami tikai, ja attiecas.

Preces īpašības

Visi notikumi, kuros ir items masīvs, izmanto vienu un to pašu preces shēmu. Katra īpašība ir izvēles, ja vien nav norādīts kā obligāta.

Standarta GA4 lauki

Šie lauki ir GA4 natively saprotami un parādās standarta ecommerce atskaitēs bez papildu konfigurācijas.

Īpašība	Tips	Obligāts	Apraksts
`item_id`	string	Jā	Unikāls istabas vai produkta identifikators
`item_name`	string	—	Istabas vai produkta nosaukums
`affiliation`	string	—	Partnera vai pārdevēja nosaukums
`coupon`	string	—	Piemērotais kupona kods
`currency`	string	—	ISO 4217 valūtas kods (piemēram, `USD`)
`creative_name`	string	—	Radošā nosaukuma izmantošana reklāmā
`creative_slot`	string	—	Reklāmas radošā pozīcija
`discount`	number	—	Piemērotā atlaide
`index`	number	—	Pozīcija sarakstā (no 1)
`item_brand`	string	—	Viesnīcas vai zīmola nosaukums
`item_category`	string	—	Produkta veids — piemēram, `GUEST_ROOM`, `ACTIVITY`, `ATTRACTION`, `MEETING_ROOM`, `RESTAURANT`, `SPA`
`item_list_id`	string	—	Saraksta identifikators, kuram prece pieder
`item_list_name`	string	—	Saraksta nosaukums
`location_id`	string	—	Ģeokoordinātas īpašumam
`price`	number	—	Vienības cena
`promotion_id`	string	—	Akcijas identifikators
`promotion_name`	string	—	Akcijas nosaukums
`quantity`	number	—	Daudzums (noklusējums `1`)

Pielāgoti preces mēroga parametri

Šie parametri nes Wink specifisku rezervācijas kontekstu. GA4 tos automātiski neparāda atskaitēs — jums jāreģistrē katrs kā preces mēroga pielāgota dimensija savā GA4 īpašumā, pirms tie parādās izpētēs vai standarta atskaitēs. Skatiet sadaļu Pielāgotās dimensijas GA4 zemāk, lai uzzinātu iestatīšanu.

Īpašība	Tips	Apraksts
`property_id`	string	Wink īpašuma identifikators
`property_name`	string	Īpašuma nosaukums
`property_brand`	string	Zīmols, kam īpašums pieder
`property_chain`	string	Ķēde, kam īpašums pieder
`property_url_name`	string	URL draudzīgs īpašuma slugs
`city_name`	string	Pilsēta, kur atrodas īpašums
`country_code`	string	ISO 3166-1 alpha-2 valsts kods
`start_date`	string	Iekšķeršanās datums formātā `YYYY-MM-DD`
`end_date`	string	Izķeršanās datums formātā `YYYY-MM-DD`
`num_adults`	number	Pieaugušo skaits rezervācijā
`num_children`	number	Bērnu skaits rezervācijā
`cancellation_policy`	string	Viens no: `Refundable`, `Non-Refundable`, `Refundable-With-Restrictions`, `Non-Refundable-With-Restrictions`
`rate_plan_id`	string	Tarifa plāna identifikators
`room_rate_id`	string	Konkrētā istabas tarifa identifikators
`room_rate_name`	string	Istabas tarifa nosaukums
`num_perks`	number	Iekļauto priekšrocību skaits tarifā
`room_location`	string	Istabas atrašanās vietas apraksts (piemēram, `Overwater`, `Garden`)
`room_view`	string	Istabas skata apraksts (piemēram, `Ocean`, `City`)
`room_classification`	string	Istabas klasifikācija vai līmenis (piemēram, `Suite`, `Standard`)
`bed_type`	string	Gultas konfigurācija istabā (piemēram, `King`, `Twin`)

Pielāgotās dimensijas GA4

GA4 ignorē pielāgotos preces parametrus atskaitēs, līdz jūs tos skaidri nereģistrējat kā preces mēroga pielāgotas dimensijas. Jums jāreģistrē tikai tie parametri, kurus plānojat izmantot atskaitēs — nav nepieciešams reģistrēt visus 20.

Atveriet pielāgotās definīcijas

GA4 dodieties uz Admin (apakšējais kreisais zobrata ikona) → izvēlieties savu īpašumu → Data display → Custom definitions.
Izveidojiet jaunu pielāgotu dimensiju

Noklikšķiniet uz Create custom dimensions.
Aizpildiet dimensijas detaļas
- Dimension name — cilvēkam saprotams nosaukums, kas parādās GA4 atskaitēs (skatiet tabulu zemāk)
- Scope — izvēlieties Item
- Event parameter — precīzs parametra nosaukums, kāds ir dataLayer (skatiet tabulu zemāk)
- Description — izvēles, bet ieteicams
Saglabājiet un atkārtojiet

Noklikšķiniet uz Save, pēc tam atkārtojiet katram parametrā, ko vēlaties izsekot.

Izmantojiet šo tabulu kā atsauci, veidojot pielāgotās dimensijas. Event parameter vērtībai jāatbilst precīzi — GA4 ir reģistrjutīgs.

Dimensijas nosaukums	Event parameter	Tips
Īpašuma ID	`property_id`	Teksts
Īpašuma nosaukums	`property_name`	Teksts
Īpašuma zīmols	`property_brand`	Teksts
Īpašuma ķēde	`property_chain`	Teksts
Īpašuma URL nosaukums	`property_url_name`	Teksts
Pilsētas nosaukums	`city_name`	Teksts
Valsts kods	`country_code`	Teksts
Iekšķeršanās datums	`start_date`	Teksts
Izķeršanās datums	`end_date`	Teksts
Pieaugušo skaits	`num_adults`	Skaitlis
Bērnu skaits	`num_children`	Skaitlis
Atcelšanas politika	`cancellation_policy`	Teksts
Tarifa plāna ID	`rate_plan_id`	Teksts
Istabas tarifa ID	`room_rate_id`	Teksts
Istabas tarifa nosaukums	`room_rate_name`	Teksts
Priekšrocību skaits	`num_perks`	Skaitlis
Istabas atrašanās vieta	`room_location`	Teksts
Istabas skats	`room_view`	Teksts
Istabas klasifikācija	`room_classification`	Teksts
Gultas veids	`bed_type`	Teksts

Papildu pieejamie notikumi

Šie notikumi ir pieejami Wink dataLayer, bet nav daļa no standarta rezervācijas piltuves. Tos var aktivizēt citas platformas mijiedarbības.

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

Šim notikumam nav pievienots ecommerce saturs.

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

Tas ir pielāgots Wink notikums — nav daļa no standarta GA4 notikumu kopas. Tas tiek nosūtīts katrā lapas pārejā un satur ierīces un sesijas kontekstu. Tas nesatur ecommerce objektu.

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

Īpašība	Apraksts
`device`	Atklātā ierīces veids — `Desktop`, `Android`, `iPhone`, `iPad` vai līdzīgi
`deviceAgent`	Lietotāja aģenta virkne
`os`	Atklātā operētājsistēma — `Windows`, `MacOS`, `Linux`, `UNIX`
`path`	Pašreizējās lapas ceļš
`title`	Pašreizējās lapas nosaukums
`userId`	Autentificēta lietotāja identifikators (izlaists, ja nav pieslēdzies)
`startDate`	Iekšķeršanās datums no pašreizējās meklēšanas sesijas
`endDate`	Izķeršanās datums no pašreizējās meklēšanas sesijas
`guests`	Viesu skaits no pašreizējās meklēšanas sesijas
`rooms`	Istabu skaits no pašreizējās meklēšanas sesijas