Alapbeállítások – R+ foglalómotor

Hogyan építsük be:

Illessze be a következő kódot a weboldalába (a hotId minden esetben a szálláshely 6 jegyű Previo azonosítója):

<!-- Reservation PLUS start -->
<script type="text/javascript" src="https://booking.previo.app/iframe/"></script>
<iframe src="https://booking.previo.app/?hotId=XXXXXX" scrolling="no" frameborder="0"
width="100%" height="2000" name="previo-booking-iframe" id="previo-booking-iframe"
allowTransparency="true"></iframe>
<!-- Reservation PLUS end -->

Kötelező paraméterek:

  • hotId=xxxxxx – A Hotel azonosítója (A Segítség / Az applikációról menüpontban is megtalálható)

Az SRC attribútum iframe opcionális paraméterei:

Általános paraméterek:

  • lang=hu – az egyes nyelvi változatok megjelölése (HU=Magyar, CS = cseh, EN = angol, DE = német, RU =orosz, SK = szlovák, IT = olasz, FR = francia, ES = spanyol, PL = Polish, ZH –Chinese, RO = Romanian, SL = Slovenian, UK = Ukrainian)
  • currency=HUF – a pénznem (CZK = cseh korona, USD = US Dollár, EUR = Euro, GBP – angol font, RUB – orosz rubel, PLN – lengyel zloty, UAH – ukrán hrivnya)
  • showTabs=reservation-maps – csak a kiválasztott részeket mutatja az oldalon (“reservation” – foglalás,“stay” – csomagok, “review” – vendégértékelések, “pricelist” – árlista, “occupancy” –foglaltság, “map” – térkép, “hotels”  – az összes a csoportba tartozó szálláshely megjelenítése, “service”-szolgáltatások (szálláshely szolgáltatás nélkül foglalhatók ). Az egyes részeket kötőjellel kell elválasztani. A megjelenés sorrendjét a paraméterek sorrendje határozza meg.
  • hideTabs=stay-review-pricelist-occupancy – a kiválasztott részeket elrejti (“reservation” – foglalás,“stay” – csomagok, “review” – vendégértékelések, “pricelist” – árlista, “occupancy” –foglaltság, “map” – térkép). Az egyes részeket kötőjellel kell elválasztani.
  • theme= a sablon színe – lehetséges színkódok: dark, orange, red, green, gray, bordo, brown, purple, theme01, darkblue, black, darkbrown, lightorange, darkgreen, lightgreen, wine, violet, darkpink, gold, naturegreen, pink, vagyis sötét, narancssárga, piros, zöld, szürke, bordó, barna, lila, theme01, sötétkék, fekete, sötétbarna, világos narancs, sötétzöld, világoszöld, borvörös, ibolya
  • &theme=darkmode-…:Sötét megjelenési mód, több színtéma elérhető a paraméterezésekkel: &theme=darkmode-gold, darkmode-cyan, darkmode-gray, darkmode-pink, darkmode-blue, darkmode-orange, darkmode-green paraméterrel
  • ga=UA-1234567-8 – Google Analytics fiókazonosító (Property ID) a forgalom mérésére
  • hotelDetail=1, szálláshely részletes leírását is mutatja (logo, név, csillagok száma, cím, értékelések, rövid leírás és fotok). Különösen akkor hasznos, ha az űrlap új ablakban van, vagy ha más oldalakról hivatkozik rá.
  • showHotels=XXX-YYY, a paraméter segítségével kiválasztható, hogy a csoport mely szállodái jelenjenek meg az foglalómotor „Létesítmények listája” és „Térkép” fülén. Az egyenlőségjel után csak írja be a profilazonosítókat (Hotel ID); ha egynél több profilt szeretne megjeleníteni, válassza el az azonosítókat kötőjellel. Pl.: showHotels = 730562-730700
  • ratePlan=XXX Ezzel a paraméterrel beszúrhat egy foglalási motort, amely más árlistát használ, mint amit általános használatra beállított a foglalómotorban a Foglalási rendszerek beállításaiban. Ezzel a paraméterrel az R+ a kiválasztott árlista áraival, kihasználtságával és korlátozásaival fogja működni. Az árlista azonosítója az árlistában található (ceruza ikon alatt). Ez a paraméter kombinálható a következő nrrRatePlan paraméterrel is.
  • nrrRatePlan=YYY lásd fent a ratePlan paraméter leírását. Példa mindkét paraméter egyidejű használatára: https://booking.previo.cz/?hotId=XXXX&ratePlan=1111&nrrRatePlan=2222

Foglalás fül paraméterei:

  • &guestFilter=1: a dátumválasztó mellé helyezett előzetes vendégszám megadására szolgáló szűrő. Az „arrival” paraméterrel együtt használható. A vendégek konkrét száma további paraméterekkel állítható be numberOfAdults=X a childAges=X-Y. Ezen paraméterek nélkül automatikusan 2 felnőttet fogunk kitölteni, mint a leggyakoribb opciót. Ezzel a paraméterrel lehetőség nyílik az étkezések árát tartalmazó szobaárak bemutatására és kiválasztására a szoba kiválasztása során (ha nem szeretné megjeleníteni az összes étkezési lehetőséget a foglalási motor ezen lépésében, használja a hideRoomMeals=1 paramétert, és az étkezések a következő lépésben kerülnek kiválasztásra extra szolgáltatásokkal) .

  • showRoomType=546, a foglalási űrlap csak bizonyos szobákat mutat (szobatípus azonosítók alapján), több megjelenítendő szoba esetén az azonosítókat kötőjellel kell elválasztani:  showRoomType=12345-6543-8974
  • highlightRoomType=546, a megadott szobatípus kiemelten fog megjelenni a foglalóoldalon (546 helyébe az adott típus azonosítója kerül) A szobatípus kerül elsőként felsorolásra, az árának részletes kibontásával
  • discountCoupon=ABC2017, a kuponkód automatikusan kitöltésre kerül a foglalási űrlap első lépésében
  • expandPrices=1 – a foglalás második lépésénél az összes befoglalható létszámra vonatkozó árat megmutatja
  • expandServices=1, a foglalás harmadik lépésében a szállodai szolgáltatásokban az „Összes” fül jelenik meg, amelyen az összes listázott és nem listázott szolgáltatás látható
  • hideSoldRooms=1 elrejti a listáról a teltházas vagy értékesítés elől lezárt szobákat.
  • hideBenefits=1, elrejti a szöveges és grafikus motivációs tényezőket a foglalási folyamat első lépésében. 
  • everyGuestSameMeal=1– nem teszi lehetővé, hogy az egyes vendégek számára különböző típusú ételt rendeljenek.

A foglalás utolsó lépésének paraméterei:

  • showGuestDetail=1, legördítve mutatja a foglalás utolsó részében a vendég adatait. (hamarosan elérhető)
  • showNote=1, megjegyzés rovat megjelenik a foglalás utolsó lépésében.
  • mandatoryData=name-address-country-passport-visa – beállítja azon mezőket, melyeket kötelezően kitöltetünk a vendéggel a foglalási folyamat harmadik lépésében. (“name” – teljes név, “country” – ország, “address” – teljes cím, “visa” – vízum száma)
  • optionalData=1- elegendő lesz a név, telefonszám és email cím megadása a foglaló vendég részéről, a kötelező adatkérést kapcsolja ki. Abban az esetben lehetséges használni, ha semmilyen előleg bekérése nem történik a weboldalas foglalások esetében.
  • hideCompany=1 paraméterrel a Reservation+ oldalról elrejthető a céges számla igénylési lehetőség
  • redirectUrl=http://www.mydomain.com/thank-you-for-reservation – URL, saját köszönőoldaluk beépíthető, ekkor a foglalás befejezésekor a foglalási űrlap utolsó lépésébe ide kerülnek átirányításra. Használható opcionális paraméterezésként a  redirectType=iframe/parent , amivel az adott oldalra irányít az iframen belül, vagy a szülőoldalon. Amennyiben nem használják ezt a paramétert, az iframe opció kerül automatikusan kiválasztásra. A következő GET paraméterek kerülnek elküldésre:
    •pole comIds – éppen létrehozott foglalások száma, API kapcsolatokkal (pl. Hotels.searchBonuses) lehetőség van bővebb adatkinyerésre is
    •price – Teljes ár
    •currency – foglalás pénzneme
    •arrival – érkezési nap a következő formátumban YYYY-MM-DD
    •departure – utazási nap a következő formátumban YYYY-MM-DD
    •customerName – kapcsolattartó neve
    •customerEmail – kapcsolattartó email címe

Az Árak/foglaltság fül paraméterei:

  • pricelistType=seasons, mely használatakor időszakonként mutatja az elérhető árakat a rendszer (hasonlóan a régi foglalási motorhoz, valamint jelenleg, amennyiben 4-nél kevesebb szezon van megkülönböztetve a szálláshelyen).

  • Jelenleg a pricelistType=rooms paraméter használatos az új foglalási motoron.

  • numOfGuests=min/max/number – az árlistában előre kiválasztjuk a vendégek számát. A „min” kiválasztásakor mindig 1 vendég kerül kiválasztásra, függetlenül a kiválasztott szoba kapacitásától. A „max” lehetőség esetén, a vendégek száma a főágyak teljes kihasználtságára lesz beállítva (pótágyak nélkül).
  • showOccupancyTabs=object/objectKind/object-objectKind – Megadható, hogy mely fülek  jelenjenek meg a Foglaltság részben. Az Object egy adott helyiség foglaltságát, az objectKind pedig a szobatípusok foglaltságát jelenti, és mindkét paraméter kötőjellel elválasztva mindkét fület megjeleníti.
  • drawOccupancyBy=object/objectKind – Az alapértelmezett fül beállítása a Foglaltság menüpontban. „object” – adott szobák foglaltsága”, „objectKind” – szobatípus foglaltsága.
  • drawBy – hogyan fognak a szabad szobák megjelenni a „Foglaltság” fülön “object” – egyedi szobánként, “objectKind “- szobatípusonként.

Csomagajánlatok paraméterezése:

  • showStays=XXX-YYY, mely használatával csak a kiválasztott csomagokat fogja a rendszer foglalhatónak mutatni
  • stayPricesPerRoom=1, amely a teljes szobára felszámított csomagárat jeleníti meg ezzel az információval (ár /szoba ) és ezzel a számítási logikával anélkül, hogy kiszámítaná és megjelenítené a legalacsonyabb személyenkénti árat

Az óra/perc alapú egységekre foglalható szolgáltatások paraméterezési lehetőségei (showTabs=service)

  • serviceListType=XXX (list/tiles) – alapértelmezett nézetben megjelenítésük lista vagy csempe nézetben történik a két lehetőség közötti váltás lehetőségével. Ezzel a paraméterrel előre kiválasztható, hogy melyik opció kerüljön kiválasztásra a váltás lehetősége nélkül.
  • showServices=12345-23456-34567 – A Szolgáltatás fülön csak a kiválasztott azonosítókkal rendelkező szolgáltatások jelennek meg (a szolgáltatásazonosító a szolgáltatások listájában látható).
  • showServicesGroup=222333 – csak a kiválasztott azonosítóval rendelkező szolgáltatások csoportját jeleníti meg (a szolgáltatáscsoport azonosítója a szolgáltatás részleteiben látható)
  • serviceId=12345 –link az adott szolgáltatás azonosító alapján történő lefoglalásához (lásd fent a showServices paramétert). Az &arrival=DD.MM.YYYY extra paraméterrel előre kiválaszthatunk egy konkrét dátumot is. Az érkezési paraméter nem kötelező.

Példa az opcionális paraméterek használatára:

Elrejtjük a foglaltság fület és angolul tekintjük meg a foglalási űrlapot:

<!-- Reservation PLUS start -->
<div class="previo-reservation-form">
<script type="text/javascript" src="https://booking.previo.cz/iframe/"></script>
<iframe src="https://booking.previo.cz/?hotId=123456&lang=en&hideTabs=occupancy" scrolling="no" frameborder="0" width="100%" height="2000" name="previo-booking-iframe" id="previo-booking-iframe" allowTransparency="true"></iframe>
</div>
<!-- Reservation PLUS end -->

Szükséges iframe attribútumok:

  • scrolling=”no” – ne jelenítsen meg görgetősávokat egy iframe-en belül (a magasság automatikusan igazodik)
  • name=”previo-booking-iframe” –iframe neve
  • id=”previo-booking-iframe” – ID iframe

Opcionális iframe attribútumok:

  • width=”100%” – az űrlap szélességének beállítása
  • height=”2000″ – az űrlap smagasságának beállítása
  • frameborder=”0″ –iframe kerete
  • allowTransparency=”true” – engedélyezi az áttetsző iframe keretet

Előre kitölthetjük a z űrlapot a GET paraméterek használatával, és ezzel a következő lépésre irányíthatjuk rögtön a vendéget. Például a foglalás első lépése kitölthető (hogy egy specifikus szobát foglaljon)

Foglalás fül egy specifikus szoba foglalásához:
Az iframe forrása  http://booking.hotelgram.com/?hotId=xxxxxx a következő paraméterekkel:

  • showRoomType=123 – szobatípus azonosító (kötelező)
  • arrival=DD.MM.YYYY – érkezési nap (opcionális, az alapbeállítás az aznapi dátum)
  • departure=DD.MM.YYYY – érkezési nap (opcionális, az alapbeállítás az érkezés napja utáni nap)

Csomag fül bizonyos csomagok foglalásához:
Az iframe forrása  http://booking.hotelgram.com/?hotId=xxxxxx a következő paraméterekkel:

  • stayId=123 – csomag azonosítója (kötelező)
  • arrival=DD.MM.YYYY – adott dátum előzetes kiválasztása (opcionális, Az alapértelmezett érték az első lehetséges dátum)

Saját kimutatás

A követést az igényei szerint állíthatja be. Például küldhető esemény a Google Analyticsnak minden alkalommal, amikor egy újabb lépést befejez a felhasználó a foglalás folyamatában. A beállítások száma szinte végtelen. Ezen beállításokhoz azonban legalább alapszintű webdesign ismeretek szükségesek.

A saját kimutatásnak két lehetséges módja van:

  1. redirectUrl GET paraméterezése

A forrás paraméterhez az iframe paraméter &redirectUrl=https://www………hu/thankyou-page hozzáadása.

Ez a paraméter a felhasználót az adott oldalra irányítja (a redirectUrl –ben megadva) a foglalás befejezése után. Az Url tartalmazhat egyéb paraméterezést, mint a reservationPrice T..stb, melyet a saját adatgyűjtéshez használhatunk..

A követési adatok ekkor beszerezhetők a JavaScript vagy a PHP használatával az URL-ből és felhasználhatóak további adatelemzéshez.

  1. JS reservationPlusStepEvent funkciójának használata

Ez az opció többet nyújthat, mivel lehetővé teszi annak nyomon követését, hogy az ügyfelek miként haladnak át az egyes lépéseknél a foglalási folyamat során. Az utolsó lépés (a foglalás befejezése) után az árról stb. is információt kapunk.

Illessze be a funkció paramétert a webhelyére, és mérhetővé válik, mikor a folyamat egyes lépéseit az ügyfél befejezi. Kiválóan alkalmas bármilyen rendszerhez a konverziók / események nyomon követésére.

Hogyan kell csinálni:
Helyezze be az ehhez hasonló kódot a webhelyére:

/**
 * @param JSON reservationInfo
 */
function reservationPlusStepEvent(reservationInfo) {    
      values = JSON.parse(reservationInfo);
      // currentStep
            let currentStep = values.step;
            // If customer is in fifth (last) step,
            // log reservation data in console
      if(values.step == 5) {
           console.log(values);
           // here you can trigger any code for example for event tracking
      }
}