Web Widgets – Web Configurations for CSS Customisation and Tracking

It is possible to access RoomBoss mobile friendly web widgets via a subdomain on your own site by using a Web Configuration.

Web configurations will allow you to:

To use, widgets must be accessed via a subdomain. Custom CSS, tracking codes etc will not be displayed for widgets accessed via the main RoomBoss domain.

If you would prefer not to use your own subdomain but would like to use a Web Configuration, we can help – please contact us.

 

 

Setting Up a Subdomain

To host via a subdomain on your own site:

  1. Create subdomain, for example book.yoursite.com
  2. Create a CNAME record pointing your subdomain to cw4.roomboss.com
  3. Enter the URL for the custom CSS file in your RoomBoss account.
    • Log in to your account as a user with “Website Configuration Admin” permission.
    • Navigate → Account → Website Configuration
    • Enter the domain name (for your subdomain) and url for your custom CSS file (include the full url for your css file eg. http://www.myurl.com/mycss.css)

  1. Click Add Website Configuration to save, you can add website configurations (and use different CSS and tracking codes etc) for multiple websites on this page.

It is not necessary to setup Google Tag Manager, Google Analytics, Google Ads and Facebook tracking to use customised widgets, however, if you wish to use these they are also set on the website configuration page.

To Access Availability and Booking Widgets Via Your Subdomain

Once the Web Configuration is added it is possible to access RoomBoss widgets via your own subdomain.

  1. Replace “cw4.roomboss.com” with “book.yoursite.com”
  2. If the url contains text “uid=12345678901234567890123456789012” remove this.

Example for single accommodation

http://cw4.roomboss.com/cw/gen/ins/bpay1.jsf?vid=12345678901234567890123456789012

  • becomes

http://book.yoursite.com/cw/gen/ins/bpay1.jsf?vid=12345678901234567890123456789012

Example for multi accommodation

http://cw4.roomboss.com/cw/gen/ins/ma.jsf?uid=12345678901234567890123456789012

  • becomes

http://book.yoursite.com/cw/gen/ins/ma.jsf

To Use Subdomain For Guest Intranet Links

You can set the same subdomain for all vendors or set a different subdomain for each vendor.

Navigate → Product Setup → Product Details choose a vendor and select the Policy tab. Under Custom Guest Intranet Url:

  • Uncheck Omit Custom Guest Intranet Url
  • Replace “roomboss.com” with “book.yoursite.com” and Save

intrnetUrl

The your booking url displayed on the edit booking page will access the intranet via your subdomain and use your custom CSS.

Other Website Configuration Options

It is not necessary to setup Google Tag Manager, Google Analytics, Google Ads and Facebook tracking to use customised widgets, however, if you wish to use these they are also set on the website configuration page.

Multi Currency


To allow your users to see your rates in their currency of choice check the “Enable User Currency Display” checkbox (foreign currency rates are cached every 12 hours).

 

 

Google Tag Manager


It is possible to leverage RoomBoss conversions and widget usage metrics using Google Tag Manager.

Note that if you are using Google Analytics for monitoring web widget usage, or Google Ads for conversion tracking, these services can be used independently from GTM by entering their respective IDs under Website Configuration settings. (More information for these applications can be found on the page below.)

However, if you wish to create custom events or to leverage conversion tracking with Google Tag Manager linked resources, some setup, such as creation of tags and custom triggers may be required.

Container ID must be added to use Google Tag manager. This can be found on the right side of the main toolbar in the Google Tag Manager dashboard. E.g GTM-M1S23DQ.

Once the Container ID has been added to the desired website configuration, an RB_REQUEST or RB_RESERVATION event is triggered upon order completion, depending on the type of purchase made in the online widget:

RB_REQUEST is triggered after the Send Inquiry button is clicked.

'event' : 'RB_REQUEST',
'vendorName' : 'Vendor Name',
'saleAmount' : 'Sale Amount'

RB_RESERVATION is triggered after the Pay Now/Book and Pay buttons are clicked.

'event' : 'RB_RESERVATION',
'vendorName' : 'Vendor Name',
'saleAmount' : 'Sale Amount'

You can read more about Google Tag Manager here.

 

 

Google Analytics


Google Analytics can be used to leverage valuable data from your website and widget usage.

  • Tracking ID, must be added to use Analytics – a string similar to UA-000000-01, this can be found inside your Analytics account.
  • Domain Name, optional (adding the domain of your main website here will tell Google to treat your widgets as part of this site).
  • Tracker Name, optional.

Once your Tracking ID and optionally, Domain Name and/or Tracker Name have been added to the website configuration, site usage data will become accessible from your Google Analytics dashboard or third-party B.I suite.

The Page View event is triggered when a user navigates to a web widget, or accesses a guest intranet page.

Please note that GA4 is currently not supported when including Google Analytics as a standalone service in the web configuration.

However, you are able to use GA4 properties and leverage web usage data by instead including the Measurement ID within a Google Tag Manager implementation. Find out more.

Lean more about Google Tag Manager in RoomBoss here.

You can read more about Google Analytics here.
 

 

Google Ads


It is possible to track RoomBoss conversions using Google Ads.

  1. Conversion ID, must be added to track Adwords conversions – A 9 or 10 digit number found within your Google Ads account.
    This number will often be displayed with ‘AW’ preceding it. E.g ‘AW-123456789’.
    (Note that you only need the numbers, not any preceding characters.)
  2. Conversion Label, A long string made up of letters, numbers, and punctuation.
    E.g ‘K2_nCIHxlbQBEI-Um80D‘.

Once the Conversion ID and label have been added to the website configuration, bookings made will register a conversion upon completion:

A Conversion event will be triggered after the Pay Now/Book and Pay buttons are clicked.

'google_conversion_label' : 'Conversion Label',
'google_conversion_value' : 'Sale Amount'

Read more about Google Ads here.

 

Google Maps


If you are hosting the multi property widget on your website subdomain, for the map view to function, Google may require you to add your API key. Older websites will not need to do this, but new ones may require you to add your API key to the web configuration.

You can read more about obtaining a Google Maps API key here.

 

 

Facebook Pixel

It is possible to track RoomBoss conversions using Facebook Pixel.

  • Pixel ID, must be added.

Once a Facebook Pixel ID has been added to the website configuration, site usage data will become accessible from your Pixel dashboard.

The Page View event is triggered when a user navigates to a web widget, or accesses a guest intranet page.

Conversion events will also be triggered upon order completion, with the type depending on the type of purchase made in the online widget:

RB_REQUEST conversions are triggered after the Send Inquiry button is clicked.

'event' : 'Conversion',
'type' : 'RB_REQUEST'

RB_RESERVATION conversions are triggered after the Pay Now/Book and Pay buttons are clicked.

'event' : 'Conversion',
'type' : 'RB_Reservation'

You can read more about Facebook Pixel tracking here.