Интеграция на GTM Analytics

Можете да свържете всеки контейнер на Google Tag Manager (GTM) с Wink, като въведете неговия GTM Container ID в портала на Wink. След като е свързан, вашият контейнер се зарежда автоматично за вашия имот и чете директно събитията за резервации на Wink — покривайки целия път на госта от търсене до завършена резервация. Често използван случай е контейнер на Sojern за ретаргетинг и реклама, но всеки GTM контейнер работи по същия начин.

Tip

Това предполага, че вече имате GTM Container ID (формат GTM-XXXXXXX). Ако вашият контейнер идва от партньор като Sojern, поискайте от вашия акаунт мениджър конкретно GTM Container ID — той е различен от пиксел или tag ID. Нови в Sojern? Посетете sojern.com/contact, за да започнете.

---

Какво трябва да направите

1. Вземете вашия GTM Container ID

   Получете вашия GTM Container ID (формат GTM-XXXXXXX). Ако идва от партньор като Sojern, поискайте конкретно GTM Container ID — той е различен от пиксел или tag ID.

2. Въведете го в портала на Wink

   Влезте в app.wink.travel, изберете вашия акаунт и отидете в раздела Customizations. Поставете вашия GTM Container ID в полето GTM и запазете. Вашата интеграция вече е активна.

3. (По избор) Добавете GA4 Measurement ID + API Secret за сървърно отчитане на покупки

   GTM контейнерите работят изцяло в браузъра на госта, така че завършена резервация може да бъде пропусната, ако гостът затвори таба по време на пренасочване за плащане. Ако вашият контейнер зарежда GA4 property и искате завършените резервации да се записват надеждно, въведете и Measurement ID и Measurement Protocol API secret на този GA4 в секцията GTM. Wink ще изпрати purchase за тази собственост сървърно, точно както е описано в ръководството GA4 Analytics Integration. Оставете тези полета празни, ако ви трябва само проследяване в браузъра.

4. Потвърдете с вашия доставчик

   Ако вашият контейнер идва от партньор като Sojern, уведомете вашия акаунт мениджър, че интеграцията е активна. Те могат да проверят от своя страна дали таговете се задействат правилно на wink.travel за вашия имот и дали данните постъпват във вашия акаунт.

Note

Не е необходимо да поставяте никакъв пиксел код на вашия собствен уебсайт за тази интеграция. Wink зарежда вашия GTM контейнер автоматично на всички страници, където вашият имот е активен.

Това работи за всякакъв GTM Container ID — Sojern е само често срещан пример.

---

Какво прави Wink от наша страна

За прозрачност, ето какво Wink конфигурира, за да работи тази интеграция:

• Поле за GTM Container ID е налично в раздела Customizations на портала ви в Wink. Когато въведете Container ID, Wink валидира формата (GTM-XXXXXXX) и го съхранява сигурно за вашия имот.
• На всяка страница, където вашият имот е активен в Wink, вашият контейнер се вмъква директно в страницата — споделяйки собствената window.dataLayer на Wink — така че се зарежда заедно с контейнера на Wink без зависимост от допълнителна конфигурация. Това се случва автоматично, без нужда от работа от екипа на Wink за всеки имот.
• Вашият контейнер се зарежда асинхронно, така че не влияе на производителността при зареждане на страницата за вашите гости.
• Проследяването на Wink и вашият контейнер работят паралелно, четейки от същия споделен dataLayer. Всяко събитие за резервация, което Wink проследява, е едновременно достъпно за вашия контейнер.
• Когато вашият имот не се разглежда — например, когато гост разглежда друг хотел в Wink — вашият контейнер не се зарежда, така че получава само данни, релевантни за вашия имот.
• Ако сте предоставили GA4 Measurement ID + API secret (стъпка 3 по-горе), purchase за завършени резервации се изпраща допълнително сървърно чрез GA4 Measurement Protocol, така че продажбата се записва дори ако гостът не се върне на страницата за потвърждение.

---

Референция на DataLayer

Wink изпраща събития, съвместими с GA4, към dataLayer през целия път на госта. Вашият GTM контейнер чете от същия споделен dataLayer, така че всеки тригер или променлива, която конфигурирате, има достъп до всички описани по-долу свойства.

