Podstawowe ustawienia Reservation+


Jak załadować silnik R+ na stronę www:
1. Wstaw następujący kod na stronę:

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

Obowiązkowe parametry iframe atrybutu SRC:

hotId=123456 – ID Twojego obiektu noclegowego widoczne jest w pasku adresu przeglądarki po zalogowaniu do Previo:

Znajdziesz je też zawsze w menu Pomoc -> O aplikacji 

Opcjonalne parametry elementu iframe atrybutu SRC:
 Parametry ogólne

  • lang=enoznaczanie poszczególnych wersji językowych (cs = czeski, en = angielski, de = niemiecki, ru =
    rosyjski, sk = słowacki, it = włoski, fr = francuski, es = hiszpański, pl = polski, zh –
    chiński, ro = rumuński, sl = słoweński, uk = ukraiński)
  • currency=CZKoznaczanie dostępnych walut (CZK = korona czeska, USD = dolar amerykański, EUR = euro, GBP – funt brytyjski, RUB – rubel rosyjski, PLN – złoty polski, UAH – hrywna ukraińska, HUF – forint węgierski)
  • showTabs=reservation-maps – pozwoli na wybór zakładek ramki silnika, które chcesz w niej wyświetlać; w podanym tutaj przykładzie wskazujesz, że chcesz wyświetlić 2 sekcje ramki: zakładkę “rezerwacja” i “mapa”, pozostałe zakładki pozostaną ukryte w ramce silnika.

    Zakładki do wyboru w ramach parametru showTabs to:„reservation” – wyszukiwarka z formularzem rezerwacji
    „stay” – pakiety pobytowe, które oferujesz jako oddzielną usługę (ustawienia w Previo w sekcji Ceny / Pakiety pobytowe), np.:
    „review” – zatwierdzone i opublikowane przez Ciebie opinie gości o pobycie w Twoim obiekcie.
    Szczegółowy opis działania i ustawień modułu recenzji w PMS Previo
    „pricelist” – kalendarz cen z możliwością przejścia do formularza rezerwacji online
    „occupancy” – kalendarz dostępności w obiekcie z możliwością przejścia do formularza rezerwacji online
    „map” – mapa ze wskazaniem lokalizacji obiektu/ów
    „coupon” – formularz zamówienia voucherów upominkowych
    „hotels” (pl: Lista obiektów) – lista wszystkich obiektów w grupie, dotyczy sieci hoteli, których licencje w Previo zostały zgrupowane w jedną grupę hotelową. Więcej informacji na ten temat uzyskasz w naszym Dziale Wsparcia.Oto zrzut przykładowego silnika R+ z listą najpopularniejszych zakładek:
    A tu przykład zastosowania jedynie kilku wybranych zakładek:
    Nazwy poszczególnych zakładek w parametrze showTabs oddzielaj myślnikiem.

hideTabs=stay-review-pricelist-occupancy – ukryj wybraną sekcję z listy j.w. Jeśli zakładek, które chcsz ukryć ma być więcej, ich nazwy oddziel myślnikiem, jak widać na naszym przykładzie.
theme=kolor szablonu – możliwe opcje to: dark, orange, red, green, gray, bordo, brown, purple, theme01, darkblue, black, darkbrown, lightorange, darkgreen, lightgreen, wine, violet, darkpink, gold, naturegreen, pink, darkmode-gold, darkmode-cyan, darkmode-gray, darkmode-pink, darkmode-blue, darkmode-orange, darkmode-green:

ga=UA-1234567-8 – kod konta Google Analytics (Identyfikator usługi) do pomiaru ruchu
hotelDetail=1, pokazuje szczegóły w nagłówku (logo, nazwa, liczba gwiazdek, adres, opinie, krótki opis i zdjęcia). Odpowiednie zwłaszcza, jeśli formularz znajduje się w nowym oknie lub gdy odsyłasz do niego z innych stron:
showHotels=XXX-YYY, za pomocą parametru można wybrać, które hotele z grupy będą wyświetlane w sekcji „Lista obiektów” oraz w zakładce „Mapa” w IBE. Po = po prostu wprowadź identyfikatory profili, a jeśli chcesz wyświetlić więcej niż jeden profil, oddziel identyfikatory myślnikiem. Np.: showHotels=730562-730700

Parametry zakładki Rezerwacja:

