Integrations
      Back to home
      1. Quicktext Knowledge Base
      2. Integrations

      What are the standard procedures for integrating the pixel tracking script?

      In this article, you will find a step-by-step integration and all support documentation to ensure the pixel is properly installed. 

      To resume these are the main things you should know about Pixel tracking: 

      1. Identify Retargeting Potential: Some prospects tend not to finish the booking process and the chances to convert them to actual clients will be at their highest so it will be possible for your colleagues/chatbot managers to recollect these visitors' information and retarget them. 
      2. Identify your conversion rate with Velma: You will be able to analyze Velma's efficiency and calculate your ROI.  
           

       Reporting aeservations Name 10/03/22 Confirrned reservations Waiting tist Reports Analytics 15/04/22 Confirmed 0802/2022 Sales 10/03/2022 aport Green tick means that this reservation mnfirrned ty Velma. 1 a Reporting
       

        

        

      What are the expected approaches to ensure the integration of pixel tracking?* 

      1. The hotelier reaches out to their webmaster/IT department to install the necessary tags on GTM. 
      2. The hotelier sends their consent to the booking engine provider to install the PT for them. 
      3. Quicktext AM contacts the booking engine provider to arrange the installation of the PT. 
      4. Quicktext AM asks for a GTM account associated with the booking engine so we can check it internally, and try to install the script with the help of our dev team. 

      If none of the approaches above apply and/or the Pixel was not successfully installed, the Quicktext AM will ask for a GTM Publisher access from the concerned party and finish it on their own. You might get in touch with people who are not tech-savvies, so it will be your duty to provide the necessary help to ensure access to the GTM account. 

      In case you don't have a Google Tag Manager account, Quicktext can provide assistance and help setting up an account. 

      Step by Step Guide for the standard approach.

      The tracking contains two scripts:

      >Tracking script: This code serves to capture a query string parameter named qt_tracking_id and persists in the client browser's localStorage.
      - This script must be included on ALL booking engine's pages.


      >Confirmation script: When run, it collects the tracking ID from URL or localStorage and reservation data mentioned in "data attributes". Then send a confirmation event to Quicktext.
      - This script must be used on the booking confirmation page, with the required reservation details.

      Tracking script
      Include this script on ALL booking engine pages
      String
      <script type="text/javascript" src="https://tracking.quicktext.im/tracking/generic.min.js"></script>

      Confirmation event
      Run this script when the user confirms the reservation

      <script type="text/javascript" src="https://tracking.quicktext.im/tracking/event.min.js"
         data-type="qt-tracking-event"
         data-event="confirm"
         data-partner="<PARTNER_NAME>"
         data-price="<TOTAL_RESERVATION_PRICE>"
         data-currency="<PRICE_CURRENCY>"
         data-check-in="<CHECKIN_DATE>"
         data-check-out="<CHECKOUT_DATE>"
         data-adults="<ADULTS_COUNT>"
         data-childrens="<CHILDRENS_COUNT>"
         data-rooms="<ROOMS_COUNT>"
      data-booking-reference="<RESERVATION_NUMBER>"
      ></script>

      The booking engine technical team must replace the tokens with the corresponding values depending on the reservation's details:

      Token Type     Format Is mandatory     Description
      <PARTNER_NAME> String   Recommended The booking engine unique name
      <TOTAL_RESERVATION_PRICE>     Number   Mandatory The current booking total price*
      <PRICE_CURRENCY>     String ISO 4217     Mandatory The current booking total price's currency
      <CHECKIN_DATE>     String YYYY-MM-DD     Mandatory The current booking check-in date
      <CHECKOUT_DATE>     String YYYY-MM-DD     Mandatory The current booking check-out date
      <ADULTS_COUNT>     Number   Recommended The current booking adults count
      <CHILDRENS_COUNT>     Number   Recommended The current booking children count
      <ROOMS_COUNT>     Number   Recommended The current booking rooms count
      <RESERVATION_NUMBER> Number   Recommended Reservation ID/number or reference

      Important Notes:

      *Data price is in the universal format.

      *No need to add a readability separator.

      *Always use "." as a decimal separator not ","


      Example script:

      <script type="text/javascript" src="https://tracking.quicktext.im/tracking/event.min.js"
         data-type="qt-tracking-event"
         data-event="confirm"
         data-partner="SomeBookingEngineName"
         data-price="123.456"
         data-currency="USD"
         data-check-in="2021-05-23"
         data-check-out="2021-05-24"
         data-adults="2"
         data-childrens="1"
      data-booking-reference="TERA2548Y"
      ></script>