Integrarea Pixelului Sojern

Dacă derulați campanii publicitare prin Sojern, puteți conecta contul Sojern la Wink introducând ID-ul containerului GTM Sojern în portalul Wink. Odată conectat, pixelul de urmărire Sojern se activează automat pentru proprietatea dvs. — acoperind întregul parcurs al oaspetelui, de la căutare până la rezervarea finalizată.

Sfat

Se presupune că aveți deja un cont activ Sojern și ați primit ID-ul containerului GTM de la managerul dvs. de cont Sojern. Dacă nu aveți încă un cont Sojern, vizitați sojern.com/contact pentru a începe.

---

Ce Trebuie să Faceți

1. Obțineți ID-ul containerului GTM de la Sojern

   Contactați managerul dvs. de cont Sojern și solicitați ID-ul containerului GTM. Are formatul GTM-XXXXXXX. Acesta este diferit de ID-ul pixelului Sojern — asigurați-vă că cereți în mod specific ID-ul containerului GTM.

2. Introduceți-l în portalul Wink

   Conectați-vă la my.wink.travel, selectați contul dvs. și accesați fila Customizations. Lipiți ID-ul containerului GTM Sojern în câmpul Sojern și salvați. Integrarea dvs. este acum activă.

3. Confirmați cu managerul dvs. de cont Sojern

   Informați managerul dvs. de cont Sojern că integrarea este activă. Ei pot verifica din partea lor dacă pixelul se activează corect pe wink.travel pentru proprietatea dvs. și dacă datele sunt transmise în contul dvs. Sojern.

Mențiune

Nu este necesar să plasați niciun cod pixel pe propriul site pentru această integrare. Wink încarcă containerul Sojern automat pe toate paginile unde proprietatea dvs. este activă.

Această configurare funcționează pentru orice ID container GTM personalizat. Am folosit Sojern doar ca exemplu, deoarece este o integrare foarte comună.

---

Ce Face Wink pe Partea Noastră

Pentru transparență, iată ce configurează Wink pentru a face această integrare să funcționeze:

• Un câmp pentru ID-ul containerului GTM Sojern este disponibil în fila Customizations din portalul Wink. Când introduceți ID-ul containerului, Wink validează formatul și îl stochează în siguranță pentru proprietatea dvs.
• Pe fiecare pagină unde proprietatea dvs. este activă pe Wink, ID-ul containerului GTM Sojern este redat în pagină, iar sistemul de gestionare a etichetelor Wink încarcă dinamic containerul Sojern împreună cu al său. Acest lucru se întâmplă automat — nu sunt necesari pași manuali din partea echipei Wink pentru fiecare proprietate.
• Containerul Sojern este încărcat asincron, ceea ce înseamnă că nu afectează performanța încărcării paginii pentru oaspeții dvs.
• Urmărirea proprie Wink și pixelul Sojern rulează în paralel, citind din aceleași date de eveniment partajate. Fiecare eveniment de rezervare pe care Wink îl urmărește este disponibil simultan pentru containerul Sojern.
• Când proprietatea dvs. nu este vizualizată — de exemplu, când un oaspete navighează pe un alt hotel pe Wink — containerul Sojern nu este încărcat. Acest lucru asigură că Sojern primește doar date relevante pentru proprietatea dvs.

---

Referință DataLayer

Wink împinge evenimente compatibile GA4 în dataLayer pe tot parcursul experienței oaspetelui. Containerul dvs. GTM citește din același dataLayer partajat, astfel încât orice declanșator sau variabilă configurați are acces la toate proprietățile descrise mai jos.

Fiecare eveniment urmează structura standard GA4 Enhanced Ecommerce: un șir event la nivel superior și un obiect ecommerce. Înainte de fiecare push, Wink golește încărcătura ecommerce anterioară pentru a preveni pătrunderea datelor vechi în noile declanșatoare.

Mențiune

Modelul de resetare dataLayer

Wink resetează obiectul ecommerce înainte de fiecare push de eveniment:

dataLayer.push({ ecommerce: null });   // șterge evenimentul anterior
dataLayer.push({ event: '...', ecommerce: { ... } });

Nu vă bazați pe persistența proprietăților ecommerce între evenimente. Citiți-le întotdeauna la momentul declanșatorului în cadrul aceluiași eveniment.