guestFilter=1, wyświetla filtr dla liczby gości. Może być używany razem z parametrem „arrival”. Konkretną liczbę gości można ustawić dodatkowymi parametrami numberOfAdults=X i childAges=X-Y. Bez tych parametrów automatycznie wypełnimy wstępnie 2 osoby dorosłe jako najczęstszą opcję.
showRoomType=546, formularz rezerwacji wyświetli tylko niektóre pokoje (zgodnie z identyfikatorami pokoi), jeśli chcesz wyświetlić więcej pokoi, oddziel je myślnikiem: showRoomType=12345-6543-8974
highlightRoomType=546, wybrany typ pokoju zostanie podświetlony w Twoim IBE (zastąp 546 numerem identyfikacyjnym typu pokoju) Pokój zostanie przeniesiony na pierwsze miejsce wśród wszystkich pokoi, a jego cena zostanie automatycznie rozwinięta, więc opcje cen (nrr itp.) widoczne będą od razu.
DiscountCoupon=ABC2017, automatycznie wypełnia kupon rabatowy w pierwszym kroku formularza rezerwacji
expandPrices=1 – pokaż ceny dla wszystkich ilości gości w pokoju w drugim kroku rezerwacji
expandServices=1, w trzecim kroku IBE w usługach hotelowych zostanie wyświetlona zakładka „Wszystkie” pokazująca wszystkie niewymienione usługi + zostaną również wyświetlone wszystkie usługi z grup usług.
hideSoldRooms=1 ukryje wyprzedane lub zamknięte do sprzedaży pokoje z listy.
hideBenefits=1 ukryje motywatory tekstowe i graficzne w pierwszym kroku procesu rezerwacji

Parametry ostatniego kroku rezerwacji:

showGuestDetail=1, rozwija formularz z informacjami o gościu w ostatnim kroku formularza rezerwacji
showNote=1, rozwija notatkę w czwartym kroku formularza rezerwacji.
mandatoryData: name-address-country-passport-visa – określa obowiązkowe dane, które klient musi wypełnić w trzecim kroku formularza rezerwacji. („name” – pełna nazwa/godność, „country” – kraj, „adress” – pełny adres, „viza” – numer wizy)
redirectUrl=http://www.mydomain.com/thank-you-for-reservation – adres URL, na który zostanie przekierowany
ostatni krok formularza rezerwacyjnego po złożeniu zamówienia. Możesz także użyć opcjonalnego parametru redirectType=iframe/parent, który przekieruje Cię na wybraną stronę wewnątrz iframe lub w witrynie nadrzędnej. Jeśli nie użyjesz tego parametru, opcja iframe zostanie wybrana automatycznie. Wówczas przesłane zostaną następujące parametry GET:

– Pole comIds – numery właśnie utworzonych rezerwacji, szczegółowe informacje można wtedy uzyskać funkcjami API (np. Hotels.searchBonuses).
– price – całkowita cena rezerwacji
– currency – waluta rezerwacji
– arrival – data przybycia w formacie RRRR-MM-DD
– departure – data wyjazdu w formacie RRRR-MM-DD
– customerName – imię i nazwisko osoby kontaktowej
– customerEmail – email osoby kontaktowej

Parametry dla zakładek Cennik/Dostępność:

pricelistType=seasons / pricelistType=rooms, cennik wyświetla się automatycznie w wariancie „rooms” (po wybraniu pokoju do wyświetlenia kalendarza), jeśli masz więcej niż 4 sezony cenowe w przyszłości. Jeśli użyjesz parametru pricelistType=seasons lub masz mniej niż 4 sezony cennikowe w przyszłości, cennik wyświetli się jako tabela z cenami wszystkich pokoi, gdzie zamiast rodzaju pokoju wybierasz tylko datę wyświetlenia ceny.
numOfGuests=min/max/liczba – określa liczbę gości, która jest wstępnie wybrana przy wyborze pokoju. Min. zawsze pokazuje ceny za 1 osobę (niezależnie od pojemności pokoju). Max zawsze wyświetla cenę za pełną pojemność głównych łóżek w danym pokoju.
showOccupancyTabs=object/objectKind/object-objectKind – parametr określa, które zakładki będą wyświetlane w sekcji Dostępność. Obiekt (object) to obłożenie określonych pokoi, rodzaj obiektu (objectKind) to obłożenie kategorii pokoi, a użycie obu parametrów oddzielonych myślnikiem spowoduje wyświetlenie obu zakładek.
drawOccupancyBy=object/objectKind – określa, która zakładka będzie wyświetlana domyślnie w sekcji Dostępność. “object” – według konkretnych pokoi”, “objectKind” – według typów pokoi

Parametry dla pakietów:

showStays=12345, wyświetlą się tylko wybrane pakiety pobytowe (zgodnie z ID pakietu), aby wprowadzić kilka pakietów użyj myślnika: showStays=123-456-789
stayPricesPerRoom=1, wyświetli pakiety liczone za pokój (i ich cenę) zgodnie z tą logiką i nie przeliczy ceny za osobę (czyli przy zamówieniu zostanie wyświetlona najniższa cena za cały pokój, a nie najniższa cena obliczona za osobę w pakiecie)

