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ārtotai mārketinga un reklāmas vajadzībām, bet jebkurš GTM konteiners darbojas vienādi.

Padoms

Tas pieņem, ka jums jau ir GTM konteineru ID (formāts GTM-XXXXXXX). Ja jūsu konteiners nāk no partnera, piemēram, Sojern, lūdziet savam konta pārvaldniekam tieši GTM konteineru ID — tas atšķiras no pikseļa vai taga ID. Ja esat jauns Sojern, apmeklējiet sojern.com/contact, lai sāktu.

---

Kas jums jādara

1. 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.

2. Ievadiet to Wink portālā

   Piesakieties app.wink.travel, izvēlieties savu kontu un dodieties uz cilni Pielāgojumi. Ielīmējiet savu GTM konteineru ID laukā GTM un saglabājiet. Jūsu integrācija tagad ir aktīva.

3. (Pēc izvēles) Pievienojiet GA4 mērījumu ID + API slepeno atslēgu servera pirkumiem

   GTM konteineri darbojas pilnībā viesu pārlūkprogrammā, tāpēc pabeigtu rezervāciju var nepamanīt, ja viesis aizver cilni maksājuma pāradresācijas laikā. Ja jūsu konteiners ielādē GA4 īpašumu un vēlaties, lai pabeigtas rezervācijas tiek uzticami reģistrētas, ievadiet arī šī GA4 mērījumu ID un Measurement Protocol API slepeno atslēgu GTM sadaļā. Tad Wink nosūtīs purchase notikumu servera pusē, tieši kā aprakstīts GA4 analītikas integrācijas ceļvedī. Atstājiet šos laukus tukšus, ja nepieciešama tikai pārlūkprogrammas izsekošana.

4. 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, vai tagi wink.travel vietnē jūsu īpašumam tiek aktivizēti pareizi un vai dati plūst jūsu kontā.

Piezīme

Jums nav nepieciešams ievietot nevienu pikseļa kodu savā mājaslapā šai integrācijai. Wink automātiski ielādē jūsu GTM konteineru visās lapās, kur jūsu īpašums ir aktīvs.

Tas darbojas ar jebkuru GTM konteineru ID — Sojern ir tikai bieži izmantots piemērs.

---

Ko Wink dara no savas puses

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

• GTM konteineru ID lauks ir pieejams cilnē Pielāgojumi jūsu Wink portālā. Kad ievadāt konteineru ID, Wink pārbauda formātu (GTM-XXXXXXX) un droši saglabā to pret jūsu īpašumu.
• Katru lapu, kur jūsu īpašums ir aktīvs Wink, 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 nepieciešamības Wink komandai veikt darbu katram īpašumam.
• 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, vienlaikus ir 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 jūsu īpašumam atbilstošos datus.
• Ja esat norādījis GA4 mērījumu ID + API slepeno atslēgu (3. solī), purchase notikums par pabeigtām rezervācijām tiek papildus nosūtīts servera pusē caur GA4 Measurement Protocol, tādējādi pārdošana tiek reģistrēta pat tad, ja viesis nekad neatgriežas apstiprinājuma lapā.

---

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 konfigurētajam aktivizatoram vai mainīgajam 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 datus, lai novērstu novecojušu datu ietekmi uz jauniem aktivizatoriem.

Piezīme

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 aktivizatora laikā 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 aktivizatorus kā Pielāgotus notikumus, kas atbilst zemāk norādītajiem notikumu nosaukumiem.

Solis	Notikums	Kad tas aktivizējas
1	view_item_list	Ielādē viesnīcu inventāra režģi vai sarakstu
2	view_item	Viesis apskata konkrētu īpašuma lapu
3	add_to_cart	Viesis pievieno istabu iepirkumu grozam
4	begin_checkout	Ielādējas norēķinu / maksājuma lapa
5	add_payment_info	Viesis izvēlas maksājuma veidu
6	login	Viesis autentificējas caur SSO
7	purchase	Rezervācija ir apstiprināta
8	refund	Rezervācija ir 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 ielādējas norēķinu / maksājuma 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ājuma pieņēmēja veida. coupon ir pieejams tikai tad, ja tika piemērots atlaides kods.

