Integrasi Analitis GTM

Anda boleh menyambungkan mana-mana kontena Google Tag Manager (GTM) ke Wink dengan memasukkan ID Kontena GTM dalam portal Wink. Setelah disambungkan, kontena anda akan dimuat secara automatik untuk hartanah anda dan membaca acara tempahan Wink secara langsung — merangkumi keseluruhan perjalanan tetamu dari carian hingga tempahan selesai. Kes penggunaan biasa adalah kontena Sojern untuk penargetan semula dan pengiklanan, tetapi mana-mana kontena GTM berfungsi dengan cara yang sama.

Tip

Ini mengandaikan anda sudah mempunyai ID Kontena GTM (format GTM-XXXXXXX). Jika kontena anda datang dari rakan kongsi seperti Sojern, minta pengurus akaun anda untuk ID Kontena GTM secara khusus — ia berbeza daripada ID piksel atau tag. Baru dengan Sojern? Lawati sojern.com/contact untuk memulakan.

---

Apa Yang Perlu Anda Lakukan

1. Dapatkan ID Kontena GTM Anda

   Dapatkan ID Kontena GTM anda (format GTM-XXXXXXX). Jika ia datang dari rakan kongsi seperti Sojern, minta ID Kontena GTM secara khusus — ia berbeza daripada ID piksel atau tag.

2. Masukkan Dalam Portal Wink

   Log masuk ke app.wink.travel, pilih akaun anda, dan buka tetapan penyesuaian anda. Dalam bahagian Analitis & integrasi, tampal ID Kontena GTM anda ke dalam medan GTM Container ID dan simpan. Integrasi anda kini aktif.

3. Sahkan Dengan Penyedia Anda

   Jika kontena anda datang dari rakan kongsi seperti Sojern, beritahu pengurus akaun anda bahawa integrasi sudah aktif. Mereka boleh mengesahkan dari pihak mereka bahawa tag berfungsi dengan betul di wink.travel untuk hartanah anda dan data mengalir ke akaun anda.

Note

Anda tidak perlu meletakkan sebarang kod piksel di laman web anda sendiri untuk integrasi ini. Wink memuatkan kontena GTM anda secara automatik di semua halaman di mana hartanah anda aktif.

Ini berfungsi untuk mana-mana ID Kontena GTM — Sojern hanyalah contoh biasa.

---

Apa Yang Wink Lakukan Di Pihak Kami

Untuk ketelusan, berikut adalah apa yang Wink konfigurasikan untuk menjadikan integrasi ini berfungsi:

• Medan ID Kontena GTM tersedia dalam bahagian Analitis & integrasi di tetapan penyesuaian anda. Apabila anda memasukkan ID Kontena, Wink mengesahkan formatnya (GTM-XXXXXXX) dan menyimpannya dengan selamat untuk hartanah anda.
• Pada setiap halaman di mana hartanah anda aktif di Wink, kontena anda disuntik terus ke halaman — berkongsi window.dataLayer Wink sendiri — supaya ia dimuat bersama kontena Wink tanpa bergantung pada konfigurasi tambahan. Ini berlaku secara automatik, tanpa kerja per-hartanah dari pasukan Wink.
• Kontena anda dimuat secara tak segerak (asynchronously), jadi ia tidak menjejaskan prestasi muat halaman untuk tetamu anda.
• Penjejakan Wink sendiri dan kontena anda berjalan selari, membaca dari dataLayer yang dikongsi sama. Setiap acara tempahan yang Wink jejak tersedia serentak untuk kontena anda.
• Apabila hartanah anda tidak sedang dilihat — contohnya, apabila tetamu melayari hotel lain di Wink — kontena anda tidak dimuat, jadi ia hanya menerima data yang berkaitan dengan hartanah anda.
• Tempahan selesai (purchase) dipicu di pelayar pada halaman terima kasih. ID Kontena GTM adalah kotak hitam — Wink tidak boleh mengandaikan apa tag yang ada di dalamnya — jadi Wink tidak pernah memanggil Google bagi pihak anda dari pelayannya. Sebaliknya, apa sahaja tag GA4 atau penukaran yang ada dalam kontena anda menerima purchase di sisi klien, sama seperti setiap acara tempahan lain. Kerana penyedia pembayaran mengalihkan pelayar tetamu pergi dan kembali, Wink menyambung semula sesi analitis yang terputus oleh pengalihan sebelum memicu purchase, supaya jualan dikaitkan dengan lawatan asal tetamu dan tidak dikira sebagai sesi baru.

---

Rujukan DataLayer

Wink menolak acara yang serasi GA4 ke dataLayer sepanjang perjalanan tetamu. Kontena GTM anda membaca dari dataLayer yang sama ini, jadi mana-mana pencetus atau pembolehubah yang anda konfigurasikan mempunyai akses kepada semua sifat yang diterangkan di bawah.