Parametry dla kuponów:

Jeśli używamy parametrów &showTabs=coupon&couponType=cash lub &showTabs=coupon&couponType=stay dodatkowo można też dopasować zdjęcie nagłówka za pomocą parametru:

couponHeader=1-5 (#1 to domyślne zdjęcie “natury”, inne opcje są bardziej neutralne i pasujące do kuponów sprzedawanych jako upominek).

Parametry sprzedaży usług dodatkowych/godzinowych/minutowych bez/niezależnie od rezerwacji zakwaterowania (showTabs=service)

  • serviceListType=XXX (lista/kafelki) – domyślnie usługi można wyświetlić w R+ w formie listy lub kafelek z opcją przełączania pomiędzy nimi. Użycie tego parametru spowoduje, że jeden z tych sposobów będzie wskazany odgórnie bez możliwości zmiany.
  • showServices=12345-23456-34567 – Zakładka z usługami pokaże tylko te usługi wkazane konkretnymi numerami ID (ID usługi widoczne jest na liście usług w Previo, w lewej kolumnie obok wybranej usługi).
  • showServicesGroup=222333 – pokaże grupę usług o określonym ID (ID grupy usług widoczne jest w szczegółach usługi)
  • serviceId=12345 – link for booking of specific service by ID (see showServices parameter above). Using the extra parameter &arrival=DD.MM.YYYY you can also preselect specific date. Arrival parameter is optional.
    Szczegółowa instrukcja sprzedaży online usług dodatkowych bez noclegu

Przykład użycia parametrów opcjonalnych:

Ukrywanie zakładki obłożenia i wyświetlanie formularza w języku angielskim:

<!-- 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 -->

PAMIĘTAJ, aby parametry podawać zawsze w jęz. angielskim, np. hideTabs=occupancy, showTabs=stay-review

Obowiązkowe atrybuty elementu iframe:

scrolling=no – nie wyświetlaj scrollbarów wewnątrz elementu iframe (wysokość formularza jest dopasowywana automatycznie) name=previo-booking-iframe – nazwa elementu iframe
id=previo-booking-iframe – ID elementu iframe

Opcjonalne atrybuty elementu iframe:

width=100% – ustawienie szerokości formularza
height=2000 – ustawienie wysokości formularza
frameborder=0– ramka elementu iframe
allowTransparency=true – włącz przezroczystość elementu iframe.

Możliwe jest również wstępne wypełnienie formularza parametrami GET i przekierowanie od razu do kolejnych kroków:

1. Zakładka Rezerwacja służąca do zamawiania konkretnego pokoju. Użyj http://booking.previo.cz/?hotId=123456 z następującymi parametrami:

showRoomType=123 – identyfikator typu pokoju (wymagane)
arrival=DD.MM.RRRR – data przybycia (opcjonalnie, domyślnie jest to dzisiaj)
departure=DD.MM.RRRR – data wyjazdu (opcjonalnie, domyślnie jeden dzień później niż data przyjazdu)

2. Zakładka Pakiety służąca do zamówienia konkretnego pakietu pobytowego. Użyj http://booking.previo.cz/stay/?hotId=123456 z następującymi parametrami:

stayId=123 – ID pakietu (wymagane)
arrival=DD.MM.RRRR – wyświetlenie kalendarza z wybranym konkretnym dniem (opcjonalnie, domyślnie najbliższy możliwy)

Własny pomiar celów / konwersji / retargetingu / i inne:

Konwersje Awords i Sklik oraz transakcje e-commerce GA są mierzone automatycznie przez Previo. Jeśli chcesz mierzyć również inne cele, np. odwiedzenie 2. kroku formularza, wypełnienie rezerwacji, sprawdzenie, jaką datę klient wypełnił w 1. kroku, możesz skorzystać z prostego transferu informacji pomiędzy iframe oraz stronę internetową. Podczas przechodzenia z jednego kroku do drugiego iframe wysyła wywołanie metody bookingPlusStepEvent do strony internetowej, jeśli taka metoda istnieje na stronie nadrzędnej, to jest wywoływana m.in. parametrów, gdzie dowiesz się do jakiego kroku użytkownik właśnie się przeniósł, a na 2 i 5 kroku uzyskasz również dodatkowe informacje o rezerwacji (data, cena, numer vouchera). Twoja funkcja może wyglądać tak:

/**
* @param JSON reservationInfo
*/
function reservationPlusStepEvent(reservationInfo) {
values = JSON.parse(reservationInfo);
// reservation was created
if(values.step == 5) {
// this will print available data to console
console.log(values);
// do some action
}
}
Więcej wskazówek znajdziesz w artykule dedykowanym pozycjonowaniu