Integrarea Analiticelor GTM

Puteți conecta orice container Google Tag Manager (GTM) la Wink introducând ID-ul Containerului GTM în portalul Wink. Odată conectat, containerul dvs. se încarcă automat pentru proprietatea dvs. și citește evenimentele de rezervare Wink direct — acoperind întregul parcurs al oaspetelui, de la căutare până la rezervarea finalizată. Un caz comun de utilizare este un container Sojern pentru retargeting și publicitate, dar orice container GTM funcționează la fel.

Sfat

Se presupune că aveți deja un ID de Container GTM (format GTM-XXXXXXX). Dacă containerul provine de la un partener precum Sojern, cereți managerului dvs. de cont ID-ul Containerului GTM — acesta este diferit de un pixel sau ID de tag. Sunteți nou la Sojern? Vizitați sojern.com/contact pentru a începe.

---

Ce Trebuie să Faceți

1. Obțineți ID-ul Containerului GTM

   Obțineți ID-ul Containerului GTM (format GTM-XXXXXXX). Dacă provine de la un partener precum Sojern, solicitați în mod specific ID-ul Containerului GTM — este diferit de un pixel sau ID de tag.

2. Introduceți-l în Portalul Wink

   Conectați-vă la app.wink.travel, selectați contul dvs. și deschideți setările de personalizare. În secțiunea Analytics & integrations, lipiți ID-ul Containerului GTM în câmpul GTM Container ID și salvați. Integrarea dvs. este acum activă.

3. Confirmați cu Furnizorul Dvs.

   Dacă containerul provine de la un partener precum Sojern, anunțați managerul dvs. de cont că integrarea este activă. Ei pot verifica de partea lor dacă tag-urile se declanșează corect pe wink.travel pentru proprietatea dvs. și dacă datele curg în contul dvs.

Mențiune

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

Aceasta funcționează pentru orice ID de Container GTM — Sojern este doar un exemplu 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 este disponibil în secțiunea Analytics & integrations din setările dvs. de personalizare. Când introduceți ID-ul Containerului, Wink validează formatul (GTM-XXXXXXX) și îl stochează în siguranță pentru proprietatea dvs.
• Pe fiecare pagină unde proprietatea dvs. este activă pe Wink, containerul dvs. este injectat direct în pagină — împărtășind propriul window.dataLayer al Wink — astfel încât se încarcă alături de containerul Wink fără dependență de alte configurări suplimentare. Acest lucru se întâmplă automat, fără muncă suplimentară per proprietate din partea echipei Wink.
• Containerul dvs. se încarcă asincron, deci nu afectează performanța încărcării paginii pentru oaspeții dvs.
• Urmărirea Wink și containerul dvs. rulează în paralel, citind din același dataLayer partajat. Fiecare eveniment de rezervare urmărit de Wink este disponibil simultan pentru containerul dvs.
• Când proprietatea dvs. nu este vizualizată — de exemplu, când un oaspete navighează pe un alt hotel pe Wink — containerul dvs. nu este încărcat, deci primește doar date relevante pentru proprietatea dvs.
• Evenimentul de rezervare finalizată (purchase) se declanșează în browser pe pagina de mulțumire. Un ID de Container GTM este o cutie neagră — Wink nu poate presupune ce tag-uri conține — deci Wink nu apelează Google în numele dvs. de pe serverele sale. În schimb, orice tag GA4 sau de conversie din containerul dvs. primește purchase client-side, exact ca orice alt eveniment de rezervare. Deoarece furnizorul de plată redirecționează browserul oaspetelui în afara și înapoi, Wink reconectează sesiunea de analiză pe care redirecționarea a întrerupt-o înainte de a declanșa purchase, astfel vânzarea este atribuită vizitei originale a oaspetelui și nu este contorizată ca o sesiune nouă.

---

Referință DataLayer

Wink împinge evenimente compatibile GA4 în dataLayer pe tot parcursul călătoriei oaspetelui. Containerul dvs. GTM citește din același dataLayer partajat, deci 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 declanșatoarele noi.

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 de eveniment 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 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 completat 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 cupon 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ției
discount	number	—	Valoarea discountului aplicat
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 alpha-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 nivelul camerei (ex. Suite, Standard)
bed_type	string	Configurația patului în 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 folosiț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.

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

Nicio încărcătură ecommerce nu este inclusă cu acest eveniment.

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 raw al user agent-ului
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