Booking Platform Installation Guide

See below how to install the Bookassist Booking Platform on your website.

Index of content:

Step One: Tracking code

  • Copy and paste the Bookassist tracking code to all website pages just before the body closing tag.
  • Add the hotel name, hotel id and guide id to the areas required.
<!-- www.bookassist.com web stats  -->
<script>
   var BA = BA || {};
   BA.account = "Hotel name";  // hotel Name
   BA.hotel_id = "XXXX";   // bookassist_hotel_id_number_for_hotel
   BA.hotel_group_id = "";   
   BA.guide_id = "XXXX";   // bookassist_guide_id_number_for_hotel
   (function() {
   var ba = document.createElement('script');
   ba.type = 'text/javascript'; ba.async = true;
   ba.src = '//dwxf316kii2pu.cloudfront.net/scripts/BA/rt-min.jsp';
   var s = document.getElementsByTagName('script')[0];
   s.parentNode.insertBefore(ba, s);
   })();
</script>
<!-- End www.bookassist.com web stats -->

Step Two: Google Analytics code

    • Copy and paste the Google Analytics code to all website pages before the closing tag.
    • Replacing “G-XXXXX-X” with your Google Analytics tracking ID.
    • If you don’t have a Google Analytics account let us know and we can create one for you or you can follow this guide
<!-- Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXX-X"> </script>
<script>
 window.dataLayer = window.dataLayer || [];
 function gtag(){dataLayer.push(arguments);}
 gtag('js', new Date());
 gtag('config', 'G-XXXXX-X');
</script>
<!-- END Google Analytics -->

Important: The hotel’s cookie consent tool may block the loading of the Google Analytics Linker plugin within an acceptable time-frame resulting in the referral being recorded as «direct / (none)». It is the responsibility of the hotel web developers to ensure that the cookie alert plugin they use doesn’t cause an issue with Google Analytics and the Google Analytics Linker plugin.

Step Three: Booking Platform page

The page should be left blank, containing only the script. From there, the system will immediately redirect the booker to the Booking Platform.

  • Add this Javascript at the bottom of the page, before the Bookassist tracking code.
  • Note that the line paramsForBA needs to be set according to the hotel with correct parameters.
  • You must add the hotel id, guide id and domain name for the areas required.
  • You can edit the user language by using the two character ISO language code.
<script>
var BA = BA || {};
BA.destinationURL='https://www.bookassist.com/conduit/bookassist.do';
BA.paramsForBA='action=c_1&guide_id=XXXX&hotel_id=XXXX&service_model=2&ca=center&dw=900&user_language=en';
</script>

<script type="text/javascript" src="https://js.bookassist.com/scripts/BA/be.2-min.jsp?action=c_1&guide_id=XXXX&hotel_id=XXXX&service_model=2&ca=center&dw=900&user_language=en"></script>

Step Four: Book Now button and Date Checker

From Bookassist we offer two different ways of integrating our Booking Platform:

  • Book Now button (Our preferred solution)
  • Date Checker

Book Now button

This is our preferred solution. By adding the Book Now button the booker is redirected to the Select Dates page of the Booking Platform. On this page, the booker can select dates, check prices and availability, and also select the number of rooms and guests.

Make sure to place the Book Now button in a very prominent place of your website, this will guarantee a better conversion rate.

With this implementation we guarantee that the booker gets to the Select Rooms page having selected dates with availability.

This is how the Select Dates page looks like in the Booking Platform:

This is an example code for the Book Now button, what is very important is that the button has this id: baBpButton.

<a href="your-eservations-page-url" id="baBpButton">Book Now</a>

Date Checker

The Date Checker won’t be able to display availability and prices on the website, which could lead to unavailability scenarios in the Select Rooms page of the Booking Platform. In such cases, the booker will have to perform a new search.

These are the parameters that the Date Checker has to pass to the website’s reservations page. The script in that page will redirect the booker to the Booking platform with those parameters.

List of parameters:

date_in [YYYY-MM-DD] Mandatory
date_out  [YYYY-MM-DD] Mandatory
rms [integer] Mandatory
adults [integer] Mandatory
children [integer] Mandatory if the hotel accepts children
promo_code [string] Optional

 

With these parameters the booker has to be redirected to the website’s reservation page with a query string. Example:

http://www.hoteldomain.com/reservations-page?date_in=2030-06-05&date_out=2030-06-06&rms=1&adults=2&children=0&promo_code=TestPromo

This is a very simple example code for the Date Checker. Please consider using a library to control and synchronize calendars.

<form>
 <label for="date_in">Arrival</label>
 <input type="date" name="date_in" id="date_in">
 <label for="date_out">Departure</label>
 <input type="date" name="date_out" id="date_out">
 <label for="rms">Rooms</label>
 <select name="rms" id="rms">
   <option value="1" selected>1</option>
   <option value="2">2</option>
   <option value="3">3</option>
   <option value="4">4</option>
   <option value="5">5</option>
   <option value="6">6</option>
   <option value="7">7</option>
   <option value="8">8</option>
   <option value="9">9</option>
   <option value="10">10</option>
 </select>
 <label for="adults">Adults</label>
 <select name="adults" id="adults">
   <option value="1">1</option>
   <option value="2" selected>2</option>
   <option value="3">3</option>
   <option value="4">4</option>
   <option value="5">5</option>
   <option value="6">6</option>
   <option value="7">7</option>
   <option value="8">8</option>
   <option value="9">9</option>
   <option value="10">10</option>
   <option value="11">11</option>
   <option value="12">12</option>
   <option value="13">13</option>
   <option value="14">14</option>
   <option value="15">15</option>
   <option value="16">16</option>
   <option value="17">17</option>
   <option value="18">18</option>
   <option value="19">19</option>
   <option value="20">20</option>
 </select>
 <label for="children">Children</label>
 <select name="children" id="children">
   <option value="0" selected>0</option>
   <option value="1">1</option>
   <option value="2">2</option>
   <option value="3">3</option>
   <option value="4">4</option>
   <option value="5">5</option>
   <option value="6">6</option>
   <option value="7">7</option>
   <option value="8">8</option>
   <option value="9">9</option>
   <option value="10">10</option>
   <option value="11">11</option>
   <option value="12">12</option>
   <option value="13">13</option>
   <option value="14">14</option>
   <option value="15">15</option>
   <option value="16">16</option>
   <option value="17">17</option>
   <option value="18">18</option>
   <option value="19">19</option>
   <option value="20">20</option>
 </select>
 <label for="promo_code">Promo Code</label>
 <input type="text" name="promo_code" id="promo_code">
</form>

Step Five: Final checks

Please reply to the installation package email to confirm you have completed the install.

Glossary

  • Hotel name: The name of the hotel.
  • Hotel ID: The unique identifier of the hotel.
  • Guide ID: The location ID of the hotel.
  • User language: The language the engine will be displaying in.
  • Tracking code: Bookassist’s own tracking code.
  • Google Analytics: Google’s tracking code for e-commerce tracking.
  • Date Checker: The calendar widget where users can select their arrival and departure dates.
  • Booking Platform: The Bookassist Platform code displays the Bookassist booking platform.