Applies to:          Stayntouch PMS          

Stayntouch IBE: GTM Events & GA4 Compliance

Stayntouch IBE GTM Events

This document describes all Google Tag Manager (GTM) events supported by the Stayntouch IBE application. It explains what each event represents, when it is triggered, and whether it aligns with GA4 standards. 

Overview

The IBE uses a combination of:

• Standard / Recommended GA4 events (as defined by Google Analytics 4)
• Custom GTM events for Stayntouch IBE-specific behavior that is not fully covered by GA4

All events are pushed to the GTM dataLayer and can be mapped to GA4, reporting tools, or partner integrations as required.

1. Page View Tracking

Stayntouch IBE Page View

• Type: Custom Event (mappable to the standard GA4 page_view event)
• Purpose: Tracks page views(page navigation) in the Stayntouch IBE.
• Trigger: Fired whenever the user navigates to a page within the Stayntouch IBE.

Payload Example

{

 "event": "IBE Page View",

 "hotelId": 343,

 "pageType": "Homepage"

}

Supported pageType values

• Homepage
• Room Listing Page
• Checkout Page
• My Account Page

GA4 Compliance

• Custom event
• Can be mapped to GA4 page_view

2. Ecommerce Events (Booking Flow)

These events track the complete booking journey from search → selection → checkout → booking.

search

• Type: Standard GA4 Event
• Trigger: When a user searches for rooms.

{

 "event": "search",

 "hotel_id": 343,

 "ecommerce": {

   "check_in_date": "12-18-2025",

   "check_out_date": "12-19-2025",

   "adults": 2,

   "kids": 0

 }

}

view_item_list

• Type: Standard GA4 Event
• Trigger: When the list of available rooms/rates is displayed.

{

 "event": "view_item_list",

 "hotel_id": 343,

 "ecommerce": {

   "currency": "USD",

   "available_room_count": 7,

   "price_range": {

     "min": 114,

     "max": 1070

   },

   "items": [

     {

       "item_id": 1815,

       "item_name": "Deluxe Queen",

       "available_room_count": 2,

       "rate_plans": [

         {

           "price": 290,

           "name": "Extras QA Rate"

         },

         {

           "price": 1070,

           "name": "Package Including Bike & Parking"

         }

       ]

     },

     ...

   ]

 }

}

(Uses GA4 items[] structure)

view_item

• Type: Standard GA4 Event
• Trigger: When a user views a specific room.

{

 "event": "view_item",

 "hotel_id": 343,

 "ecommerce": {

   "currency": "USD",

   "items": [ ... ]

 }

}

add_to_cart

• Type: Standard GA4 Event
• Trigger: When a user selects a room.

{

 "event": "add_to_cart",

 "hotel_id": 343,

 "ecommerce": {

   "currency": "USD",

   "value": 290,

   "items": [ ... ]

 }

}

remove_from_cart

• Type: Standard GA4 Event
• Trigger: When a user removes a room from the cart.

{

 "event": "remove_from_cart",

 "hotel_id": 343,

 "ecommerce": {

   "currency": "USD",

   "value": 114,

   "items": [ ... ]

 }

}

cart_item_modified

• Type: Custom Event
• Trigger: When an existing cart item is updated (dates, guests, etc.).

{

 "event": "cart_item_modified",

 "hotel_id": 343,

 "ecommerce": {

   "room_id": 26072,

   "room_name": "Deluxe Queen",

   "adults": 1,

   "check_out_date": "12-20-2025"

 }

}

begin_checkout

• Type: Standard GA4 Event
• Trigger: When the user enters the checkout page.

{

 "event": "begin_checkout",

 "hotel_id": 343,

 "ecommerce": {

   "currency": "USD",

   "items": [ ... ]

 }

}

add_payment_info

• Type: Standard GA4 Event
• Trigger: When the payment step is reached or payment details are submitted.

{

 "event": "add_payment_info",

 "hotel_id": 343,

 "ecommerce": {

   "booking_type": "Non-Guaranteed"

 }

}

Supported booking_type values

• Non-Guaranteed
• Credit card

IBE Booking (Successful Booking)

• Type: Custom event (mappable to the standard GA4 purchase event)
• Trigger: Fires after a booking completes successfully.

{

 "event": "IBE Booking",

 "transactionId": "I343679852565",

 "hotelId": 343,

 "currency": "USD",

 "transactionTotal": "1067.00"

}

payment_failure

• Type: Custom Event
• Trigger: When payment authorization or processing fails.

{

 "event": "payment_failure",

 "hotel_id": 343,

 "ecommerce": {

   "failure_type": "authorization",

   "error_code": "400",

   "booking_type": "Credit Card"

 }

}

3. Event Summary & GA4 Compliance