---

Evenimente din Parcursul de Rezervare

Aceste evenimente se declanșează automat pe măsură ce un oaspete parcurge funnel-ul de rezervare. Configurați declanșatoarele GTM ca declanșatoare Custom Event care corespund numelor evenimentelor de mai jos.

Pas	Eveniment	Când se declanșează
1	view_item_list	Se încarcă grila sau lista de inventar hotelier
2	view_item	Oaspetele vizualizează o pagină specifică a proprietății
3	add_to_cart	Oaspetele adaugă o cameră în coșul de cumpărături
4	begin_checkout	Se încarcă pagina de checkout / plată
5	add_payment_info	Oaspetele selectează o metodă de plată
6	login	Oaspetele se autentifică prin SSO
7	purchase	Rezervarea este confirmată
8	refund	Rezervarea este anulată

---

view_item_list

Se declanșează când se afișează o grilă sau o listă de inventar hotelier.

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

---

view_item

Se declanșează când un oaspete vizualizează o proprietate specifică.

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

---

add_to_cart

Se declanșează când un oaspete adaugă o cameră în coș.

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

---

begin_checkout

Se declanșează când se încarcă pagina de checkout / plată.

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

coupon este prezent doar când a fost aplicat un cod de reducere.

---

add_payment_info

Se declanșează când oaspetele selectează sau confirmă o metodă de plată.

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

payment_type este populat din tipul achizitorului de plată. coupon este prezent doar când a fost aplicat un cod de reducere.

---

login

Se declanșează când un oaspete se autentifică prin single sign-on.

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

---

purchase

Se declanșează când o rezervare este confirmată.

