Sojern Pixel integrācija

Ja jūs veicat reklāmas kampaņas caur Sojern, varat savienot savu Sojern kontu ar Wink, ievadot savu Sojern GTM konteineru ID Wink portālā. Kad tas ir savienots, Sojern izsekošanas pikselis automātiski aktivizējas jūsu īpašumam — aptverot pilnu viesu ceļojumu no meklēšanas līdz pabeigtai rezervācijai.

Padoms

Tas pieņem, ka jums jau ir aktīvs Sojern konts un esat saņēmis savu GTM konteineru ID no sava Sojern konta pārvaldnieka. Ja jums vēl nav Sojern konta, apmeklējiet sojern.com/contact, lai sāktu.

---

Kas jums jādara

1. Saņemiet savu GTM konteineru ID no Sojern

   Sazinieties ar savu Sojern konta pārvaldnieku un pieprasiet savu GTM konteineru ID. Tas ir formātā GTM-XXXXXXX. Tas atšķiras no jūsu Sojern pikseļa ID — pārliecinieties, ka pieprasāt tieši GTM konteineru ID.

2. Ievadiet to Wink portālā

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

3. Apstipriniet ar savu Sojern konta pārvaldnieku

   Informējiet savu Sojern konta pārvaldnieku, ka integrācija ir aktīva. Viņi var pārbaudīt no savas puses, ka pikselis darbojas pareizi vietnē wink.travel jūsu īpašumam un ka dati plūst jūsu Sojern 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 Sojern konteineru visās lapās, kur jūsu īpašums ir aktīvs.

Šī konfigurācija darbojas ar jebkuru pielāgotu GTM konteineru ID. Mēs izmantojām Sojern kā piemēru, jo tā ir ļoti izplatīta integrācija.

---

Ko Wink dara no savas puses

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

• Sojern GTM konteineru ID lauks ir pieejams cilnē Pielāgojumi jūsu Wink portālā. Kad ievadāt savu konteineru ID, Wink pārbauda formātu un droši saglabā to pret jūsu īpašumu.
• Katru reizi, kad jūsu īpašums ir aktīvs Wink lapā, jūsu Sojern GTM konteineru ID tiek ievietots lapā, un Wink tagu pārvaldības sistēma dinamiski ielādē jūsu Sojern konteineru kopā ar savu. Tas notiek automātiski — nav nepieciešamas manuālas darbības no Wink komandas katram īpašumam.
• Jūsu Sojern konteiners tiek ielādēts asinhroni, kas nozīmē, ka tas neietekmē lapas ielādes ātrumu jūsu viesiem.
• Wink savs izsekošanas pikselis un jūsu Sojern pikselis darbojas paralēli, izmantojot vienus un tos pašus kopīgos notikumu datus. Katrs rezervācijas notikums, ko Wink izseko, vienlaikus ir pieejams jūsu Sojern konteineram.
• Kad jūsu īpašums netiek skatīts — piemēram, kad viesis pārlūko citu viesnīcu Wink — jūsu Sojern konteiners netiek ielādēts. Tas nodrošina, ka Sojern saņem tikai datus, kas attiecas uz jūsu īpašumu.

---

DataLayer atsauce

Wink nosūta GA4 saderīgus notikumus uz dataLayer visā viesu ceļojuma laikā. Jūsu GTM konteiners lasa no tā paša kopīgā 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.

Piezīme

dataLayer atiestatīšanas modelis

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ā Pielāgotus notikumu 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 caur 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 savam 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ā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 tai pašai rezervācijai. coupon, shipping un tax ir pieejami tikai, ja attiecas.

---

Preces īpašības

Visiem notikumiem, kuros ir items masīvs, ir kopīga preces shēma. Katra īpašība ir izvēles, ja vien nav norādīts kā obligāta.

Standarta GA4 lauki

Šie lauki ir GA4 nativā atbalstīti 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	—	Precei piemērots kupona kods
currency	string	—	ISO 4217 valūtas kods (piemēram, USD)
creative_name	string	—	Reklāmas nosaukums, kas izmantots akcijā
creative_slot	string	—	Reklāmas pozīcija akcijā
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āgotas 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 nosaukums
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	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 istabai (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šējais kreisais zobrata ikona) → izvēlieties savu īpašumu → Datu attēlošana → 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 — 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 sākt 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 atļauj līdz 50 preces mēroga pielāgotām dimensijām standarta īpašumos (360 īpašumi atļauj 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
Ī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
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

Tālāk minētie 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šī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	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