אינטגרציית GTM Analytics

אתה יכול לחבר כל מכולת Google Tag Manager (GTM) ל-Wink על ידי הזנת מזהה מכולת GTM שלה בפורטל Wink. לאחר החיבור, המכולת שלך נטענת אוטומטית עבור הנכס שלך וקוראת ישירות את אירועי ההזמנה של Wink — ומכסה את כל מסע האורח מחיפוש ועד להשלמת ההזמנה. מקרה שימוש נפוץ הוא מכולת Sojern לריטרגטינג ופרסום, אך כל מכולת GTM פועלת באותה צורה.

מה עליך לעשות

קבל את מזהה מכולת ה-GTM שלך

השג את מזהה מכולת GTM שלך (בפורמט GTM-XXXXXXX). אם הוא מגיע משותף כמו Sojern, בקש את מזהה מכולת ה-GTM ספציפית — הוא שונה מזה של פיקסל או תג.
הזן אותו בפורטל Wink

היכנס ל-app.wink.travel, בחר את החשבון שלך ופתח את הגדרות ההתאמה האישית שלך. בקטגוריית Analytics & integrations, הדבק את מזהה מכולת ה-GTM בשדה GTM Container ID ושמור. האינטגרציה שלך פעילה כעת.
אשר עם הספק שלך

אם המכולת שלך מגיעה משותף כמו Sojern, הודע למנהל החשבון שלך שהאינטגרציה פעילה. הם יכולים לוודא מהצד שלהם שהתגים מופעלים כראוי ב-wink.travel עבור הנכס שלך ושהנתונים זורמים לחשבונך.

מה Wink עושה בצד שלנו

לשקיפות, הנה מה ש-Wink מגדיר כדי שהאינטגרציה הזו תעבוד:

שדה מזהה מכולת GTM זמין בקטגוריית Analytics & integrations בהגדרות ההתאמה האישית שלך. כשאתה מזין את מזהה המכולת, Wink מאמת את הפורמט (GTM-XXXXXXX) ושומר אותו בצורה מאובטחת כנגד הנכס שלך.
בכל דף שבו הנכס שלך פעיל ב-Wink, המכולת שלך מוזרקת ישירות לדף — ומשתפת את window.dataLayer של Wink — כך שהיא נטענת לצד מכולת Wink עצמה ללא תלות בהגדרות נוספות. זה קורה אוטומטית, ללא עבודה פרטנית על כל נכס מצד צוות Wink.
המכולת שלך נטענת באופן אסינכרוני, כך שהיא לא משפיעה על ביצועי טעינת הדף עבור האורחים שלך.
המעקב של Wink והמכולת שלך פועלים במקביל, וקוראים מאותו dataLayer משותף. כל אירוע הזמנה ש-Wink עוקב אחריו זמין בו-זמנית למכולת שלך.
כשלא צופים בנכס שלך — למשל, כאשר אורח גולש במלון אחר ב-Wink — המכולת שלך לא נטענת, ולכן היא מקבלת רק נתונים הרלוונטיים לנכס שלך.
אירוע ההזמנה המושלמת (purchase) מופעל בדפדפן בדף התודה. מזהה מכולת GTM הוא תיבה שחורה — Wink לא מניח אילו תגיות יש בתוכה — ולכן Wink לעולם לא קורא לגוגל מטעם השרתים שלה. במקום זאת, כל תג GA4 או תג המרה שנמצא במכולת שלך מקבל את אירוע ה-purchase בצד הלקוח, בדיוק כמו כל אירוע הזמנה אחר. מכיוון שספק התשלום מפנה את דפדפן האורח החוצה וחזרה, Wink מחברת מחדש את סשן האנליטיקס שההפניה קטעה לפני הפעלת purchase, כך שהמכירה משויכת לביקור המקורי של האורח ולא נספרת כסשן חדש.

הפניה ל-DataLayer

Wink דוחפת אירועים תואמי GA4 ל-dataLayer לאורך כל מסע האורח. מכולת ה-GTM שלך קוראת מאותו dataLayer משותף, כך שכל טריגר או משתנה שתגדיר יקבלו גישה לכל התכונות המתוארות למטה.

כל אירוע עוקב אחרי מבנה GA4 Enhanced Ecommerce סטנדרטי: מחרוזת event ברמה העליונה ואובייקט ecommerce. לפני כל דחיפה, Wink מנקה את מטען ה-ecommerce הקודם כדי למנוע דליפת נתונים ישנים לטריגרים חדשים.

תבנית איפוס 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`

מופעל כאשר אורח מאמת באמצעות כניסה יחידה (SSO).

{
  "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`	מחרוזת	כן	מזהה ייחודי לחדר או מוצר
`item_name`	מחרוזת	—	שם החדר או המוצר
`affiliation`	מחרוזת	—	שם שותף או מוכר
`coupon`	מחרוזת	—	קוד קופון שהוחל על הפריט
`currency`	מחרוזת	—	קוד מטבע ISO 4217 (למשל `USD`)
`creative_name`	מחרוזת	—	שם הקריאייטיב בקידום
`creative_slot`	מחרוזת	—	מיקום הקריאייטיב בקידום
`discount`	מספר	—	סכום ההנחה שהוחל
`index`	מספר	—	מיקום ברשימה (מתחיל ב-1)
`item_brand`	מחרוזת	—	שם המלון או המותג
`item_category`	מחרוזת	—	סוג מוצר — למשל `GUEST_ROOM`, `ACTIVITY`, `ATTRACTION`, `MEETING_ROOM`, `RESTAURANT`, `SPA`
`item_list_id`	מחרוזת	—	מזהה הרשימה שהפריט שייך אליה
`item_list_name`	מחרוזת	—	שם התצוגה של הרשימה
`location_id`	מחרוזת	—	קואורדינטות גאוגרפיות של הנכס
`price`	מספר	—	מחיר ליחידה
`promotion_id`	מחרוזת	—	מזהה הקידום
`promotion_name`	מחרוזת	—	שם התצוגה של הקידום
`quantity`	מספר	—	כמות (ברירת מחדל `1`)

