Интеграция на 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, изберете вашия акаунт и отворете настройките за персонализация. В секцията Analytics & integrations поставете вашия GTM Container ID в полето GTM Container ID и запазете. Вашата интеграция вече е активна.

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

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

Note

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

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

---

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

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

• Поле за GTM Container ID е налично в секцията Analytics & integrations на вашите настройки за персонализация. Когато въведете вашия Container ID, Wink валидира формата (GTM-XXXXXXX) и го съхранява сигурно за вашия имот.
• На всяка страница, където вашият имот е активен в Wink, вашият контейнер се вмъква директно в страницата — споделяйки собствената window.dataLayer на Wink — така че се зарежда заедно със собствения контейнер на Wink без зависимост от допълнителна конфигурация. Това се случва автоматично, без необходимост от работа на екипа на Wink за всеки имот.
• Вашият контейнер се зарежда асинхронно, така че не влияе на производителността при зареждане на страницата за вашите гости.
• Проследяването на Wink и вашият контейнер работят паралелно, като четат от същия споделен dataLayer. Всяко събитие за резервация, което Wink проследява, е едновременно достъпно за вашия контейнер.
• Когато вашият имот не се разглежда — например, когато гост разглежда друг хотел в Wink — вашият контейнер не се зарежда, така че получава само данни, релевантни за вашия имот.
• Завършената резервация (purchase) се задейства в браузъра на страницата за благодарност. GTM Container ID е черна кутия — Wink не може да предполага какви тагове има вътре — затова Wink никога не извиква Google от името ви от своите сървъри. Вместо това, какъвто и GA4 или конверсионен таг да е в контейнера ви, той получава purchase на клиентската страна, точно както всяко друго събитие за резервация. Понеже доставчикът на плащане пренасочва браузъра на госта далеч и обратно, Wink възстановява аналитичната сесия, която пренасочването прекъсна преди да задейства purchase, така че продажбата се приписва на оригиналното посещение на госта, а не се брои като нова сесия.

---

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

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

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

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 и се появяват в стандартните ecommerce отчети без допълнителна конфигурация.

Свойство	Тип	Задължително	Описание
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 пакет.

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	Брой стаи от текущата сесия за търсене