GTM 分析整合

您可以透過在 Wink 入口網站輸入 GTM 容器 ID，將任何 Google Tag Manager (GTM) 容器連接到 Wink。連接後，您的容器會自動為您的物業載入，並直接讀取 Wink 的訂房事件 — 涵蓋從搜尋到完成訂房的完整客人旅程。常見的使用案例是用於再行銷和廣告的 Sojern 容器，但任何 GTM 容器的運作方式都相同。

您需要做的事

取得您的 GTM 容器 ID

取得您的 GTM 容器 ID（格式為 GTM-XXXXXXX）。如果來自像 Sojern 這樣的合作夥伴，請特別索取 GTM 容器 ID — 它與像素或標籤 ID 不同。
在 Wink 入口網站輸入

登入 app.wink.travel，選擇您的帳戶，並前往自訂標籤。將您的 GTM 容器 ID 貼入 GTM 欄位並儲存。您的整合現在已啟用。
（選擇性）新增 GA4 測量 ID + API 密鑰以進行伺服器端購買追蹤

GTM 容器完全在客戶端瀏覽器執行，因此如果客人在付款重導期間關閉分頁，可能會遺漏完成訂房事件。如果您的容器載入了 GA4 屬性，且您希望可靠記錄完成訂房，請在 GTM 區段中同時輸入該 GA4 的 測量 ID 和 測量協定 API 密鑰。Wink 將會依照 GA4 分析整合指南所述，伺服器端 傳送該屬性的 purchase 事件。如果只需要瀏覽器端追蹤，請留空。
與您的供應商確認

如果您的容器來自像 Sojern 這樣的合作夥伴，請告知您的客戶經理整合已啟用。他們可以從他們端確認標籤是否在 wink.travel 上正確觸發，並且資料是否流入您的帳戶。

Wink 端的作法

為了透明說明，以下是 Wink 為使此整合運作所做的設定：

在 Wink 入口網站的自訂標籤中提供 GTM 容器 ID 欄位。當您輸入容器 ID 時，Wink 會驗證格式（GTM-XXXXXXX）並安全地將其儲存於您的物業資料中。
在 Wink 上您的物業啟用的每個頁面，您的容器會直接注入頁面 — 與 Wink 自身的 window.dataLayer 共享 — 因此它會與 Wink 自身的容器同時載入，無需額外設定。這是自動完成的，Wink 團隊無需為每個物業額外作業。
您的容器以非同步方式載入，不會影響客人的頁面載入效能。
Wink 自身的追蹤與您的容器並行運作，共用同一個 dataLayer。Wink 追蹤的每個訂房事件同時可供您的容器使用。
當您的物業未被瀏覽時 — 例如客人在 Wink 瀏覽其他飯店時 — 您的容器不會被載入，因此只接收與您的物業相關的資料。
如果您提供了 GA4 測量 ID + API 密鑰（上述步驟 3），完成訂房的 purchase 事件會額外透過 GA4 測量協定以 伺服器端 傳送，即使客人未返回確認頁面，銷售仍會被記錄。

DataLayer 參考

Wink 在整個客人旅程中向 dataLayer 推送 GA4 相容事件。您的 GTM 容器會從同一共享的 dataLayer 讀取，因此您設定的任何觸發器或變數都能存取下述所有屬性。

每個事件遵循標準 GA4 強化電子商務結構：頂層的 event 字串與 ecommerce 物件。每次推送前，Wink 會清除先前的 ecommerce 載荷，以防止舊資料影響新觸發器。

dataLayer 重置模式

Wink 在每次事件推送前重置 ecommerce 物件：

dataLayer.push({ ecommerce: null });   // 清除先前事件
dataLayer.push({ event: '...', ecommerce: { ... } });

請勿依賴 ecommerce 屬性在事件間持續存在。請在觸發時於同一事件中讀取。

訂房旅程事件

當客人通過訂房漏斗時，這些事件會自動觸發。請將您的 GTM 觸發器設定為符合下列事件名稱的 自訂事件 觸發器。

步驟	事件	觸發時機
1	`view_item_list`	飯店庫存格或列表載入
2	`view_item`	客人瀏覽特定物業頁面
3	`add_to_cart`	客人將房型加入購物車
4	`begin_checkout`	結帳／付款頁面載入
5	`add_payment_info`	客人選擇付款方式
6	`login`	客人透過單一登入認證
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`

當客人透過單一登入認證時觸發。

{
  "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 個。

開啟自訂定義

在 GA4 中，前往 管理員（左下齒輪圖示）→ 選擇您的屬性 → 資料顯示 → 自訂定義。
建立新的自訂維度

點擊 建立自訂維度。
填寫維度詳細資訊
- 維度名稱 — GA4 報告中顯示的人類可讀標籤（請參考下表）
- 範圍 — 選擇項目
- 事件參數 — 與 dataLayer 中參數名稱完全相符（請參考下表）
- 說明 — 選填但建議填寫
儲存並重複

點擊儲存，然後對每個想追蹤的參數重複此步驟。

建立自訂維度時，請參考下表。事件參數值必須完全匹配 — GA4 對大小寫敏感。

維度名稱	事件參數	類型
物業 ID	`property_id`	文字
物業名稱	`property_name`	文字
物業品牌	`property_brand`	文字
物業連鎖	`property_chain`	文字
物業 URL 名稱	`property_url_name`	文字
城市名稱	`city_name`	文字
國家代碼	`country_code`	文字
入住日期	`start_date`	文字
退房日期	`end_date`	文字
成人數	`num_adults`	數字
兒童數	`num_children`	數字
取消政策	`cancellation_policy`	文字
房價方案 ID	`rate_plan_id`	文字
房價 ID	`room_rate_id`	文字
房價名稱	`room_rate_name`	文字
優惠數量	`num_perks`	數字
房型位置	`room_location`	文字
房型景觀	`room_view`	文字
房型分類	`room_classification`	文字
床型	`bed_type`	文字

其他可用事件

以下事件存在於 Wink 的 dataLayer 中，但不屬於標準訂房漏斗。它們可能由平台上的其他互動觸發。

`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`	原始使用者代理字串
`os`	偵測到的作業系統 — `Windows`、`MacOS`、`Linux`、`UNIX`
`path`	目前頁面路徑
`title`	目前頁面標題
`userId`	已認證使用者識別碼（未登入時省略）
`startDate`	目前搜尋會話的入住日期
`endDate`	目前搜尋會話的退房日期
`guests`	目前搜尋會話的客人人數
`rooms`	目前搜尋會話的房間數量