פרמטרים מותאמים בהיקף פריט

פרמטרים אלה נושאים הקשר הזמנה ספציפי ל-Wink. GA4 לא מציג אותם אוטומטית בדוחות — יש לרשום כל אחד מהם כמידה מותאמת בהיקף פריט בנכס GA4 שלך לפני שיופיע בדוחות או בחקירות. ראה מידות מותאמות ב-GA4 למטה להוראות הגדרה.

תכונה	סוג	תיאור
`property_id`	מחרוזת	מזהה נכס ב-Wink
`property_name`	מחרוזת	שם תצוגה של הנכס
`property_brand`	מחרוזת	המותג שהנכס שייך לו
`property_chain`	מחרוזת	הרשת שהנכס שייך לה
`property_url_name`	מחרוזת	שם ידידותי ל-URL של הנכס
`city_name`	מחרוזת	שם העיר שבה נמצא הנכס
`country_code`	מחרוזת	קוד מדינה ISO 3166-1 alpha-2
`start_date`	מחרוזת	תאריך צ’ק-אין בפורמט `YYYY-MM-DD`
`end_date`	מחרוזת	תאריך צ’ק-אאוט בפורמט `YYYY-MM-DD`
`num_adults`	מספר	מספר מבוגרים בהזמנה
`num_children`	מספר	מספר ילדים בהזמנה
`cancellation_policy`	מחרוזת	אחד מהבאים: `Refundable`, `Non-Refundable`, `Refundable-With-Restrictions`, `Non-Refundable-With-Restrictions`
`rate_plan_id`	מחרוזת	מזהה תוכנית תעריפים
`room_rate_id`	מחרוזת	מזהה תעריף חדר ספציפי
`room_rate_name`	מחרוזת	שם תצוגה של תעריף החדר
`num_perks`	מספר	מספר הטבות כלולות בתעריף
`room_location`	מחרוזת	תיאור מיקום החדר (למשל `Overwater`, `Garden`)
`room_view`	מחרוזת	תיאור נוף החדר (למשל `Ocean`, `City`)
`room_classification`	מחרוזת	סיווג או דרגה של החדר (למשל `Suite`, `Standard`)
`bed_type`	מחרוזת	תצורת המיטה בחדר (למשל `King`, `Twin`)

מידות מותאמות ב-GA4

GA4 מתעלם מפרמטרים מותאמים בהיקף פריט בדוחות עד שתירשם אותם במפורש כמידות מותאמות בהיקף פריט. יש לרשום רק את הפרמטרים שאתה מתכוון להשתמש בהם בדוחות — אין צורך לרשום את כל 20.

פתח הגדרות מותאמות

ב-GA4, עבור ל-Admin (אייקון גלגל שיניים בתחתית שמאל) → בחר את הנכס שלך → Data display → Custom definitions.
צור מידה מותאמת חדשה

לחץ על Create custom dimensions.
מלא את פרטי המידה
- Dimension name — התווית הקריאה לבן אדם שמופיעה בדוחות GA4 (ראה טבלה למטה)
- Scope — בחר Item
- Event parameter — שם הפרמטר המדויק כפי שמופיע ב-dataLayer (ראה טבלה למטה)
- Description — אופציונלי אך מומלץ
שמור וחזור על הפעולה

לחץ על Save, ואז חזור על הפעולה עבור כל פרמטר שברצונך לעקוב אחריו.

השתמש בטבלה הבאה כהפניה בעת יצירת מידות מותאמות. ערך Event parameter חייב להתאים במדויק — GA4 רגיש לאותיות רישיות.

שם המידה	Event parameter	סוג
מזהה נכס	`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`	טקסט
מזהה תוכנית תעריפים	`rate_plan_id`	טקסט
מזהה תעריף חדר	`room_rate_id`	טקסט
שם תעריף חדר	`room_rate_name`	טקסט
מספר הטבות	`num_perks`	מספר
מיקום חדר	`room_location`	טקסט
נוף חדר	`room_view`	טקסט
סיווג חדר	`room_classification`	טקסט
סוג מיטה	`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`	מחרוזת סוכן משתמש גולמית
`os`	מערכת ההפעלה שזוהתה — `Windows`, `MacOS`, `Linux`, `UNIX`
`path`	נתיב הדף הנוכחי
`title`	כותרת הדף הנוכחי
`userId`	מזהה משתמש מאומת (נמחק כאשר לא מחובר)
`startDate`	תאריך צ’ק-אין מהסשן החיפוש הנוכחי
`endDate`	תאריך צ’ק-אאוט מהסשן החיפוש הנוכחי
`guests`	מספר האורחים מהסשן החיפוש הנוכחי
`rooms`	מספר החדרים מהסשן החיפוש הנוכחי