{
  "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 este identificatorul unic al contractului de rezervare. coupon, shipping și tax sunt prezente doar când este cazul.

---

refund

Se declanșează când o rezervare este anulată.

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

transaction_id corespunde evenimentului purchase pentru aceeași rezervare. coupon, shipping și tax sunt prezente doar când este cazul.

---

Proprietăți ale Articolului

Toate evenimentele care includ un array items împărtășesc aceeași schemă pentru articole. Fiecare proprietate este opțională, cu excepția celor marcate ca obligatorii.

Câmpuri standard GA4

Aceste câmpuri sunt înțelese nativ de GA4 și apar în rapoartele standard ecommerce fără configurare suplimentară.

Proprietate	Tip	Obligatoriu	Descriere
item_id	string	Da	Identificator unic pentru cameră sau produs
item_name	string	—	Numele camerei sau produsului
affiliation	string	—	Numele afiliatului sau vânzătorului
coupon	string	—	Codul de reducere aplicat articolului
currency	string	—	Codul valutar ISO 4217 (ex. USD)
creative_name	string	—	Numele creativ folosit într-o promoție
creative_slot	string	—	Poziția slotului pentru creativul promoțional
discount	number	—	Valoarea reducerii aplicate
index	number	—	Poziția în listă (începând de la 1)
item_brand	string	—	Numele hotelului sau brandului
item_category	string	—	Tipul produsului — ex. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Identificatorul listei din care face parte articolul
item_list_name	string	—	Numele afișat al listei
location_id	string	—	Coordonatele geografice ale proprietății
price	number	—	Preț unitar
promotion_id	string	—	Identificatorul promoției
promotion_name	string	—	Numele afișat al promoției
quantity	number	—	Cantitate (implicit 1)

Parametri personalizați la nivel de articol

Acești parametri conțin context specific rezervărilor Wink. GA4 nu îi afișează automat în rapoarte — trebuie să înregistrați fiecare ca dimensiune personalizată la nivel de articol în proprietatea GA4 înainte să apară în explorări sau rapoarte standard. Consultați Dimensiuni personalizate în GA4 mai jos pentru instrucțiuni.

Proprietate	Tip	Descriere
property_id	string	Identificatorul proprietății Wink
property_name	string	Numele afișat al proprietății
property_brand	string	Brandul căruia îi aparține proprietatea
property_chain	string	Lanțul căruia îi aparține proprietatea
property_url_name	string	Slug URL-friendly pentru proprietate
city_name	string	Orașul unde se află proprietatea
country_code	string	Codul țării ISO 3166-1 alfa-2
start_date	string	Data check-in în format YYYY-MM-DD
end_date	string	Data check-out în format YYYY-MM-DD
num_adults	number	Numărul de adulți în rezervare
num_children	number	Numărul de copii în rezervare
cancellation_policy	string	Unul dintre: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Identificatorul planului tarifar
room_rate_id	string	Identificatorul tarifului camerei specifice
room_rate_name	string	Numele afișat al tarifului camerei
num_perks	number	Numărul de beneficii incluse în tarif
room_location	string	Descrierea locației camerei (ex. Overwater, Garden)
room_view	string	Descrierea priveliștii camerei (ex. Ocean, City)
room_classification	string	Clasificarea sau categoria camerei (ex. Suite, Standard)
bed_type	string	Configurația patului pentru cameră (ex. King, Twin)

---

Dimensiuni Personalizate în GA4

GA4 ignoră parametrii personalizați la nivel de articol în rapoarte până când îi înregistrați explicit ca dimensiuni personalizate la nivel de articol. Trebuie să înregistrați doar parametrii pe care intenționați să îi utilizați în rapoarte — nu este necesar să înregistrați toți cei 20.

1. Deschideți Definițiile Personalizate

   În GA4, accesați Admin (pictograma roată din stânga jos) → selectați proprietatea dvs. → Data display → Custom definitions.

2. Creați o dimensiune personalizată nouă

   Faceți clic pe Create custom dimensions.

3. Completați detaliile dimensiunii

   • Dimension name — eticheta lizibilă pentru oameni care apare în rapoartele GA4 (vedeți tabelul de mai jos)
   • Scope — selectați Item
   • Event parameter — numele exact al parametrului așa cum apare în dataLayer (vedeți tabelul de mai jos)
   • Description — opțional, dar recomandat

4. Salvați și repetați

   Faceți clic pe Save, apoi repetați pentru fiecare parametru pe care doriți să îl urmăriți.

Mențiune

Dimensiunile personalizate pot începe să apară în rapoartele GA4 după până la 24 de ore de la înregistrare. Datele istorice colectate înainte de înregistrare nu sunt completate retroactiv.

GA4 permite până la 50 de dimensiuni personalizate la nivel de articol per proprietate pe proprietățile standard (proprietățile 360 permit mai multe).

Folosiți tabelul următor ca referință când creați dimensiuni personalizate. Valoarea Event parameter trebuie să corespundă exact — GA4 este sensibil la majuscule/minuscule.

Nume dimensiune	Event parameter	Tip
Property ID	property_id	Text
Property name	property_name	Text
Property brand	property_brand	Text
Property chain	property_chain	Text
Property URL name	property_url_name	Text
City name	city_name	Text
Country code	country_code	Text
Check-in date	start_date	Text
Check-out date	end_date	Text
Number of adults	num_adults	Number
Number of children	num_children	Number
Cancellation policy	cancellation_policy	Text
Rate plan ID	rate_plan_id	Text
Room rate ID	room_rate_id	Text
Room rate name	room_rate_name	Text
Number of perks	num_perks	Number
Room location	room_location	Text
Room view	room_view	Text
Room classification	room_classification	Text
Bed type	bed_type	Text

---

Evenimente Suplimentare Disponibile

Următoarele evenimente sunt disponibile în dataLayer-ul Wink, dar nu fac parte din funnel-ul standard de rezervare. Ele pot fi declanșate de alte interacțiuni pe platformă.

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

Acest eveniment nu include o încărcătură ecommerce.

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

Acesta este un eveniment personalizat Wink — nu face parte din setul standard de evenimente GA4. Este împins la fiecare navigare pe pagină și conține context despre dispozitiv și sesiune. Nu include un obiect ecommerce.

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

Proprietate	Descriere
device	Tipul dispozitivului detectat — Desktop, Android, iPhone, iPad sau similar
deviceAgent	Stringul brut al agentului utilizator
os	Sistemul de operare detectat — Windows, MacOS, Linux, UNIX
path	Calea paginii curente
title	Titlul paginii curente
userId	Identificatorul utilizatorului autentificat (omise dacă nu este logat)
startDate	Data check-in din sesiunea curentă de căutare
endDate	Data check-out din sesiunea curentă de căutare
guests	Numărul de oaspeți din sesiunea curentă de căutare
rooms	Numărul de camere din sesiunea curentă de căutare