---

login

Aktivizējas, kad viesis autentificējas, izmantojot vienoto pierakstīšanos.

{
  "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 par to pašu rezervāciju. coupon, shipping un tax ir pieejami tikai, ja attiecas.

---

Preces īpašības

Visiem notikumiem, kuros ir items masīvs, ir vienāda preces shēma. Katrs īpašums ir izvēles, ja vien nav norādīts kā obligāts.

Standarta GA4 lauki

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

Īpašums	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	—	Precei piemērots kupona kods
currency	string	—	ISO 4217 valūtas kods (piemēram, USD)
creative_name	string	—	Reklāmas radošais nosaukums
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 satur Wink specifisku rezervācijas kontekstu. GA4 tos automātiski neparāda atskaitēs — jums katru no tiem jāreģistrē 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āgotas dimensijas GA4 zemāk, lai uzzinātu iestatīšanu.

Īpašums	Tips	Apraksts
property_id	string	Wink īpašuma identifikators
property_name	string	Īpašuma nosaukums
property_brand	string	Zīmols, kam pieder īpašums
property_chain	string	Ķēde, kam pieder īpašums
property_url_name	string	URL draudzīgs īpašuma nosaukums
city_name	string	Pilsēta, kur atrodas īpašums
country_code	string	ISO 3166-1 alpha-2 valsts kods
start_date	string	Ierašanās datums formātā YYYY-MM-DD
end_date	string	Izrakstīš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āgotas dimensijas GA4

GA4 ignorē pielāgotos preces parametrus atskaitēs, līdz tos skaidri reģ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.

1. Atveriet pielāgotās definīcijas

   GA4 dodieties uz Admin (apakšējā kreisā ikona ar zobratu) → izvēlieties savu īpašumu → Datu displejs → Pielāgotas definīcijas.

2. Izveidojiet jaunu pielāgotu dimensiju

   Noklikšķiniet uz Izveidot pielāgotas dimensijas.

3. Aizpildiet dimensijas detaļas

   • Dimensijas nosaukums — cilvēkam saprotams nosaukums, kas parādās GA4 atskaitēs (skatiet tabulu zemāk)
   • Mērogs — izvēlieties Item
   • Notikuma parametrs — precīzs parametra nosaukums, kāds ir dataLayer (skatiet tabulu zemāk)
   • Apraksts — pēc izvēles, bet ieteicams

4. Saglabājiet un atkārtojiet

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

Piezīme

Pielāgotas dimensijas var parādīties GA4 atskaitēs līdz 24 stundām pēc reģistrācijas. Vēsturiskie dati, kas savākti pirms reģistrācijas, netiek aizpildīti.

GA4 standarta īpašumos atļauj līdz 50 preces mēroga pielāgotām dimensijām (360 īpašumos vairāk).

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

Dimensijas nosaukums	Notikuma parametrs	Tips
Īpašuma ID	property_id	Teksts
Īpašuma nosaukums	property_name	Teksts
Īpašuma zīmols	property_brand	Teksts
Ķēde	property_chain	Teksts
Īpašuma URL nosaukums	property_url_name	Teksts
Pilsētas nosaukums	city_name	Teksts
Valsts kods	country_code	Teksts
Ierašanās datums	start_date	Teksts
Izrakstīš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

Nākamie 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 objekts.

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

Šis 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šums	Apraksts
device	Atklātā ierīces veids — Desktop, Android, iPhone, iPad vai līdzīgi
deviceAgent	Neapstrādāta 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	Ierašanās datums no pašreizējās meklēšanas sesijas
endDate	Izrakstīš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