Setiap acara mengikuti struktur GA4 Enhanced Ecommerce standard: rentetan event peringkat atas dan objek ecommerce. Sebelum setiap tolak, Wink membersihkan muatan ecommerce sebelumnya untuk mengelakkan data lama tercampur ke dalam pencetus baru.

Note

Corak reset dataLayer

Wink menetapkan semula objek ecommerce sebelum setiap tolak acara:

dataLayer.push({ ecommerce: null });   // kosongkan acara sebelumnya
dataLayer.push({ event: '...', ecommerce: { ... } });

Jangan bergantung pada sifat ecommerce yang kekal antara acara. Sentiasa baca pada masa pencetus dalam acara yang sama.

---

Acara Perjalanan Tempahan

Acara ini dipicu secara automatik apabila tetamu bergerak melalui corong tempahan. Konfigurasikan pencetus GTM anda sebagai pencetus Custom Event yang sepadan dengan nama acara di bawah.

Langkah	Acara	Bila Ia Dipicu
1	view_item_list	Grid atau senarai inventori hotel dimuat
2	view_item	Tetamu melihat halaman hartanah tertentu
3	add_to_cart	Tetamu menambah bilik ke troli beli-belah
4	begin_checkout	Halaman pembayaran / checkout dimuat
5	add_payment_info	Tetamu memilih kaedah pembayaran
6	login	Tetamu mengesahkan identiti melalui SSO
7	purchase	Tempahan disahkan
8	refund	Tempahan dibatalkan

---

view_item_list

Dipicu apabila grid atau senarai inventori hotel dipaparkan.

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

---

view_item

Dipicu apabila tetamu melihat hartanah tertentu.

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

---

add_to_cart

Dipicu apabila tetamu menambah bilik ke troli mereka.

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

---

begin_checkout

Dipicu apabila halaman checkout / pembayaran dimuat.

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

coupon hanya hadir apabila kod diskaun digunakan.

---

add_payment_info

Dipicu apabila tetamu memilih atau mengesahkan kaedah pembayaran.

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

payment_type diisi dari jenis pemeroleh pembayaran. coupon hanya hadir apabila kod diskaun digunakan.

---

login

Dipicu apabila tetamu mengesahkan identiti melalui single sign-on.

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

---

purchase

Dipicu apabila tempahan disahkan.