Всяко събитие следва стандартната структура на GA4 Enhanced Ecommerce: низ event от най-високо ниво и обект ecommerce. Преди всяко изпращане Wink изчиства предишния ecommerce payload, за да предотврати пренасяне на остарели данни в нови тригери.

Note

Шаблон за нулиране на dataLayer

Wink нулира ecommerce обекта преди всяко изпращане на събитие:

dataLayer.push({ ecommerce: null });   // изчистване на предишното събитие
dataLayer.push({ event: '...', ecommerce: { ... } });

Не разчитайте, че ecommerce свойствата остават между събитията. Винаги ги четете по време на тригера в рамките на същото събитие.

---

Събития по пътя на резервацията

Тези събития се задействат автоматично, докато гостът преминава през фунията на резервацията. Конфигурирайте вашите GTM тригери като Custom Event тригери, съвпадащи с имената на събитията по-долу.

Стъпка	Събитие	Кога се задейства
1	view_item_list	Зарежда се мрежа или списък с налични хотели
2	view_item	Гост разглежда конкретна страница на имот
3	add_to_cart	Гост добавя стая в количката
4	begin_checkout	Зарежда се страница за плащане/поръчка
5	add_payment_info	Гост избира метод на плащане
6	login	Гост се удостоверява чрез SSO
7	purchase	Резервацията е потвърдена
8	refund	Резервацията е анулирана

---

view_item_list

Задейства се, когато се визуализира мрежа или списък с хотели.

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

---

view_item

Задейства се, когато гост разглежда конкретен имот.

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

---

add_to_cart

Задейства се, когато гост добавя стая в количката.

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

---

begin_checkout

Задейства се, когато се зарежда страницата за плащане/поръчка.

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

coupon е наличен само когато е приложен код за отстъпка.

---

add_payment_info

Задейства се, когато гост избира или потвърждава метод на плащане.

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

payment_type се попълва от типа на платежния приемник. coupon е наличен само когато е приложен код за отстъпка.

---

login

Задейства се, когато гост се удостоверява чрез single sign-on.

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

---

purchase

Задейства се, когато резервация е потвърдена.

{
  "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 е уникалният идентификатор на резервационния договор. coupon, shipping и tax са налични само когато са приложими.

---

refund

Задейства се, когато резервация е анулирана.

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

transaction_id съвпада със събитието purchase за същата резервация. coupon, shipping и tax са налични само когато са приложими.

---

Свойства на артикула

Всички събития, които включват масив items, споделят една и съща схема за артикули. Всяко свойство е по избор, освен ако не е маркирано като задължително.

Стандартни полета на GA4

Тези полета са нативно разпознавани от GA4 и се появяват в стандартните отчети за електронна търговия без допълнителна конфигурация.

Свойство	Тип	Задължително	Описание
item_id	string	Да	Уникален идентификатор за стаята или продукта
item_name	string	—	Име на стаята или продукта
affiliation	string	—	Име на филиал или продавач
coupon	string	—	Приложен код за отстъпка към артикула
currency	string	—	ISO 4217 код на валута (напр. USD)
creative_name	string	—	Име на креатив в промоция
creative_slot	string	—	Позиция на креатива в промоцията
discount	number	—	Приложена сума на отстъпка
index	number	—	Позиция в списъка (1-базирана)
item_brand	string	—	Име на хотел или бранд
item_category	string	—	Тип продукт — напр. GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Идентификатор на списъка, към който принадлежи артикула
item_list_name	string	—	Показвано име на списъка
location_id	string	—	Географски координати на имота
price	number	—	Единична цена
promotion_id	string	—	Идентификатор на промоцията
promotion_name	string	—	Показвано име на промоцията
quantity	number	—	Количество (по подразбиране 1)

Персонализирани параметри с обхват на артикула

Тези параметри носят контекст, специфичен за резервациите в Wink. GA4 не ги показва автоматично в отчетите — трябва да регистрирате всеки като персонализирана дименсия с обхват на артикула във вашата GA4 собственост, преди да се появят в изследвания или стандартни отчети. Вижте Персонализирани дименсии в GA4 по-долу за инструкции.

Свойство	Тип	Описание
property_id	string	Идентификатор на имота в Wink
property_name	string	Показвано име на имота
property_brand	string	Бранд, към който принадлежи имотът
property_chain	string	Верига, към която принадлежи имотът
property_url_name	string	URL-приятелски slug за имота
city_name	string	Град, където се намира имотът
country_code	string	ISO 3166-1 alpha-2 код на държава
start_date	string	Дата на настаняване във формат YYYY-MM-DD
end_date	string	Дата на напускане във формат YYYY-MM-DD
num_adults	number	Брой възрастни в резервацията
num_children	number	Брой деца в резервацията
cancellation_policy	string	Едно от: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Идентификатор на тарифния план
room_rate_id	string	Идентификатор на конкретната стая/тарифна ставка
room_rate_name	string	Показвано име на тарифната ставка
num_perks	number	Брой включени предимства с тарифата
room_location	string	Описание на местоположението на стаята (напр. Overwater, Garden)
room_view	string	Описание на гледката от стаята (напр. Ocean, City)
room_classification	string	Класификация или категория на стаята (напр. Suite, Standard)
bed_type	string	Конфигурация на леглата в стаята (напр. King, Twin)

---

Персонализирани дименсии в GA4

GA4 игнорира персонализираните параметри на артикула в отчетите, докато не ги регистрирате изрично като персонализирани дименсии с обхват на артикула. Трябва да регистрирате само параметрите, които възнамерявате да използвате в отчетите — не е нужно да регистрирате всички 20.

1. Отворете Custom Definitions

   В GA4 отидете на Admin (иконата на зъбно колело долу вляво) → изберете вашата собственост → Data display → Custom definitions.

2. Създайте нова персонализирана дименсия

   Кликнете върху Create custom dimensions.

3. Попълнете детайлите на дименсията

   • Dimension name — четимото име, което се показва в отчетите на GA4 (вижте таблицата по-долу)
   • Scope — изберете Item
   • Event parameter — точното име на параметъра, както се появява в dataLayer (вижте таблицата по-долу)
   • Description — по избор, но препоръчително

4. Запазете и повторете

   Кликнете Save, след което повторете за всеки параметър, който искате да проследявате.

Note

Персонализираните дименсии могат да започнат да се появяват в отчетите на GA4 до 24 часа след регистрацията. Историческите данни, събрани преди регистрацията, не се попълват ретроспективно.

GA4 позволява до 50 персонализирани дименсии с обхват на артикула на стандартна собственост (360 собственостите позволяват повече).

Използвайте следната таблица като справка при създаване на персонализирани дименсии. Стойността на Event parameter трябва да съвпада точно — GA4 е чувствителен към главни и малки букви.

Име на дименсия	Event parameter	Тип
Property ID	property_id	Текст
Property name	property_name	Текст
Property brand	property_brand	Текст
Property chain	property_chain	Текст
Property URL name	property_url_name	Текст
City name	city_name	Текст
Country code	country_code	Текст
Check-in date	start_date	Текст
Check-out date	end_date	Текст
Number of adults	num_adults	Число
Number of children	num_children	Число
Cancellation policy	cancellation_policy	Текст
Rate plan ID	rate_plan_id	Текст
Room rate ID	room_rate_id	Текст
Room rate name	room_rate_name	Текст
Number of perks	num_perks	Число
Room location	room_location	Текст
Room view	room_view	Текст
Room classification	room_classification	Текст
Bed type	bed_type	Текст

---

Допълнителни налични събития

Следните събития са налични в dataLayer на Wink, но не са част от стандартната фуния на резервацията. Те могат да се задействат от други взаимодействия на платформата.

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

Това събитие не съдържа ecommerce payload.

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

Това е персонализирано събитие на Wink — не е част от стандартния набор събития на GA4. Изпраща се при всяка навигация на страница и носи контекст за устройството и сесията. Не включва обект 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"
}

Свойство	Описание
device	Открит тип устройство — Desktop, Android, iPhone, iPad или подобно
deviceAgent	Суров низ на user agent
os	Открита операционна система — Windows, MacOS, Linux, UNIX
path	Текущ път на страницата
title	Заглавие на текущата страница
userId	Идентификатор на удостоверен потребител (липсва, ако не е влязъл)
startDate	Дата на настаняване от текущата сесия за търсене
endDate	Дата на напускане от текущата сесия за търсене
guests	Брой гости от текущата сесия за търсене
rooms	Брой стаи от текущата сесия за търсене