{
  "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 adalah pengecam unik kontrak tempahan. coupon, shipping, dan tax hanya hadir apabila berkenaan.

---

refund

Dipicu apabila tempahan dibatalkan.

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

transaction_id sepadan dengan acara purchase untuk tempahan yang sama. coupon, shipping, dan tax hanya hadir apabila berkenaan.

---

Sifat Item

Semua acara yang termasuk tatasusunan items berkongsi skema item yang sama. Setiap sifat adalah pilihan kecuali ditandakan wajib.

Medan GA4 standard

Medan ini difahami secara asli oleh GA4 dan muncul dalam laporan ecommerce standard tanpa konfigurasi tambahan.

Sifat	Jenis	Wajib	Penerangan
item_id	string	Ya	Pengecam unik untuk bilik atau produk
item_name	string	—	Nama bilik atau produk
affiliation	string	—	Nama afiliasi atau penjual
coupon	string	—	Kod kupon yang digunakan pada item
currency	string	—	Kod mata wang ISO 4217 (contoh USD)
creative_name	string	—	Nama kreatif yang digunakan dalam promosi
creative_slot	string	—	Posisi slot kreatif promosi
discount	number	—	Jumlah diskaun yang digunakan
index	number	—	Posisi dalam senarai (bermula 1)
item_brand	string	—	Nama hotel atau jenama
item_category	string	—	Jenis produk — contohnya GUEST_ROOM, ACTIVITY, ATTRACTION, MEETING_ROOM, RESTAURANT, SPA
item_list_id	string	—	Pengecam senarai yang item ini miliki
item_list_name	string	—	Nama paparan senarai
location_id	string	—	Koordinat geo hartanah
price	number	—	Harga unit
promotion_id	string	—	Pengecam promosi
promotion_name	string	—	Nama paparan promosi
quantity	number	—	Kuantiti (lalai 1)

Parameter item khusus

Parameter ini membawa konteks tempahan khusus Wink. GA4 tidak secara automatik memaparkannya dalam laporan — anda mesti mendaftar setiap satu sebagai dimensi khusus berjangka item dalam harta GA4 anda sebelum ia muncul dalam eksplorasi atau laporan standard. Lihat Dimensi Khusus dalam GA4 di bawah untuk arahan penyediaan.

Sifat	Jenis	Penerangan
property_id	string	Pengecam hartanah Wink
property_name	string	Nama paparan hartanah
property_brand	string	Jenama yang hartanah miliki
property_chain	string	Rangkaian yang hartanah miliki
property_url_name	string	Slug mesra URL untuk hartanah
city_name	string	Bandar di mana hartanah terletak
country_code	string	Kod negara ISO 3166-1 alpha-2
start_date	string	Tarikh daftar masuk dalam format YYYY-MM-DD
end_date	string	Tarikh daftar keluar dalam format YYYY-MM-DD
num_adults	number	Bilangan dewasa dalam tempahan
num_children	number	Bilangan kanak-kanak dalam tempahan
cancellation_policy	string	Salah satu: Refundable, Non-Refundable, Refundable-With-Restrictions, Non-Refundable-With-Restrictions
rate_plan_id	string	Pengecam pelan kadar
room_rate_id	string	Pengecam kadar bilik tertentu
room_rate_name	string	Nama paparan kadar bilik
num_perks	number	Bilangan keistimewaan yang termasuk dengan kadar
room_location	string	Penerangan lokasi bilik (contoh Overwater, Garden)
room_view	string	Penerangan pemandangan bilik (contoh Ocean, City)
room_classification	string	Klasifikasi atau tahap bilik (contoh Suite, Standard)
bed_type	string	Konfigurasi katil untuk bilik (contoh King, Twin)

---

Dimensi Khusus dalam GA4

GA4 mengabaikan parameter item khusus dalam laporan sehingga anda mendaftarkannya secara eksplisit sebagai dimensi khusus berjangka item. Anda hanya perlu mendaftar parameter yang anda ingin gunakan dalam laporan — tidak perlu mendaftar kesemua 20.

1. Buka Definisi Khusus

   Dalam GA4, pergi ke Admin (ikon gear bawah kiri) → pilih harta anda → Paparan data → Definisi khusus.

2. Cipta dimensi khusus baru

   Klik Create custom dimensions.

3. Isikan butiran dimensi

   • Nama dimensi — label mesra manusia yang muncul dalam laporan GA4 (lihat jadual di bawah)
   • Skop — pilih Item
   • Parameter acara — nama parameter tepat seperti dalam dataLayer (lihat jadual di bawah)
   • Penerangan — pilihan tetapi disyorkan

4. Simpan dan ulang

   Klik Save, kemudian ulang untuk setiap parameter yang anda mahu jejak.

Note

Dimensi khusus boleh mengambil masa sehingga 24 jam untuk mula muncul dalam laporan GA4 selepas pendaftaran. Data sejarah yang dikumpul sebelum pendaftaran tidak diisi semula.

GA4 membenarkan sehingga 50 dimensi khusus berjangka item per harta pada harta standard (harta 360 membenarkan lebih banyak).

Gunakan jadual berikut sebagai rujukan anda semasa mencipta dimensi khusus. Nilai Parameter acara mesti sepadan tepat — GA4 peka huruf besar kecil.

Nama dimensi	Parameter acara	Jenis
ID Hartanah	property_id	Teks
Nama Hartanah	property_name	Teks
Jenama Hartanah	property_brand	Teks
Rangkaian Hartanah	property_chain	Teks
Nama URL Hartanah	property_url_name	Teks
Nama Bandar	city_name	Teks
Kod Negara	country_code	Teks
Tarikh Daftar Masuk	start_date	Teks
Tarikh Daftar Keluar	end_date	Teks
Bilangan Dewasa	num_adults	Nombor
Bilangan Kanak-kanak	num_children	Nombor
Polisi Pembatalan	cancellation_policy	Teks
ID Pelan Kadar	rate_plan_id	Teks
ID Kadar Bilik	room_rate_id	Teks
Nama Kadar Bilik	room_rate_name	Teks
Bilangan Keistimewaan	num_perks	Nombor
Lokasi Bilik	room_location	Teks
Pemandangan Bilik	room_view	Teks
Klasifikasi Bilik	room_classification	Teks
Jenis Katil	bed_type	Teks

---

Acara Tambahan Tersedia

Acara berikut tersedia dalam dataLayer Wink tetapi bukan sebahagian daripada corong tempahan standard. Ia mungkin dipicu oleh interaksi lain di 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"
}

Tiada muatan ecommerce disertakan dengan acara ini.

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

Ini adalah acara khusus Wink — bukan sebahagian daripada set acara GA4 standard. Ia ditolak pada setiap navigasi halaman dan membawa konteks peranti dan sesi. Ia tidak termasuk objek 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"
}

Sifat	Penerangan
device	Jenis peranti dikesan — Desktop, Android, iPhone, iPad, atau serupa
deviceAgent	Rentetan agen pengguna mentah
os	Sistem operasi dikesan — Windows, MacOS, Linux, UNIX
path	Laluan halaman semasa
title	Tajuk halaman semasa
userId	Pengecam pengguna yang disahkan (dikecualikan apabila tidak log masuk)
startDate	Tarikh daftar masuk dari sesi carian semasa
endDate	Tarikh daftar keluar dari sesi carian semasa
guests	Bilangan tetamu dari sesi carian semasa
rooms	Bilangan bilik dari sesi carian semasa